Skip To Content

Blockdaemon Documentation

NFT Tutorials: Events

Overview
How to Get All Mints Associated with a Wallet
How to Get All Mints Associated with a Contract
How to Get All Transfers Associated with a Wallet
How to Find Out When an NFT Was Minted
How to Get Transaction Details and Payments


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:


How to Get All Transfers 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 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.

We don't support Internet Explorer

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