Blockdaemon Documentation
GET NFT Events
GET NFT Events (V1)
Path Parameters
Query Parameters
Example Queries
Example Response
GET NFT Events (V1)
https://ubiquity.api.blockdaemon.com/v1/nft/{protocol}/{network}/events
Returns NFT events by a given contract or wallet (see required parameters).
Developer documentation: GET NFT Events (V1)
Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token.
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 two parameters listed below.
1. To get events by contract address, use:
- parameter:
contract_address
- value: e.g.
0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D
2. To get assets by wallet address, use:
- parameter:
wallet_address
- value: e.g.
0x5682035b6b1D04924C7661b09A974fF0695De6bE
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
/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: 100 by default, up to 500
To get the next page, use
- parameter:
page_token
- value: returned in the
next_page_token
field
Example Queries
The following queries provide useful examples for GET NFT Events (V1).
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:
https://ubiquity.api.blockdaemon.com/v1/nft/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:
https://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/events?wallet_address=0x5682035b6b1D04924C7661b09A974fF0695De6bE
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:
https://ubiquity.api.blockdaemon.com/v1/nft/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:
https://ubiquity.api.blockdaemon.com/v1/nft/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:
https://ubiquity.api.blockdaemon.com/v1/nft/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:
https://ubiquity.api.blockdaemon.com/v1/nft/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 (V1):
{
"data": [
{
"contract_address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
"token_id": "4813",
"event_type": "transfer",
"timestamp": "1647251610",
"from_account": "0x27ed338c1705F22cCD19336CB76Fc97421C1871B",
"to_account": "0x702e88BF5cf85fe0E50f4bcFCA131b155A282a96",
"transaction": {
"block_hash": "0xc41be53ef3a78c990b46676c68fff41678b5f878f138c8e1df24318cecd6f767",
"block_number": 14383999,
"transaction_hash": "0x096debc35010bab95cfa4785dd5fe0c191a21476a7c8a2f0892342292f5552bc"
}
},
{...more events...}
],
"meta": {
"paging": {
"next_page_token": "eyJ0aW1lc3RhbXAiOjE2NDcxNDU4NDIsInNpZCI6NzQ0MDgxNDM5OTAzODc1MDgyfQ=="
}
}
}