Skip To Content

Blockdaemon Documentation

GET NFT Events

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


GET NFT Events

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

Returns NFT events by a given contract, wallet, or transaction (see required parameters).

Developer documentation: GET NFT Events
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

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

Path Parameters

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

  • ethereum/mainnet

Query Parameters

NFT API supports advanced querying options, making it easy to pinpoint the exact information you need. Use query parameters to filter, sort, and paginate the results.

Required Parameters

It is required to specify at least one of the three parameters listed below.

1. To get events by contract address, use:

  • parameter: contract_address
  • value: e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D

2. To get events by wallet address, use:

  • parameter: wallet_address
  • value: e.g. 0x5682035b6b1D04924C7661b09A974fF0695De6bE

3. To get events by transaction hash, use:

  • parameter: transaction_hash
  • value: 0x9151ff78c24d18fd076eede2644daca06cf1d56848a5bb2beeab6cad2e6c7417

Note: You can combine these parameters with each other to further filter the results.

Additional Parameters

To filter your results by token ID, use the following parameter:

  • parameter: token_id
  • value: e.g. 9999

Note: The query must include contract_address.

To filter the results by event type, use:

  • parameter: event_type
  • value: mint / sale / transfer

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 Contract Address

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

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D

Get Events by Wallet Address

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

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?wallet_address=0x5682035b6b1D04924C7661b09A974fF0695De6bE

Get Events by Transaction Hash

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

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?transaction_hash=0x9151ff78c24d18fd076eede2644daca06cf1d56848a5bb2beeab6cad2e6c7417

Get Filtered Events

To get a list of Ethereum Mainnet events by a given contract address, filtered by a given wallet address, use the following query:

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&wallet_address=0x46Fd6B647Dc8C82aD8f6cf0CC6b22ACad3f6e39d

To get a list of Ethereum Mainnet events by a given contract address, filtered by a given token ID, use the following query:

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&token_id=9999

To get a list of Ethereum Mainnet events by a given contract address, filtered by event type, use the following query:

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&event_type=mint

Get Sorted and Filtered Events

To get a list of Ethereum Mainnet events by a given contract address, filtered by event type and sorted by timestamp in ascending order, use the following query:

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&event_type=mint&sort_by=timestamp&order=asc

Example Response

The following is a typical response from GET NFT Events:

{
    "data": [
        {
            "id": "2b3bbb3d-aa72-42a1-94c2-9e8f987a76fc",
            "contract_address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
            "token_id": "6853",
            "event_type": "transfer",
            "timestamp": "1655199885",
            "from_account": "0x5f6ac80CdB9E87f3Cfa6a90E5140B9a16A361d5C",
            "to_account": "0x70b97A0da65C15dfb0FFA02aEE6FA36e507C2762",
            "quantity": "1"
        },
        {...more events...}
    ],
    "meta": {
        "paging": {
            "next_page_token": "eyJ0aW1lc3RhbXAiOjE2NTUxNzY2NDcsInNpZCI6MTQ5ODU4MTU4fQ=="
        }
    }
}

We don't support Internet Explorer

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