Skip To Content

Blockdaemon Documentation

GET NFT Events by Block

GET NFT Events by Block
Ubiquity NFT URL
Path Parameters
Query Parameters
Example Queries
Example Response


GET NFT Events by Block

https://{ubiquity_nft_url}/{protocol}/{network}/events/block/{block_number}

Returns NFT events by a given block number.

Developer documentation: GET NFT Events by Block
Learn how to authorize your request: Authentication Guide

Note: To get more information about a particular event, use GET NFT Event by ID.


Ubiquity URL

To run a query, add your Ubiquity NFT URL. For most users this will be:

  • svc.blockdaemon.com/nft/v1

An example of this is shown below:

https://svc.blockdaemon.com/nft/v1/{protocol}/{network}/events/block/{block_number}

Note: If you created your Ubiquity API Key before September 2022, add the legacy Ubiquity NFT URL:

  • ubiquity.api.blockdaemon.com/nft/v1

An example of this is shown below:

https://ubiquity.api.blockdaemon.com/nft/v1/{protocol}/{network}/events/block/{block_number}

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

It is also required to specify a block number as the last path parameter, e.g.:

  • 14566898

Query Parameters

To sort the results, use

  • parameter: sort_by
  • value: timestamp

To set the sort order, use

  • parameter: order
  • value: asc / desc

To set the maximum number of assets returned on one page, use

  • parameter: page_size
  • value: 50 by default, up to 100

To get the next page, use

  • parameter: page_token
  • value: returned in the next_page_token field

Example Queries

The queries in this section provide useful examples for GET NFT Events.

For more examples and details, visit: NFT Tutorials: Events

Get Events by Block Number

To get a list of Ethereum Mainnet events by a given block number, use the following query:

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events/block/14566898

Get Events Sorted in Ascending Order

To get a list of Ethereum Mainnet events by a given block number, sorted from the earliest to the latest, use the following query:

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events/block/14566898?order=asc

Example Response

The following is a typical response from GET NFT Events by Block:

{
    "data": [
        {
            "id": "fe4b1f5e-690a-57c3-82c4-705a2da01325",
            "contract_address": "0xa3AEe8BcE55BEeA1951EF834b99f3Ac60d1ABeeB",
            "token_id": "7200",
            "event_type": "sale",
            "timestamp": "1649714022",
            "from_account": "0xFb406C694cAb94672bcF99dc176AE630d3C093ad",
            "to_account": "0x4AE51f105E4777Fd204e860594eB0880dB27e01b",
            "quantity": "1",
            "block_number": "14566898",
            "transaction_hash": "0x698f8e8cdfd9808f7e60d570c7dac6d8c6cbe630101227c770f05183fa9bd8c2"
        },
        { ...more events... }
    ],
    "meta": {
        "paging": {
            "next_page_token": ""
        }
    }
}

We don't support Internet Explorer

Please use Chrome, Safari, Firefox, or Edge to view this site.