Overview

Our NFT endpoints support advanced querying options, allowing you to retrieve the exact data you need with a single request.

This page contains short step-by-step tutorials explaining how to get information on NFT events in the Ethereum Mainnet network.

All example queries are based on the following endpoints:

• GET NFT Events
• GET NFT Event by Block
• GET NFT Event by ID

How to Get All Mints Associated with a Wallet

This tutorial explains the steps involved in getting a list of all mints for any given wallet in the Ethereum Mainnet network.

Step 1. Use the events endpoint with the following details:

• protocol: ethereum
• network: mainnet

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

Step 2. Add the following parameters:

• wallet address
  • parameter: wallet_address
  • value: e.g. 0xCC22f5B0F39D10BE2A5414A53650B281538130A9
• event type
  • parameter: event_type
  • value: mint

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

Step 3. Execute the query.

For example, in cURL you should run the following code:

curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?wallet_address=0xCC22f5B0F39D10BE2A5414A53650B281538130A9&event_type=mint' -H 'Authorization: Bearer YOUR_API_KEY'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide

Step 4. Your results will look something like this example response.

How to Get All Mints Associated with a Contract

This tutorial explains the steps involved in getting a list of all mints for any given contract in the Ethereum Mainnet network.

Step 1. Use the events endpoint with the following details:

• protocol: ethereum
• network: mainnet

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

Step 2. Add the following parameters:

• contract address
  • parameter: contract_address
  • value: e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D
• event type
  • parameter: event_type
  • value: mint

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

Step 3. Execute the query.

For example, in cURL you should run the following code:

curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&event_type=mint' -H 'Authorization: Bearer YOUR_API_KEY'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide

Step 4. Your results will look something like this example response.

How to Get All Transfers Associated with a Wallet

This tutorial explains the steps involved in getting a list of all transfers for any given wallet in the Ethereum Mainnet network.

Step 1. Use the events endpoint with the following details:

• protocol: ethereum
• network: mainnet

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

Step 2. Add the following parameters:

• wallet address
  • parameter: wallet_address
  • value: e.g. 0x5682035b6b1D04924C7661b09A974fF0695De6bE
• event type
  • parameter: event_type
  • value: transfer

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

Step 3. Execute the query.

For example, in cURL you should run the following code:

curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?wallet_address=0x5682035b6b1D04924C7661b09A974fF0695De6bE&event_type=transfer' -H 'Authorization: Bearer YOUR_API_KEY'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide

Step 4. Your results will look something like this example response.

How to Get Events by Transaction Hash

This tutorial explains the steps involved in getting a list of all events by any given transaction hash in the Ethereum Mainnet network.

Step 1. Use the events endpoint with the following details:

• protocol: ethereum
• network: mainnet

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

Step 2. Add the following parameter:

• transaction hash
  • parameter: transaction_hash
  • value: e.g. 0x9151ff78c24d18fd076eede2644daca06cf1d56848a5bb2beeab6cad2e6c7417

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

Step 3. Execute the query.

For example, in cURL you should run the following code:

curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?transaction_hash=0x9151ff78c24d18fd076eede2644daca06cf1d56848a5bb2beeab6cad2e6c7417' -H 'Authorization: Bearer YOUR_API_KEY'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide

Step 4. Your results will look something like this example response.

How to Get Events by Block Number

This tutorial explains the steps involved in getting a list of all events by any block number in the Ethereum Mainnet network.

Step 1. Use the events by block endpoint with the following details:

• protocol: ethereum
• network: mainnet
• block number, e.g.: 14566898

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

Step 2. Execute the query.

For example, in cURL you should run the following code:

curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events/block/14566898' -H 'Authorization: Bearer YOUR_API_KEY'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide

Step 5. Your results will look something like this example response.

How to Get All Historical Transfers for a Given NFT

This tutorial explains the steps involved in getting a list of all transfers for any given Ethereum Mainnet NFT.

Step 1. Use the events endpoint with the following details:

• protocol: ethereum
• network: mainnet

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

Step 2. Add the following parameters:

• contract address
  • parameter: contract_address
  • value: e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D
• token ID
  • parameter: token_id
  • value: e.g. 9999
• event type
  • parameter: event_type
  • value: transfer

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

Step 3. Execute the query.

For example, in cURL you should run the following code:

curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&token_id=9999&event_type=transfer' -H 'Authorization: Bearer YOUR_API_KEY'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide

Step 4. Your results will look something like this example response.

How to Find Out When an NFT Was Minted

This tutorial explains the steps involved in getting the mint date of any given Ethereum Mainnet NFT.

Step 1. Use the events endpoint with the following details:

• protocol: ethereum
• network: mainnet

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

Step 2. Add the following parameters:

• contract address
  • parameter: contract_address
  • value: e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D
• token ID
  • parameter: token_id
  • value: e.g. 9999
• event type
  • parameter: event_type
  • value: mint

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

Step 3. Execute the query.

For example, in cURL you should run the following code:

curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/events?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&token_id=9999&event_type=mint' -H 'Authorization: Bearer YOUR_API_KEY'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide

Step 4. Your results will look something like this example response.

The mint date is returned in Unix time by the timestamp field, e.g.:

• "timestamp": "1619858117"

How to Get Transaction Details and Payments

This tutorial explains the steps involved in getting the details of any given NFT transaction in Ethereum Mainnet. If the event type is transfer, you can also get payments.

Step 1. Use the events endpoint to get a list of NFT events.

For example, you can follow these steps: How to Get All Transfers Associated with a Wallet

Step 2. Copy an event ID from the id field:

        {
    "id": "35485a1c-2617-56e4-b20a-3e6132cbd123",
    "contract_address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
    ...more properties...
}

Step 3. Use the event endpoint with the following details:

• protocol: ethereum
• network: mainnet
• event ID: 35485a1c-2617-56e4-b20a-3e6132cbd123 (copied in the previous step)

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/event/35485a1c-2617-56e4-b20a-3e6132cbd123

Step 4. Execute the query.

For example, in cURL you should run the following code:

curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/event/35485a1c-2617-56e4-b20a-3e6132cbd123' -H 'Authorization: Bearer YOUR_API_KEY'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide

Step 5. Your results will look something like this example response.

Transaction details are located in the transaction section:

"transaction": {
    "block_hash": "0x83e37063e4493bc5cb16f7fb1db3d2436f76615d3ae65c37d7cce08eb2eb3e2e",
    "block_number": 12352896,
    "transaction_hash": "0xca962bf6e71c2e15f2e2d55ae4b8f7481bf54f0f7c75b6e2dd79b3203e2eda9f"
}

If event_type is transfer, payments are returned in the payments section:

"payments": [
    {
        "from": "0x1f08cbfca1f63a23bb6255a76e1ddeeb8d24d0fa",
        "to": "0x7be8076f4ea4a4ad08075c2508e481d6c946d12b",
        "price": 0.5,
        "currency": "ETH"
    },
    {
        "from": "0x7be8076f4ea4a4ad08075c2508e481d6c946d12b",
        "to": "0x5b3256965e7c3cf26e11fcaf296dfc8807c01073",
        "price": 0.025,
        "currency": "ETH"
    },
    {
        "from": "0x7be8076f4ea4a4ad08075c2508e481d6c946d12b",
        "to": "0x1212503603aaa0fc26a90f77515d2a51c998866c",
        "price": 0.475,
        "currency": "ETH"
    }
]

Note: The payments field currently returns an empty array for some events. Payments data is being indexed in the background and will eventually return data if event_type is sale.