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


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 endpoint: GET NFT Events.


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://ubiquity.api.blockdaemon.com/v1/nft/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://ubiquity.api.blockdaemon.com/v1/nft/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://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/events?wallet_address=0xCC22f5B0F39D10BE2A5414A53650B281538130A9&event_type=mint' -H 'Authorization: Bearer YOUR_TOKEN'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token.

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://ubiquity.api.blockdaemon.com/v1/nft/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://ubiquity.api.blockdaemon.com/v1/nft/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://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/events?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&event_type=mint' -H 'Authorization: Bearer YOUR_TOKEN'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token.

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://ubiquity.api.blockdaemon.com/v1/nft/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://ubiquity.api.blockdaemon.com/v1/nft/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://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/events?wallet_address=0x5682035b6b1D04924C7661b09A974fF0695De6bE&event_type=transfer' -H 'Authorization: Bearer YOUR_TOKEN'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token.

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://ubiquity.api.blockdaemon.com/v1/nft/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://ubiquity.api.blockdaemon.com/v1/nft/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://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/events?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&token_id=9999&event_type=transfer' -H 'Authorization: Bearer YOUR_TOKEN'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token.

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://ubiquity.api.blockdaemon.com/v1/nft/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://ubiquity.api.blockdaemon.com/v1/nft/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://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/events?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&token_id=9999&event_type=mint<' -H 'Authorization: Bearer YOUR_TOKEN'

Note: To authorize your request, you need to get a Ubiquity API key and use it as a bearer token.

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"

We don't support Internet Explorer

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