NFTs

NFTs the latest buzz in the crypto world and Unmarshal is there to support with the data needs around NFTs as well.

NFT assets by Address

NFT assets API gives the information about all the NFT assets held by a address on BSC and ethereum chain.

Request
Security:
path Parameters
address
required
string
Default: "demo.eth"

Any valid address or ENS

Example: demo.eth
chain
required
string
Enum: "ethereum" "bsc" "matic" "avalanche" "solana"
Example: bsc
Responses
200

Example response

401
get/v1/{chain}/address/{address}/nft-assets
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/:chain/address/:address/nft-assets?auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
No sample

NFT Transactions by Address

NFT transactions API gives the list of transaction being made on given wallet address.

Request
Security:
path Parameters
chain
required
string
Enum: "ethereum" "bsc" "matic" "avalanche"
Example: bsc
address
required
string
Default: "demo.eth"

Any valid address or ENS

Example: demo.eth
query Parameters
page
number >= 1
Default: 1

Page you want to query

pageSize
number
Default: 25

Number of records to be fetched per page

Example: pageSize=5
Responses
200

Example response

401
get/v1/{chain}/address/{address}/nft-transactions
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/:chain/address/:address/nft-transactions?page=1&pageSize=5&auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "contract_address": "0x3a3e2aef7e44fd0bb3f0e2330c5b8f078816cbf6",
  • "token_id": "6470",
  • "transaction_hash": "0x550ab896bad15a82e2a0c3458f86929dd79b924732cfe875d5f6d192c5ee2c4b",
  • "block_number": 11703141,
  • "block_hash": "",
  • "transaction_idx": 0,
  • "log_idx": 512,
  • "sender": "0x0000000000000000000000000000000000000000",
  • "to": "0x6877654e79119a7f9a8182bb2389e797ca421d24"
}

NFT details by ID

This NFT gives more details about a specific NFT based on NFT id.Basically the metadata of an NFT which is currently most sought after

Request
Security:
path Parameters
chain
required
string
Enum: "ethereum" "bsc" "matic" "avalanche"
Example: bsc
address
required
string

Any valid Nft Contract address

query Parameters
tokenId
required
string

Valid nft token Id of a requested nft contract

Responses
200

Example response

401
get/v1/{chain}/address/{address}/details
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/:chain/address/:address/details?tokenId=string&auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
No sample

NFT details of all tokenIds of a contract

This NFT gives more details about a specific NFT based on NFT id(if token Id not provided returns all token .Basically the metadata of an NFT which is currently most sought after

Request
Security:
path Parameters
chain
required
string
Enum: "ethereum" "bsc" "matic" "avalanche"
Example: bsc
address
required
string

Any valid Nft Contract address

query Parameters
tokenId
string

Valid nft token Id of a requested nft contract

page
number >= 1
Default: 1

Page you want to query

pageSize
number
Default: 25

Number of records to be fetched per page

Example: pageSize=5
Responses
200

Example response

401
get/v2/{chain}/address/{address}/details
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v2/:chain/address/:address/details?tokenId=string&page=1&pageSize=5&auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
No sample

Get Nft Contract Transactions

Get all the contract transactions of an nft, also filter all the transactions of a particular token Id of the contract (optional)

Request
Security:
path Parameters
chain
required
string
Enum: "ethereum" "bsc" "matic" "avalanche"
Example: bsc
address
required
string

Any valid Nft Contract address

query Parameters
tokenId
string

Valid nft token Id of a requested nft contract

page
number >= 1
Default: 1

Page you want to query

pageSize
number
Default: 25

Number of records to be fetched per page

Example: pageSize=5
Responses
200

Example response

401
get/v1/{chain}/contract/{address}/nft-transactions
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/:chain/contract/:address/nft-transactions?tokenId=string&page=1&pageSize=5&auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "contract_address": "0x3a3e2aef7e44fd0bb3f0e2330c5b8f078816cbf6",
  • "token_id": "6470",
  • "transaction_hash": "0x550ab896bad15a82e2a0c3458f86929dd79b924732cfe875d5f6d192c5ee2c4b",
  • "block_number": 11703141,
  • "block_hash": "",
  • "transaction_idx": 0,
  • "log_idx": 512,
  • "sender": "0x0000000000000000000000000000000000000000",
  • "to": "0x6877654e79119a7f9a8182bb2389e797ca421d24"
}

Get all token ids available for a nft contract

This Endpoint returns all token Ids available for the specified contract

Request
Security:
path Parameters
chain
required
string
Enum: "ethereum" "bsc" "matic" "avalanche"
Example: bsc
address
required
string

Any valid Nft Contract address

Responses
200

Example response

401
get/v1/{chain}/contract/{address}/tokenIds
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/:chain/contract/:address/tokenIds?auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
No sample

NFT holders by id

This api gives history of owners for a given NFT.

Request
Security:
path Parameters
address
required
string

Any valid Nft Contract address

chain
required
string
Enum: "ethereum" "bsc" "matic" "avalanche"
Example: bsc
query Parameters
tokenId
required
string

Valid nft token Id of a requested nft contract

Responses
200

Example response

401
get/v1/{chain}/address/{address}/nftholders
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/:chain/address/:address/nftholders?tokenId=string&auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
No sample