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": ""
        }
    }
}