Web3-Data-Server API

Overview

The data service provides a series of API interfaces to facilitate the query of web3 data.

Production domains

https://data.sending.me/

X-API-KEY must be included in the headers of a request.

X-API-KEY: {API KEY}

web3-data-server API

Query the NFT collection list.

GET /api/v1/data/collection/list

Get NFT collection list.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum
page_no integer Required: Page number, start at 0
page_size integer Required: Page size

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "collection_list": [
    {
      "chain": "ethereum",
      "contract_address": "0x4e1f41613c9084fdb9e34e11fae9412427480e56",
      "contract_type": "erc721",
      "floor_price": 1.2899,
      "items_total": 9910,
      "logo": "https://logo.nftscan.com/logo/0x4e1f41613c9084fdb9e34e11fae9412427480e56.png",
      "name": "Terraforms",
      "opensea_verified": false,
      "owners_total": 1915,
      "price_symbol": "ETH",
      "symbol": "TERRAFORMS"
    },
    {
      "chain": "ethereum",
      "contract_address": "0x7bd29408f11d2bfc23c34f18275bbf23bb716bc7",
      "contract_type": "erc721",
      "floor_price": 2.1,
      "items_total": 20000,
      "logo": "https://logo.nftscan.com/logo/0x7bd29408f11d2bfc23c34f18275bbf23bb716bc7.png",
      "name": "Meebits",
      "opensea_verified": true,
      "owners_total": 6583,
      "price_symbol": "ETH",
      "symbol": "⚇"
    },
    {
      "chain": "ethereum",
      "contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
      "contract_type": "erc721",
      "floor_price": 46,
      "items_total": 10000,
      "logo": "https://logo.nftscan.com/logo/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d.png",
      "name": "BoredApeYachtClub",
      "opensea_verified": true,
      "owners_total": 5710,
      "price_symbol": "ETH",
      "symbol": "BAYC"
    },
    {
      "chain": "ethereum",
      "contract_address": "0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb",
      "contract_type": "erc721",
      "floor_price": 49.48,
      "items_total": 10000,
      "logo": "https://logo.nftscan.com/logo/0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb.png",
      "name": "CryptoPunks",
      "opensea_verified": true,
      "owners_total": 3703,
      "price_symbol": "ETH",
      "symbol": "PUNK"
    },
    {
      "chain": "ethereum",
      "contract_address": "0x81ae0be3a8044772d04f32398bac1e1b4b215aa8",
      "contract_type": "erc721",
      "floor_price": 0.02,
      "items_total": 7777,
      "logo": "https://logo.nftscan.com/logo/0x81ae0be3a8044772d04f32398bac1e1b4b215aa8.png",
      "name": "Dreadfulz",
      "opensea_verified": false,
      "owners_total": 1653,
      "price_symbol": "ETH",
      "symbol": "Dreadfulz"
    },
    {
      "chain": "ethereum",
      "contract_address": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
      "contract_type": "erc721",
      "floor_price": 9.97,
      "items_total": 19473,
      "logo": "https://logo.nftscan.com/logo/0x60e4d786628fea6478f785a6d7e704777c86a7c6.png",
      "name": "MutantApeYachtClub",
      "opensea_verified": true,
      "owners_total": 11413,
      "price_symbol": "ETH",
      "symbol": "MAYC"
    },
    {
      "chain": "ethereum",
      "contract_address": "0xce25e60a89f200b1fa40f6c313047ffe386992c3",
      "contract_type": "erc721",
      "floor_price": 0.0349,
      "items_total": 4870,
      "logo": "https://logo.nftscan.com/logo/0xce25e60a89f200b1fa40f6c313047ffe386992c3.png",
      "name": "dotdotdot",
      "opensea_verified": true,
      "owners_total": 2552,
      "price_symbol": "ETH",
      "symbol": "dotdotdot"
    },
    {
      "chain": "ethereum",
      "contract_address": "0x1dfe7ca09e99d10835bf73044a23b73fc20623df",
      "contract_type": "erc721",
      "floor_price": 0.0047,
      "items_total": 135425,
      "logo": "https://logo.nftscan.com/logo/0x1dfe7ca09e99d10835bf73044a23b73fc20623df.png",
      "name": "More Loot",
      "opensea_verified": false,
      "owners_total": 25262,
      "price_symbol": "ETH",
      "symbol": "MLOOT"
    },
    {
      "chain": "ethereum",
      "contract_address": "0x34d85c9cdeb23fa97cb08333b511ac86e1c4e258",
      "contract_type": "erc721",
      "floor_price": 1.1097,
      "items_total": 100000,
      "logo": "https://logo.nftscan.com/logo/0x34d85c9cdeb23fa97cb08333b511ac86e1c4e258.png",
      "name": "Otherdeed",
      "opensea_verified": true,
      "owners_total": 18697,
      "price_symbol": "ETH",
      "symbol": "OTHR"
    },
    {
      "chain": "ethereum",
      "contract_address": "0xed5af388653567af2f388e6224dc7c4b3241c544",
      "contract_type": "erc721",
      "floor_price": 14.9999,
      "items_total": 10000,
      "logo": "https://logo.nftscan.com/logo/0xed5af388653567af2f388e6224dc7c4b3241c544.png",
      "name": "Azuki",
      "opensea_verified": true,
      "owners_total": 4668,
      "price_symbol": "ETH",
      "symbol": "AZUKI"
    }
  ],
  "total_count": 500
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query the NFT collection list by owner address.

GET /api/v1/data/collection/list_for_owner

Get NFT collection list for owner.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum, eth-goerli, polygon-mumbai, arb-goerli
owner_address string Required: the owner’s wallet address
page_no integer Required: Page number, start at 0
page_size integer Required: Page size

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "collection_list": [
    {
      "amount": 1,
      "chain": "ethereum",
      "contract_address": "0x495f947276749ce646f68ac8c248420045cb7b5e",
      "contract_type": "erc1155",
      "floor_price": 0.0567,
      "items_total": 2050724,
      "logo": "https://logo.nftscan.com/logo/0x495f947276749ce646f68ac8c248420045cb7b5e.png",
      "name": "OpenSea Shared Storefront",
      "opensea_verified": false,
      "owners_total": 699031,
      "price_symbol": "ETH",
      "symbol": "OPENSTORE"
    },
    {
      "amount": 3,
      "chain": "ethereum",
      "contract_address": "0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8",
      "contract_type": "erc721",
      "floor_price": 0.016,
      "items_total": 5000,
      "logo": "https://logo.nftscan.com/logo/0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8.png",
      "name": "Minion Yacht Club",
      "opensea_verified": false,
      "owners_total": 1176,
      "price_symbol": "ETH",
      "symbol": "MYC"
    },
    {
      "amount": 2,
      "chain": "ethereum",
      "contract_address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
      "contract_type": "erc721",
      "floor_price": 0,
      "items_total": 3017385,
      "logo": "https://logo.nftscan.com/logo/0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85.png",
      "name": "ENS",
      "opensea_verified": true,
      "owners_total": 696366,
      "price_symbol": "ETH",
      "symbol": ""
    }
  ],
  "total_count": 3
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query the NFT collection metadata.

GET /api/v1/data/collection/metadata

Get NFT collection metadata.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum, eth-goerli, polygon-mumbai, arb-goerli
collection_address string Required: nft contract address

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "metadata": {
    "average_price_24h": 0.4591,
    "average_price_change_1d": "278.17%",
    "average_price_change_30d": "68.87%",
    "average_price_change_7d": "-39.59%",
    "contract_address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
    "contract_type": "erc721",
    "description": "Ethereum Name Service (ENS) domains are secure domain names for the decentralized world. ENS domains provide a way for users to map human readable names to blockchain and non-blockchain resources, like Ethereum addresses, IPFS hashes, or website URLs. ENS domains can be bought and sold on secondary markets.",
    "floor_price": 0,
    "items_total": 3017394,
    "logo": "https://logo.nftscan.com/logo/0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85.png",
    "name": "ENS",
    "opensea_verified": true,
    "owner": "0xfe89cc7abb2c4183683ab71653c4cdc9b02d44b7",
    "owners_total": 696366,
    "price_symbol": "ETH",
    "symbol": "",
    "total_supply": 3017394,
    "total_volume": 122335.5368
  }
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query the NFT metadata.

GET /api/v1/data/nft/metadata

Get NFT metadata.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum, eth-goerli, polygon-mumbai, arb-goerli
contract_address string Required: nft contract address
token_id string Required: nft token id

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "collection": {
    "contract_address": "0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8",
    "contract_type": "erc721",
    "description": "5000 bored Minions. Doesn’t it feel so good to be bad? \r\n\r\noooo Banana!",
    "floor_price": 0.016,
    "items_total": 5000,
    "logo": "https://logo.nftscan.com/logo/0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8.png",
    "name": "Minion Yacht Club",
    "opensea_verified": false,
    "owner": "0x6e9e1cd3c773adecfd876596d394b666bb3a5e7c",
    "owners_total": 1176,
    "price_symbol": "ETH",
    "symbol": "MYC",
    "total_supply": 5000
  },
  "metadata": {
    "amount": 1,
    "chain": "ethereum",
    "collection_name": "Minion Yacht Club",
    "contract_address": "0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8",
    "description": "5000 unique Minion Yacht Club NFTs",
    "image_thumbnail_url": "https://d3v0kmlgfpwg7s.cloudfront.net/0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8/0x0000000000000000000000000000000000000000000000000000000000000001.png",
    "image_url": "https://ipfs.io/ipfs/QmYM5mBUG4fdWfXYfNS2wtgaoSefUtS8BzL6CAJPkTmSod/1.png",
    "name": "Minion Yacht Club #1",
    "rarity_rank": 3802,
    "rarity_score": 0.9165502289981072,
    "token_id": "1",
    "token_type": "erc721"
  }
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query NFT assets by wallet address.

GET /api/v1/data/wallet/nft_assets

Query NFT assets for owner.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum, eth-goerli, polygon-mumbai, arb-goerli
page_no integer Required: Page number, start at 0
page_size integer Required: Page size
refresh boolean Refresh cache
wallet string Required: wallet address. If there are multiple addresses, split by ‘,’

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "nft_assets": [
    {
      "Collection_items_total": 2050724,
      "Collection_owners_total": 699031,
      "amount": 1,
      "chain": "ethereum",
      "collection_image_url": "https://logo.nftscan.com/logo/0x495f947276749ce646f68ac8c248420045cb7b5e.png",
      "collection_name": "OpenSea Shared Storefront",
      "collection_slug": "OPENSTORE",
      "contract_address": "0x495f947276749ce646f68ac8c248420045cb7b5e",
      "description": "",
      "floor_price": 0.0567,
      "image_thumbnail_url": "https://i.seadn.io/gae/RovVezN-w7PWHvQTqyzYnw4q1gA_mtELYC6PL2h4SujfVD70OdZCL57Z65Qu72qBnAdjiL-f9yCkomKaM679IXUC7YHYNl7CYmIc8g?w=500\u0026auto=format",
      "image_url": "https://i.seadn.io/gae/RovVezN-w7PWHvQTqyzYnw4q1gA_mtELYC6PL2h4SujfVD70OdZCL57Z65Qu72qBnAdjiL-f9yCkomKaM679IXUC7YHYNl7CYmIc8g?w=500\u0026auto=format",
      "latest_trade_price": 0,
      "latest_trade_symbol": "",
      "latest_trade_timestamp": 0,
      "name": "#3463",
      "opensea_verified": false,
      "rarity_rank": 0,
      "rarity_score": 0,
      "token_id": "91903724186857662875719432177565115683543862836338196628572893226484356874241",
      "token_type": "erc1155"
    },
    {
      "Collection_items_total": 5000,
      "Collection_owners_total": 1176,
      "amount": 1,
      "chain": "ethereum",
      "collection_image_url": "https://logo.nftscan.com/logo/0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8.png",
      "collection_name": "Minion Yacht Club",
      "collection_slug": "MYC",
      "contract_address": "0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8",
      "description": "5000 unique Minion Yacht Club NFTs",
      "floor_price": 0.016,
      "image_thumbnail_url": "https://d3v0kmlgfpwg7s.cloudfront.net/0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8/0x0000000000000000000000000000000000000000000000000000000000001318.png",
      "image_url": "https://ipfs.io/ipfs/QmYM5mBUG4fdWfXYfNS2wtgaoSefUtS8BzL6CAJPkTmSod/4888.png",
      "latest_trade_price": 0,
      "latest_trade_symbol": "",
      "latest_trade_timestamp": 0,
      "name": "Minion Yacht Club #4888",
      "opensea_verified": false,
      "rarity_rank": 0,
      "rarity_score": 0,
      "token_id": "4888",
      "token_type": "erc721"
    },
    {
      "Collection_items_total": 5000,
      "Collection_owners_total": 1176,
      "amount": 1,
      "chain": "ethereum",
      "collection_image_url": "https://logo.nftscan.com/logo/0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8.png",
      "collection_name": "Minion Yacht Club",
      "collection_slug": "MYC",
      "contract_address": "0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8",
      "description": "5000 unique Minion Yacht Club NFTs",
      "floor_price": 0.016,
      "image_thumbnail_url": "https://d3v0kmlgfpwg7s.cloudfront.net/0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8/0x0000000000000000000000000000000000000000000000000000000000001354.png",
      "image_url": "https://ipfs.io/ipfs/QmYM5mBUG4fdWfXYfNS2wtgaoSefUtS8BzL6CAJPkTmSod/4948.png",
      "latest_trade_price": 0,
      "latest_trade_symbol": "",
      "latest_trade_timestamp": 0,
      "name": "Minion Yacht Club #4948",
      "opensea_verified": false,
      "rarity_rank": 0,
      "rarity_score": 0,
      "token_id": "4948",
      "token_type": "erc721"
    },
    {
      "Collection_items_total": 5000,
      "Collection_owners_total": 1176,
      "amount": 1,
      "chain": "ethereum",
      "collection_image_url": "https://logo.nftscan.com/logo/0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8.png",
      "collection_name": "Minion Yacht Club",
      "collection_slug": "MYC",
      "contract_address": "0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8",
      "description": "5000 unique Minion Yacht Club NFTs",
      "floor_price": 0.016,
      "image_thumbnail_url": "https://d3v0kmlgfpwg7s.cloudfront.net/0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8/0x0000000000000000000000000000000000000000000000000000000000000d46.png",
      "image_url": "https://ipfs.io/ipfs/QmYM5mBUG4fdWfXYfNS2wtgaoSefUtS8BzL6CAJPkTmSod/3398.png",
      "latest_trade_price": 0,
      "latest_trade_symbol": "",
      "latest_trade_timestamp": 0,
      "name": "Minion Yacht Club #3398",
      "opensea_verified": false,
      "rarity_rank": 0,
      "rarity_score": 0,
      "token_id": "3398",
      "token_type": "erc721"
    },
    {
      "Collection_items_total": 3017385,
      "Collection_owners_total": 696366,
      "amount": 1,
      "chain": "ethereum",
      "collection_image_url": "https://logo.nftscan.com/logo/0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85.png",
      "collection_name": "ENS",
      "collection_slug": "",
      "contract_address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
      "description": "sdmqa.eth, an ENS name.",
      "floor_price": 0,
      "image_thumbnail_url": "https://metadata.ens.domains/mainnet/0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85/0x605a4a5f80a8aa2b6eabfca6a9ed9b377e580b9263fc3633256f1a8f9496e3d7/image",
      "image_url": "https://metadata.ens.domains/mainnet/0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85/0x605a4a5f80a8aa2b6eabfca6a9ed9b377e580b9263fc3633256f1a8f9496e3d7/image",
      "latest_trade_price": 0,
      "latest_trade_symbol": "",
      "latest_trade_timestamp": 0,
      "name": "sdmqa.eth",
      "opensea_verified": true,
      "rarity_rank": 0,
      "rarity_score": 0,
      "token_id": "43581563003797581731612041245693187210013389736158436022912969985596331582423",
      "token_type": "erc721"
    },
    {
      "Collection_items_total": 3017385,
      "Collection_owners_total": 696366,
      "amount": 1,
      "chain": "ethereum",
      "collection_image_url": "https://logo.nftscan.com/logo/0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85.png",
      "collection_name": "ENS",
      "collection_slug": "",
      "contract_address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
      "description": "snapshot-test.eth, an ENS name.",
      "floor_price": 0,
      "image_thumbnail_url": "https://metadata.ens.domains/mainnet/0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85/0x05142fd87afabd077530f5fc2e55566c458f8b98f2b38282d93795b61dec0253/image",
      "image_url": "https://metadata.ens.domains/mainnet/0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85/0x05142fd87afabd077530f5fc2e55566c458f8b98f2b38282d93795b61dec0253/image",
      "latest_trade_price": 0,
      "latest_trade_symbol": "",
      "latest_trade_timestamp": 0,
      "name": "snapshot-test.eth",
      "opensea_verified": true,
      "rarity_rank": 0,
      "rarity_score": 0,
      "token_id": "2297231402589926265994642257285271894355610705140450180983845618568961720915",
      "token_type": "erc721"
    }
  ],
  "total_collection_count": 3,
  "total_count": 6,
  "total_nfts_balance": 190.07552100000004
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Verify NFT assets.

GET /api/v1/data/nft/asset_verify

Verify NFT assets.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chainbinance, arbitrum, eth-goerli, polygon-mumbai, arb-goerli
contract_address string nft contract address. If there are multiple addresses, split by ‘,’
wallet string Required: wallet address. If there are multiple addresses, split by ‘,’

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "0x1fCce63Bbf7Af1ce01Fc2eC8EeE703380A86164f": [
    {
      "asset_count": 2,
      "contract_address": "0x558d3e946e9ea6bbd0599f1225ae22d25b11d10e"
    },
    {
      "asset_count": 1,
      "contract_address": "0xe362e7265aebc0dd25c1eb7de339692c20a869b0"
    },
    {
      "asset_count": 1,
      "contract_address": "0x1a223494ed356c2990803ec5d904389e8feec1a2"
    },
    {
      "asset_count": 1,
      "contract_address": "0x9234f65147cac2eebe251a1c0376f13db1384fe8"
    },
    {
      "asset_count": 1,
      "contract_address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85"
    }
  ],
  "0xE6D0Dd18C6C3a9Af8C2FaB57d6e6A38E29d513cC": [
    {
      "asset_count": 3,
      "contract_address": "0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8"
    },
    {
      "asset_count": 2,
      "contract_address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85"
    },
    {
      "asset_count": 1,
      "contract_address": "0x495f947276749ce646f68ac8c248420045cb7b5e"
    }
  ]
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query the crypto token list.

GET /api/v1/data/crypto/list

Get crypto list.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
page_no integer Required: Page number, start at 0
page_size integer Required: Page size, maximum value is 100

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "crypto_list": [
    {
      "current_price": {
        "currency": "usd",
        "price": 27823
      },
      "description": "",
      "id": "bitcoin",
      "image_url": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png?1547033579",
      "name": "Bitcoin",
      "symbol": "btc"
    },
    {
      "current_price": {
        "currency": "usd",
        "price": 1905.05
      },
      "description": "",
      "id": "ethereum",
      "image_url": "https://assets.coingecko.com/coins/images/279/large/ethereum.png?1595348880",
      "name": "Ethereum",
      "symbol": "eth"
    },
    {
      "current_price": {
        "currency": "usd",
        "price": 0.999672
      },
      "description": "",
      "id": "tether",
      "image_url": "https://assets.coingecko.com/coins/images/325/large/Tether.png?1668148663",
      "name": "Tether",
      "platforms": {
        "arbitrum": "0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9",
        "binance-smart-chain": "0x55d398326f99059ff775485246999027b3197955",
        "ethereum": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "polygon": "0xc2132d05d31c914a87c6611c10748aeb04b58e8f"
      },
      "symbol": "usdt"
    },
    {
      "current_price": {
        "currency": "usd",
        "price": 312.83
      },
      "description": "",
      "id": "binancecoin",
      "image_url": "https://assets.coingecko.com/coins/images/825/large/bnb-icon2_2x.png?1644979850",
      "name": "BNB",
      "platforms": {
        "ethereum": "0xb8c77482e45f1f44de1745f52c74426c631bdd52"
      },
      "symbol": "bnb"
    },
    {
      "current_price": {
        "currency": "usd",
        "price": 0.998761
      },
      "description": "",
      "id": "usd-coin",
      "image_url": "https://assets.coingecko.com/coins/images/6319/large/USD_Coin_icon.png?1547042389",
      "name": "USD Coin",
      "platforms": {
        "arbitrum": "0xff970a61a04b1ca14834a43f5de4533ebddb5cc8",
        "binance-smart-chain": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
        "ethereum": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "polygon": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174"
      },
      "symbol": "usdc"
    }
  ],
  "total": 1000
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query the Top100 crypto token list.

GET /api/v1/data/crypto/top_list

Get Top100 crypto list by chain.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "crypto_list": [
    {
      "contract_address": "0x55d398326f99059ff775485246999027b3197955",
      "current_price": {
        "currency": "usd",
        "price": 1.001
      },
      "description": "",
      "id": "tether",
      "image_url": "https://assets.coingecko.com/coins/images/325/large/Tether.png?1668148663",
      "name": "Tether",
      "symbol": "usdt"
    },
    {
      "contract_address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "current_price": {
        "currency": "usd",
        "price": 0.999175
      },
      "description": "",
      "id": "usd-coin",
      "image_url": "https://assets.coingecko.com/coins/images/6319/large/USD_Coin_icon.png?1547042389",
      "name": "USD Coin",
      "symbol": "usdc"
    },
    {
      "contract_address": "0xcc42724c6683b7e57334c4e856f4c9965ed682bd",
      "current_price": {
        "currency": "usd",
        "price": 0.889131
      },
      "description": "",
      "id": "matic-network",
      "image_url": "https://assets.coingecko.com/coins/images/4713/large/matic-token-icon.png?1624446912",
      "name": "Polygon",
      "symbol": "matic"
    }
  ]
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query the crypto token metadata.

GET /api/v1/data/crypto/metadata

Get crypto metadata only by id or by chain and token_address. if using chain and token_address query, and token_address is empty or x0000000000000000000000000000000000000000, you can query the native currency of the chain.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string 【OPTIONAL】ethereum, polygon, binance-smart-chain, arbitrum. You can query only by chain and token address.
id string 【OPTIONAL】crypto token id. You can query only by ID.
token_address string 【OPTIONAL】crypto token address. You can query only by chain and token address.

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "metadata": {
    "contract_address": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
    "current_price": {
      "currency": "usd",
      "price": 0.999889
    },
    "decimals": 0,
    "description": "USDC is a fully collateralized US dollar stablecoin. USDC is the bridge between dollars and trading on cryptocurrency exchanges. The technology behind CENTRE makes it possible to exchange value between people, businesses and financial institutions just like email between mail services and texts between SMS providers. We believe by removing artificial economic borders, we can create a more inclusive global economy.",
    "id": "usd-coin",
    "image_thumbnail_url": "https://assets.coingecko.com/coins/images/6319/small/USD_Coin_icon.png?1547042389",
    "image_url": "https://assets.coingecko.com/coins/images/6319/large/USD_Coin_icon.png?1547042389",
    "name": "USD Coin",
    "slug": "usdc",
    "symbol": "usdc"
  }
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Batch query the crypto token metadata.

GET /api/v1/data/crypto/batch_metadata

Batch get crypto metadata
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum.
token_address string crypto token address. If there are multiple addresses, split by ‘,’

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": {
    "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "current_price": {
      "currency": "usd",
      "price": 0.999745
    },
    "decimals": 6,
    "description": "USDC is a fully collateralized US dollar stablecoin. USDC is the bridge between dollars and trading on cryptocurrency exchanges. The technology behind CENTRE makes it possible to exchange value between people, businesses and financial institutions just like email between mail services and texts between SMS providers. We believe by removing artificial economic borders, we can create a more inclusive global economy.",
    "id": "usd-coin",
    "image_thumbnail_url": "https://assets.coingecko.com/coins/images/6319/small/USD_Coin_icon.png?1547042389",
    "image_url": "https://assets.coingecko.com/coins/images/6319/large/USD_Coin_icon.png?1547042389",
    "name": "USD Coin",
    "slug": "usdc",
    "symbol": "usdc"
  },
  "0xb9ef770b6a5e12e45983c5d80545258aa38f3b78": {
    "contract_address": "0xb9ef770b6a5e12e45983c5d80545258aa38f3b78",
    "current_price": {
      "currency": "usd",
      "price": 0.137171
    },
    "decimals": 10,
    "description": "Züs (formerly 0Chain) is a high performance storage network that powers limitless applications. It's a new way to earn a passive income from storage.",
    "id": "0chain",
    "image_thumbnail_url": "https://assets.coingecko.com/coins/images/4934/small/200x200_transparent.png?1669366739",
    "image_url": "https://assets.coingecko.com/coins/images/4934/large/200x200_transparent.png?1669366739",
    "name": "Zus",
    "slug": "zcn",
    "symbol": "zcn"
  }
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query crypto assets by wallet address.

GET /api/v1/data/wallet/crypto_assets

Query NFT assets for owner.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum, eth-goerli, polygon-mumbai, arb-goerli
refresh boolean Refresh cache
wallet string Required: wallet address. If there are multiple addresses, split by ‘,’

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "infos": {
    "0x1fcce63bbf7af1ce01fc2ec8eee703380a86164f": {
      "crypto_assets": [
        {
          "balance": "1000000000000000000000",
          "balance_val": 1000,
          "chain": "ethereum",
          "contract_address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
          "current_balance": {
            "currency": "usd",
            "price": 0.01028
          },
          "decimals": 18,
          "image": "https://storage.googleapis.com/zapper-fi-assets/tokens/ethereum/0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce.png",
          "price": {
            "currency": "usd",
            "price": 0.00001028
          },
          "symbol": "SHIB"
        },
        {
          "balance": "502151343112287616",
          "balance_val": 0.5021513431122876,
          "chain": "ethereum",
          "contract_address": "0x0000000000000000000000000000000000000000",
          "current_balance": {
            "currency": "usd",
            "price": 958.6671721625305
          },
          "decimals": 18,
          "image": "https://storage.googleapis.com/zapper-fi-assets/tokens/ethereum/0x0000000000000000000000000000000000000000.png",
          "price": {
            "currency": "usd",
            "price": 1909.12
          },
          "symbol": "ETH"
        }
      ],
      "total_assets_balance": 143.6292512102347,
      "total_count": 2,
      "total_currency": "usd"
    },
    "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc": {
      "crypto_assets": [
        {
          "balance": "426923504521609829",
          "balance_val": 0.4269235045216099,
          "chain": "ethereum",
          "contract_address": "0x0000000000000000000000000000000000000000",
          "current_balance": {
            "currency": "usd",
            "price": 815.0482009522958
          },
          "decimals": 18,
          "image": "https://storage.googleapis.com/zapper-fi-assets/tokens/ethereum/0x0000000000000000000000000000000000000000.png",
          "price": {
            "currency": "usd",
            "price": 1909.12
          },
          "symbol": "ETH"
        }
      ],
      "total_assets_balance": 815.0482009522958,
      "total_count": 1,
      "total_currency": "usd"
    }
  },
  "merge_asset_balance": 958.6774521625305,
  "merge_currency": "usd",
  "merge_infos": [
    {
      "balance": "1000000000000000000000",
      "balance_val": 1000,
      "chain": "ethereum",
      "contract_address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
      "current_balance": {
        "currency": "usd",
        "price": 0.01028
      },
      "decimals": 18,
      "image": "https://storage.googleapis.com/zapper-fi-assets/tokens/ethereum/0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce.png",
      "price": {
        "currency": "usd",
        "price": 0.00001028
      },
      "symbol": "SHIB"
    },
    {
      "balance": "502151343112287616",
      "balance_val": 0.5021513431122876,
      "chain": "ethereum",
      "contract_address": "0x0000000000000000000000000000000000000000",
      "current_balance": {
        "currency": "usd",
        "price": 958.6671721625305
      },
      "decimals": 18,
      "image": "https://storage.googleapis.com/zapper-fi-assets/tokens/ethereum/0x0000000000000000000000000000000000000000.png",
      "price": {
        "currency": "usd",
        "price": 1909.12
      },
      "symbol": "ETH"
    }
  ]
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Verify crypto token assets.

GET /api/v1/data/crypto/asset_verify

Verify crypto assets.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum
contract_address string contract address. If there are multiple addresses, split by ‘,’
wallet string Required: wallet address. If there are multiple addresses, split by ‘,’

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "0x1fcce63bbf7af1ce01fc2ec8eee703380a86164f": [
    {
      "balance": "1000000000000000000000",
      "contract_address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
      "decimals": 18
    },
    {
      "balance": "75227838590677764",
      "contract_address": "0x0000000000000000000000000000000000000000",
      "decimals": 18
    }
  ],
  "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc": [
    {
      "balance": "428178054551253829",
      "contract_address": "0x0000000000000000000000000000000000000000",
      "decimals": 18
    }
  ]
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query transactions by wallet address.

GET /api/v1/data/wallet/transactions

Query transactions by wallet address.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum
page_key integer Page key
page_size integer Required: Page size
wallet string Required: wallet address.

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "infos": [
    {
      "aggregate_exchange_name": "",
      "amount": "1",
      "block_hash": "0x49ea82d11f9073aa51be5d49f23e536b68f7fbbf5ce7014b07dd4b3fdf563a0a",
      "block_number": 17086165,
      "contract_address": "ENS",
      "contract_name": "",
      "contract_token_id": "0x05142fd87afabd077530f5fc2e55566c458f8b98f2b38282d93795b61dec0253",
      "erc_type": "erc721",
      "event_type": "Mint",
      "exchange_name": "",
      "from": "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc",
      "gas_fee": 0.012017112886505,
      "gas_price": "0xe62a6d22a",
      "gas_used": "0x2f7c4",
      "hash": "0x68ff269c04b54417d5fe87ab7619edcb5bdabe2a83e02bf85ecc526b694ade5a",
      "receive": "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc",
      "send": "0x0000000000000000000000000000000000000000",
      "timestamp": 1681974683000,
      "to": "0x283af0b28c62c092c9727f1ee09c02ca627eb7f5",
      "token_id": "2297231402589926265994642257285271894355610705140450180983845618568961720915",
      "trade_price": 0.002814024786164385,
      "trade_symbol": "ETH",
      "trade_symbol_address": "",
      "trade_value": "0x9ff5733c4baa1"
    },
    {
      "aggregate_exchange_name": "",
      "amount": "1",
      "block_hash": "0x24a7091384cf5d263881ffd9cabc217fafed36b8bd51e9a64d24f2edf2920e04",
      "block_number": 17024894,
      "contract_address": "OpenSea Shared Storefront",
      "contract_name": "",
      "contract_token_id": "0xbe4ace2fd201c1e94cd84d100468cad2769b94e40000000000327a0000000001",
      "erc_type": "erc1155",
      "event_type": "Transfer",
      "exchange_name": "",
      "from": "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc",
      "gas_fee": 0.001147248400477354,
      "gas_price": "0x5180aa63f",
      "gas_used": "0xccd6",
      "hash": "0x037cae8854ccae326e12f9000dba433f303ad7b4e7580e13c83f1ac7649e2ca4",
      "receive": "0x5ee9bf1c6e9891a8777df37f2cfdfba8b48a5413",
      "send": "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc",
      "timestamp": 1681216595000,
      "to": "0x495f947276749ce646f68ac8c248420045cb7b5e",
      "token_id": "86071610962595450673568854298565077389762097251578306908704678309601203978241",
      "trade_price": 0,
      "trade_symbol": "ETH",
      "trade_symbol_address": "",
      "trade_value": "0x0"
    },
    {
      "aggregate_exchange_name": "",
      "amount": "1",
      "block_hash": "0x8049508f5d1a0963ed5c4f824a79a8d8bbcc53a080b7d981aea06f1653c3e2f1",
      "block_number": 17024312,
      "contract_address": "OpenSea Shared Storefront",
      "contract_name": "",
      "contract_token_id": "0x7d4fcee3197e536aad4a671864a6c28a700a7826000000000016290000000001",
      "erc_type": "erc1155",
      "event_type": "Transfer",
      "exchange_name": "",
      "from": "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc",
      "gas_fee": 0.001088650905205948,
      "gas_price": "0x4d56f869a",
      "gas_used": "0xccd6",
      "hash": "0x7fd576f73cab7b7fe29cbf7a6f7250920ddf7619c99cbdafc3c213e29a72b209",
      "receive": "0x5ee9bf1c6e9891a8777df37f2cfdfba8b48a5413",
      "send": "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc",
      "timestamp": 1681209491000,
      "to": "0x495f947276749ce646f68ac8c248420045cb7b5e",
      "token_id": "56680114873365897938787124601928115541491218782982230896554300606790345162753",
      "trade_price": 0,
      "trade_symbol": "ETH",
      "trade_symbol_address": "",
      "trade_value": "0x0"
    },
    {
      "aggregate_exchange_name": "",
      "amount": "1",
      "block_hash": "0x225063fc22ba439c78f6f805dc130bf4c5d7e4e45954883615a8c54ac40dc36b",
      "block_number": 16989524,
      "contract_address": "OpenSea Shared Storefront",
      "contract_name": "",
      "contract_token_id": "0xc22ca92c73f5494a24677af9a32da682272edb0a00000000009a440000000001",
      "erc_type": "erc1155",
      "event_type": "Transfer",
      "exchange_name": "",
      "from": "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc",
      "gas_fee": 0.00131378767896153,
      "gas_price": "0x5d5577477",
      "gas_used": "0xccd6",
      "hash": "0x4d177cd3f848494a80cf13fd7a6685fe515b314d3a414db54e9b9837945be0dd",
      "receive": "0x5ee9bf1c6e9891a8777df37f2cfdfba8b48a5413",
      "send": "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc",
      "timestamp": 1680783575000,
      "to": "0x495f947276749ce646f68ac8c248420045cb7b5e",
      "token_id": "87827601489586007682730168153313142854254012070057827254269574352206664040449",
      "trade_price": 0,
      "trade_symbol": "ETH",
      "trade_symbol_address": "",
      "trade_value": "0x0"
    },
    {
      "aggregate_exchange_name": "",
      "amount": "1",
      "block_hash": "0x7c1523883f5667aec56346c93c2d5aa6db39b383f01ee6e7f9b5cf1bb628d57e",
      "block_number": 16244856,
      "contract_address": "OpenSea Shared Storefront",
      "contract_name": "",
      "contract_token_id": "0xbe4ace2fd201c1e94cd84d100468cad2769b94e40000000000327a0000000001",
      "erc_type": "erc1155",
      "event_type": "Sale",
      "exchange_name": "OpenSea",
      "from": "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc",
      "gas_fee": 0.008324780506499527,
      "gas_price": "0x2e04232c9",
      "gas_used": "0xa4896",
      "hash": "0xe76343ea1db4c4daafbad85c7396b559c15de2693da8106a03d95b3f754c73ee",
      "receive": "0xe6d0dd18c6c3a9af8c2fab57d6e6a38e29d513cc",
      "send": "0xbe4ace2fd201c1e94cd84d100468cad2769b94e4",
      "timestamp": 1671767675000,
      "to": "0x00000000006c3852cbef3e08e8df289169ede581",
      "token_id": "86071610962595450673568854298565077389762097251578306908704678309601203978241",
      "trade_price": 0.024,
      "trade_symbol": "ETH",
      "trade_symbol_address": "",
      "trade_value": "0x5543df729c0000"
    }
  ],
  "next_page_key": "1624485600560004",
  "total": 12
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query transactions by contract address.

GET /api/v1/data/collection/transactions

Query transactions by contract address.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum
contract_address string Required: contract address.
page_key integer Page key
page_size integer Required: Page size

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "infos": [
    {
      "aggregate_exchange_name": "",
      "amount": "1",
      "block_hash": "0x4122b907b437d20832401a1084ac382376ae95290374300210e945fb78bbcab8",
      "block_number": 17141464,
      "contract_address": "OpenSea Shared Storefront",
      "contract_name": "",
      "contract_token_id": "0x874fb944ed22ea20ab5e7206b78270d08ac2f847000000000000030000000001",
      "erc_type": "erc1155",
      "event_type": "Sale",
      "exchange_name": "OpenSea",
      "from": "0x02cdb43ae676dd5e2cf55c161c9aca1ab55d24f0",
      "gas_fee": 0.00560001181681018,
      "gas_price": "0x784ff22ed",
      "gas_used": "0x2a554",
      "hash": "0x1e4ee60220435a780a43ac92aec5898f80b2fcec732400357acb7a99c6fba447",
      "receive": "0x02cdb43ae676dd5e2cf55c161c9aca1ab55d24f0",
      "send": "0x874fb944ed22ea20ab5e7206b78270d08ac2f847",
      "timestamp": 1682646515000,
      "to": "0x00000000000001ad428e4906ae43d8f9852d0dd6",
      "token_id": "61203094158182360555736873103680759635791552495870609887764700026651705081857",
      "trade_price": 0.0008,
      "trade_symbol": "ETH",
      "trade_symbol_address": "",
      "trade_value": "0x2d79883d20000"
    },
    {
      "aggregate_exchange_name": "",
      "amount": "1",
      "block_hash": "0x7c8b15594d49dfa520bf8b95d4d7cfbb84494833888818074bfe8bd2acb90f25",
      "block_number": 17141461,
      "contract_address": "OpenSea Shared Storefront",
      "contract_name": "",
      "contract_token_id": "0x3681ee3ccaabf12b1ddf285a03434c22246617e20000000000001d00000000c8",
      "erc_type": "erc1155",
      "event_type": "Transfer",
      "exchange_name": "",
      "from": "0x3681ee3ccaabf12b1ddf285a03434c22246617e2",
      "gas_fee": 0.002175395073188052,
      "gas_price": "0x7cbee4b05",
      "gas_used": "0xfdc4",
      "hash": "0x00385c272ff43300c292b6e53ea4341535d44342bae71c08b05f1efea833a1b7",
      "receive": "0x6b453ec01c6d7537dd8147f9aae524b2cdcfd4a2",
      "send": "0x3681ee3ccaabf12b1ddf285a03434c22246617e2",
      "timestamp": 1682646479000,
      "to": "0x495f947276749ce646f68ac8c248420045cb7b5e",
      "token_id": "24654461349423948513486073674240446325896634268186859416227732296794516750536",
      "trade_price": 0,
      "trade_symbol": "ETH",
      "trade_symbol_address": "",
      "trade_value": "0x0"
    },
    {
      "aggregate_exchange_name": "",
      "amount": "1",
      "block_hash": "0x674d92bd7bd7b15bfe4629cded84d5368cb4adc3f6885535a1d4496b1ca3792a",
      "block_number": 17141456,
      "contract_address": "OpenSea Shared Storefront",
      "contract_name": "",
      "contract_token_id": "0xb240d69617c43410f5f79724d2e7d0631f595c20000000000000b50000000001",
      "erc_type": "erc1155",
      "event_type": "Sale",
      "exchange_name": "OpenSea",
      "from": "0xdcfff5808d0b5b9c5e874fcdb584d593951a57d5",
      "gas_fee": 0.00510739312829329,
      "gas_price": "0x6fc7837c6",
      "gas_used": "0x298e7",
      "hash": "0x74f55dc48f63533ef7bc21581e1030449c331a633aacba292c3d35ce42855c8d",
      "receive": "0xdcfff5808d0b5b9c5e874fcdb584d593951a57d5",
      "send": "0xb240d69617c43410f5f79724d2e7d0631f595c20",
      "timestamp": 1682646419000,
      "to": "0x00000000000001ad428e4906ae43d8f9852d0dd6",
      "token_id": "80626246280180343079720092385238387359112636916756671634898853670218146775041",
      "trade_price": 0.04,
      "trade_symbol": "ETH",
      "trade_symbol_address": "",
      "trade_value": "0x8e1bc9bf040000"
    },
    {
      "aggregate_exchange_name": "",
      "amount": "1",
      "block_hash": "0xd078e99834e7afee97b36fb44b9bb12994650bbe5249c7984baa319e9d872227",
      "block_number": 17141450,
      "contract_address": "OpenSea Shared Storefront",
      "contract_name": "",
      "contract_token_id": "0x8c3d3ec4f3498f018c11d176b1fe22f1b776c5c40000000000000100000003e8",
      "erc_type": "erc1155",
      "event_type": "Transfer",
      "exchange_name": "",
      "from": "0x8c3d3ec4f3498f018c11d176b1fe22f1b776c5c4",
      "gas_fee": 0.002113409893468864,
      "gas_price": "0x792b37e9c",
      "gas_used": "0xfdd0",
      "hash": "0x6da0fcfd40de653a8d0ca01710f6087b7b7a7171eda865fda529c95f04b8eb0c",
      "receive": "0xa0c0a5ba90e7855470e27b6539b2b2f4706f9d07",
      "send": "0x8c3d3ec4f3498f018c11d176b1fe22f1b776c5c4",
      "timestamp": 1682646347000,
      "to": "0x495f947276749ce646f68ac8c248420045cb7b5e",
      "token_id": "63432009690652970728332620090338144854373611202839718193069580086171333034984",
      "trade_price": 0,
      "trade_symbol": "ETH",
      "trade_symbol_address": "",
      "trade_value": "0x0"
    },
    {
      "aggregate_exchange_name": "",
      "amount": "1",
      "block_hash": "0x6ced653423e61a25cd758045d08050f08f1867b6755fecfdd285359583c6ec52",
      "block_number": 17141448,
      "contract_address": "OpenSea Shared Storefront",
      "contract_name": "",
      "contract_token_id": "0xcda31ef080e99f60573c4d8c426d32b05a44ac4f0000000000007d0000002710",
      "erc_type": "erc1155",
      "event_type": "Sale",
      "exchange_name": "OpenSea",
      "from": "0xfe2e001f5325e2343cfc7674b9a8c2adfb1dfcf7",
      "gas_fee": 0.004852055835082116,
      "gas_price": "0x7c45c51e4",
      "gas_used": "0x23829",
      "hash": "0xd5fff16853878de2767b1b941c084c1ca1bda6a09aa9290bbe4c2b8c0d0109e0",
      "receive": "0xfe2e001f5325e2343cfc7674b9a8c2adfb1dfcf7",
      "send": "0xdeb1a0da4dd1ce288c31e81fb087f02b97cf433e",
      "timestamp": 1682646323000,
      "to": "0x00000000000001ad428e4906ae43d8f9852d0dd6",
      "token_id": "93012343567482170177249797685506444877646806411886788265491273192266423871248",
      "trade_price": 0.009,
      "trade_symbol": "ETH",
      "trade_symbol_address": "",
      "trade_value": "0x1ff973cafa8000"
    }
  ],
  "next_page_key": "1714144800790001",
  "total": 3718816
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query transactions by nft.

GET /api/v1/data/nft/transactions

Query transactions by nft token.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum
contract_address string Required: contract address.
page_key integer Page key
page_size integer Required: Page size
token_id string Required: token id.

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "infos": [
    {
      "aggregate_exchange_name": "",
      "amount": "1",
      "block_hash": "0x0eb856b8a17ee2199c8af6051ca993430897533c1af3107aa40da127e314fe39",
      "block_number": 15761918,
      "contract_address": "Minion Yacht Club",
      "contract_name": "",
      "contract_token_id": "0x0000000000000000000000000000000000000000000000000000000000000001",
      "erc_type": "erc721",
      "event_type": "Mint",
      "exchange_name": "",
      "from": "0x6e9e1cd3c773adecfd876596d394b666bb3a5e7c",
      "gas_fee": 0.001592493138179664,
      "gas_price": "0x3a4db3256",
      "gas_used": "0x18d78",
      "hash": "0xf51e46fce88b94bdaf7bcab8a0182ef0a2e71b13ec050e837c6b3cfbf95e914c",
      "receive": "0x6e9e1cd3c773adecfd876596d394b666bb3a5e7c",
      "send": "0x0000000000000000000000000000000000000000",
      "timestamp": 1665938291000,
      "to": "0x1a8046b6f194f9f5a84bf001e133a4df0a298ad8",
      "token_id": "1",
      "trade_price": 0,
      "trade_symbol": "ETH",
      "trade_symbol_address": "",
      "trade_value": "0x0"
    }
  ],
  "next_page_key": "",
  "total": 1
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query transaction status.

GET /api/v1/data/transactions/status

Query the status of transaction.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, arbitrum
hash string Required: transaction hash.

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "hash": "0xd458e9a49d043ee3c756f85ab11fc387023d8b86c8a9ac97e52788f7b62cc123",
  "status": "success"
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query the statistics of trading rank.

GET /api/v1/data/statistics/trading_rank

Query the statistics of trading rank.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chain, arbitrum
time string Required: 1d, 7d, 30d

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

[
  {
    "amounts_total": 19469,
    "average_price": 11.2187,
    "average_price_change": "4.00%",
    "contract_address": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
    "contract_name": "MutantApeYachtClub",
    "exchange_volume_change_24h": "-61.5300%",
    "exchange_volume_change_7d": "-3.9600%",
    "floor_price": 11.0777,
    "highest_price": 26.69,
    "items_total": 19469,
    "logo_url": "https://logo.nftscan.com/logo/0x60e4d786628fea6478f785a6d7e704777c86a7c6.png",
    "lowest_price": 10.68,
    "market_cap": 218416.8703,
    "market_trend": "4.00%",
    "mint_average_price": 1.4459,
    "mint_gas_fee": 1808.5315,
    "mint_price_total": 28151.1174,
    "owners_total": 11180,
    "price_7d": [
      {
        "average_price": 10.3398,
        "begin_timestamp": 1682092800000,
        "end_timestamp": 1682179200000
      },
      {
        "average_price": 11.2782,
        "begin_timestamp": 1682179200000,
        "end_timestamp": 1682265600000
      },
      {
        "average_price": 11.4529,
        "begin_timestamp": 1682265600000,
        "end_timestamp": 1682352000000
      },
      {
        "average_price": 11.2574,
        "begin_timestamp": 1682352000000,
        "end_timestamp": 1682438400000
      },
      {
        "average_price": 10.9635,
        "begin_timestamp": 1682438400000,
        "end_timestamp": 1682524800000
      },
      {
        "average_price": 10.9428,
        "begin_timestamp": 1682524800000,
        "end_timestamp": 1682611200000
      },
      {
        "average_price": 11.6993,
        "begin_timestamp": 1682611200000,
        "end_timestamp": 1682697600000
      }
    ],
    "sales": 92,
    "sales_change": "-59.00%",
    "volume": 1032.1205,
    "volume_7d": [
      {
        "average_price": 0,
        "begin_timestamp": 1682092800000,
        "end_timestamp": 1682179200000
      },
      {
        "average_price": 0,
        "begin_timestamp": 1682179200000,
        "end_timestamp": 1682265600000
      },
      {
        "average_price": 0,
        "begin_timestamp": 1682265600000,
        "end_timestamp": 1682352000000
      },
      {
        "average_price": 0,
        "begin_timestamp": 1682352000000,
        "end_timestamp": 1682438400000
      },
      {
        "average_price": 0,
        "begin_timestamp": 1682438400000,
        "end_timestamp": 1682524800000
      },
      {
        "average_price": 0,
        "begin_timestamp": 1682524800000,
        "end_timestamp": 1682611200000
      },
      {
        "average_price": 0,
        "begin_timestamp": 1682611200000,
        "end_timestamp": 1682697600000
      }
    ],
    "volume_change": "-58.00%"
  }
]

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query the floor prices of a NFT collection by marketplace.

GET /api/v1/data/statistics/floor_price

Query the floor prices of a NFT collection by marketplace.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum
contract_address string Required: contract address.

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

[
  {
    "openSea": {
      "collectionUrl": "https://opensea.io/collection/world-of-women-nft",
      "error": null,
      "floorPrice": 1.299,
      "priceCurrency": "ETH",
      "retrievedAt": "2023-04-04T18:07:05.057Z"
    }
  },
  {
    "looksRare": {
      "collectionUrl": "https://looksrare.org/collections/0xe785e82358879f061bc3dcac6f0444462d4b5330",
      "error": null,
      "floorPrice": 1.379,
      "priceCurrency": "ETH",
      "retrievedAt": "2023-04-28T02:10:30.851Z"
    }
  }
]

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query name list by wallet address.

GET /api/v1/data/resolving/names

Get names by wallet address.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
wallet string Required: the owner’s wallet address. If there are multiple addresses, split by ‘,’

Responses

Status Description
200 supplier_type enumeration values are ens, unstoppable, did, lens, space.
400 Internal error.

200 response

{
  "0x2e552E3aD9f7446e9caB378c008315E0C26c0398": [
    {
      "name": "allen.bnb",
      "supplier_type": "space"
    }
  ],
  "0x34Ee7f65Fd98F46cE0B71c174541A54E9E9C67B8": [],
  "0x3fBD97eAa8c435BA03d1134252EAC6EeCD3F794b": [
    {
      "name": "bill666500.eth",
      "supplier_type": "ens"
    },
    {
      "name": "cryptobill.bnb",
      "supplier_type": "space"
    }
  ],
  "0x5f560ec1edc638d7dab7c7a1ca8c3b0f6ed1848b": [
    {
      "name": "phone.bit",
      "supplier_type": "did"
    }
  ],
  "0xE6D0Dd18C6C3a9Af8C2FaB57d6e6A38E29d513cC": [
    {
      "name": "sdmqa.eth",
      "supplier_type": "ens"
    }
  ]
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query wallet address by name.

GET /api/v1/data/resolving/names

Get address by resolving name.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
name string Required: web3 domain name

Responses

Status Description
200 supplier_type enumeration values are ens, unstoppable, did, lens, space.
400 Internal error.

200 response

{
  "address": "0xE6D0Dd18C6C3a9Af8C2FaB57d6e6A38E29d513cC",
  "supplier_type": "ens"
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query POAP list by wallet address.

GET /api/v1/data/poaps/list

Get poap list by wallet address.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
page_no integer Required: Page number, start at 0
page_size integer Required: Page size
wallet string Required: the owner’s wallet address.

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "poap_list": [
    {
      "chain": "xdai",
      "created": "2023-02-15 02:15:10",
      "event": {
        "city": "Denver, Colorado",
        "country": "USA",
        "description": "Holders of this POAP are granted entry to this staking gathering at ETHDenver on 1 March 2023\r\n\r\nEvent:\r\nHear me out: we're gonna go to a bar. Some of us are going to have drinks. Some will choose to drink green tea with a bit of red wine in it. We'll probably say some things about staking to each other. We'll walk away with new friends and new enemies to discuss more things about staking ETH in our staking chat channels and subreddits. We might even come away with some new ideas on how to do that thing we all want: decentralize the network even more.",
        "end_date": "01-Mar-2023",
        "event_url": "https://ethstaker.cc/",
        "expiry_data": "",
        "fancy_id": "ethstaker-hosts-staking-on-tap-at-ethdenver-2023",
        "id": 97582,
        "image_url": "https://assets.poap.xyz/ethstaker-hosts-staking-on-tap-at-ethdenver-2023-logo-1674155584271.png",
        "name": "EthStaker hosts Staking on Tap at ETHDenver [admit one]",
        "start_date": "01-Mar-2023",
        "supply": 176,
        "year": 2023
      },
      "owner": "0xea5ce2f9a33d36534ee3409d81322feb3f91ed8a",
      "token_id": "6317310"
    },
    {
      "chain": "xdai",
      "created": "2021-11-24 15:37:05",
      "event": {
        "city": "Miami",
        "country": "USA",
        "description": "Keyboard Monkey DJ debut at Size Basel Miami",
        "end_date": "03-Dec-2021",
        "event_url": "",
        "expiry_data": "",
        "fancy_id": "keyboard-monkey-dj-debut-at-size-basel-miami-2021",
        "id": 15003,
        "image_url": "https://assets.poap.xyz/keyboard-monkey-dj-debut-at-size-basel-miami-2021-logo-1637699179881.png",
        "name": "Keyboard Monkey DJ debut at Size Basel Miami",
        "start_date": "03-Dec-2021",
        "supply": 80,
        "year": 2021
      },
      "owner": "0xea5ce2f9a33d36534ee3409d81322feb3f91ed8a",
      "token_id": "2799889"
    },
    {
      "chain": "xdai",
      "created": "2021-09-21 13:29:25",
      "event": {
        "city": "",
        "country": "",
        "description": "This badge certifies that you were among the original elite that helped launch the yearn.finance protocol.\n\nYou played, not paid, for your share of the OG 30,000 YFI.\n\nBefore all the hype, you were among the few that earned YFI directly from the protocol.\n\nYearn Finance thanks you for your visionary support. Wear this badge with honor.",
        "end_date": "07-Aug-2020",
        "event_url": "https://yearn.finance/",
        "expiry_data": "",
        "fancy_id": "i-played-4-yfi-2020",
        "id": 478,
        "image_url": "https://assets.poap.xyz/i-played-4-yfi-2020-logo-1604247754471.png",
        "name": "I Played 4 YFI",
        "start_date": "17-Jul-2020",
        "supply": 1622,
        "year": 2020
      },
      "owner": "0xea5ce2f9a33d36534ee3409d81322feb3f91ed8a",
      "token_id": "1427707"
    },
    {
      "chain": "homestead",
      "created": "2019-05-28 04:37:37",
      "event": {
        "city": "New York",
        "country": "United States",
        "description": "Part of the EthGlobal Community",
        "end_date": "19-May-2019",
        "event_url": "https://ethnewyork.com/",
        "expiry_data": "",
        "fancy_id": "ethny-19",
        "id": 28,
        "image_url": "https://assets.poap.xyz/ethny-19.png",
        "name": "ETHNewYork",
        "start_date": "17-May-2019",
        "supply": 316,
        "year": 2019
      },
      "owner": "0xea5ce2f9a33d36534ee3409d81322feb3f91ed8a",
      "token_id": "690"
    },
    {
      "chain": "homestead",
      "created": "2019-05-28 00:34:55",
      "event": {
        "city": "Paris",
        "country": "France",
        "description": "Part of the EthGlobal Community",
        "end_date": "10-Mar-2019",
        "event_url": "https://ethparis.com/",
        "expiry_data": "",
        "fancy_id": "ethparis-19",
        "id": 24,
        "image_url": "https://assets.poap.xyz/ethparis-19.png",
        "name": "ETHParis",
        "start_date": "08-Mar-2019",
        "supply": 70,
        "year": 2019
      },
      "owner": "0xea5ce2f9a33d36534ee3409d81322feb3f91ed8a",
      "token_id": "498"
    },
    {
      "chain": "homestead",
      "created": "2019-05-27 22:11:14",
      "event": {
        "city": "Denver",
        "country": "United States",
        "description": "Part of the EthGlobal Community",
        "end_date": "19-Feb-2019",
        "event_url": "https://www.ethdenver.com/",
        "expiry_data": "",
        "fancy_id": "ethdenver-19",
        "id": 14,
        "image_url": "https://assets.poap.xyz/ethdenver-19.png",
        "name": "ETHDenver 2019",
        "start_date": "15-Feb-2019",
        "supply": 85,
        "year": 2019
      },
      "owner": "0xea5ce2f9a33d36534ee3409d81322feb3f91ed8a",
      "token_id": "1"
    }
  ],
  "total": 6
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Search NFTs by price range.

GET /api/v1/data/search/nft_with_order

Searching nfts.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon
page_key string The key required for scrolling. The first query is not required.
page_size string Required: page size
sell_price_from string Required: Minimum price to query, the currency is ETH.
sell_price_to string Required: Maximum price to query, the currency is ETH.

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "list": [
    {
      "best_sell_order": {
        "create_time": "2023-05-22T08:51:46.108Z",
        "order_id": "ETHEREUM:0x7b98fa1bd8fa911db6d5a63a4334435bddb28788a0cdd93a143ec4c6f7e5a6cb",
        "platform": "OPEN_SEA",
        "sell_price": "0.00000000001",
        "sell_price_usd": "0.000000018551566486040874",
        "sell_stock": 1,
        "seller": "ETHEREUM:0xedd21c1e7dc8c207ba6e135deb8d54324fc88d2d",
        "status": "ACTIVE",
        "update_time": "2023-05-22T08:51:46.108Z"
      },
      "blockchain": "ethereum",
      "contract_address": "0xba55f1489d2e50898c65b4c7bf1fd39d91119572",
      "description": "",
      "image_url": "https://api.rarible.org/content/embedded/4614df3ef3c9a79c45d902893dcd6bde5e15d15dcb3b936df4538487da50f178",
      "name": "Shik Soldier #100",
      "sellers": 1,
      "token_id": "100",
      "token_type": "erc721",
      "total_stock": 1
    },
    {
      "best_sell_order": {
        "create_time": "2023-05-22T08:51:44.906Z",
        "order_id": "ETHEREUM:0xc86629069eb1399c946cd9f0619fe49a2c90ed8cabcbea3858703bf64cbba82d",
        "platform": "OPEN_SEA",
        "sell_price": "0.00000000001",
        "sell_price_usd": "0.000000018551566486040874",
        "sell_stock": 1,
        "seller": "ETHEREUM:0xedd21c1e7dc8c207ba6e135deb8d54324fc88d2d",
        "status": "ACTIVE",
        "update_time": "2023-05-22T08:51:44.906Z"
      },
      "blockchain": "ethereum",
      "contract_address": "0xba55f1489d2e50898c65b4c7bf1fd39d91119572",
      "description": "",
      "image_url": "https://api.rarible.org/content/embedded/05d0dd0a83d5e7180881a76cd9aac651ca44aed15e7998f45d492f49150d5f49",
      "name": "Shik Soldier #101",
      "sellers": 1,
      "token_id": "101",
      "token_type": "erc721",
      "total_stock": 1
    },
    {
      "best_sell_order": {
        "create_time": "2023-05-22T08:51:45.874Z",
        "order_id": "ETHEREUM:0x234646080c93d9369d4e0ab7c1cc408bd133052418992eed8ea60388aa0767a8",
        "platform": "OPEN_SEA",
        "sell_price": "0.00000000001",
        "sell_price_usd": "0.000000018551566486040874",
        "sell_stock": 1,
        "seller": "ETHEREUM:0xedd21c1e7dc8c207ba6e135deb8d54324fc88d2d",
        "status": "ACTIVE",
        "update_time": "2023-05-22T08:51:45.874Z"
      },
      "blockchain": "ethereum",
      "contract_address": "0xba55f1489d2e50898c65b4c7bf1fd39d91119572",
      "description": "",
      "image_url": "https://api.rarible.org/content/embedded/21f93bd3136b303db5e477d85c6ee8925963bcdb7edd861d7b17b23955fd731d",
      "name": "Shik Soldier #102",
      "sellers": 1,
      "token_id": "102",
      "token_type": "erc721",
      "total_stock": 1
    },
    {
      "best_sell_order": {
        "create_time": "2023-05-22T08:51:43.512Z",
        "order_id": "ETHEREUM:0xd2f365cc51ec7b7c00df6104bde53bb64448b60c91bc9cf3422f5450bea23a69",
        "platform": "OPEN_SEA",
        "sell_price": "0.00000000001",
        "sell_price_usd": "0.000000018551566486040874",
        "sell_stock": 1,
        "seller": "ETHEREUM:0xedd21c1e7dc8c207ba6e135deb8d54324fc88d2d",
        "status": "ACTIVE",
        "update_time": "2023-05-22T08:51:43.512Z"
      },
      "blockchain": "ethereum",
      "contract_address": "0xba55f1489d2e50898c65b4c7bf1fd39d91119572",
      "description": "",
      "image_url": "https://api.rarible.org/content/embedded/b5e138ba63baaaed88ceec576eec9a5b7f555285e81cce9900a8a6732f516ab0",
      "name": "Shik Soldier #104",
      "sellers": 1,
      "token_id": "104",
      "token_type": "erc721",
      "total_stock": 1
    },
    {
      "best_sell_order": {
        "create_time": "2023-05-22T08:51:45.615Z",
        "order_id": "ETHEREUM:0x015546145f67a78c11f052b55c46473043fcd7a462046a79c06352da9068eee5",
        "platform": "OPEN_SEA",
        "sell_price": "0.00000000001",
        "sell_price_usd": "0.000000018551566486040874",
        "sell_stock": 1,
        "seller": "ETHEREUM:0xedd21c1e7dc8c207ba6e135deb8d54324fc88d2d",
        "status": "ACTIVE",
        "update_time": "2023-05-22T08:51:45.615Z"
      },
      "blockchain": "ethereum",
      "contract_address": "0xba55f1489d2e50898c65b4c7bf1fd39d91119572",
      "description": "",
      "image_url": "https://api.rarible.org/content/embedded/4fbbe1832f5a5ef859046c1e4b9b6596784b3a146f67a9437a78d65e27d27482",
      "name": "Shik Soldier #105",
      "sellers": 1,
      "token_id": "105",
      "token_type": "erc721",
      "total_stock": 1
    }
  ],
  "page_key": "1.8551566E-8_ETHEREUM:0xba55f1489d2e50898c65b4c7bf1fd39d91119572:105"
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Verify NFT owners.

GET /api/v1/data/nft/owner_verify

Verify NFT owners.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum, polygon, binance-smart-chainbinance, arbitrum
contract_address string Required: nft contract address.
owner_address string Required: owner address. If there are multiple addresses, split by ‘,’
token_id string Required: nft token id.

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "owners": [
    "0xE6D0Dd18C6C3a9Af8C2FaB57d6e6A38E29d513cC"
  ],
  "verify_result": true
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

Query preview NFT and ENS by wallet address.

GET /api/v1/data/wallet/preview_profile

Get preview NFT and ENS by wallet address.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
wallet string Required: the owner’s wallet address.

Responses

Status Description
200 If no nft is found, show_nft is null. If no ens is found, show_ens is null.
400 Internal error.

200 response

{
  "show_ens": {
    "name": "sdmqa.eth",
    "supplier_type": "ens"
  },
  "show_nft": {
    "amount": 1,
    "chain": "ethereum",
    "collection_image_url": "https://logo.nftscan.com/logo/0x495f947276749ce646f68ac8c248420045cb7b5e.png",
    "collection_name": "OpenSea Shared Storefront",
    "collection_slug": "OPENSTORE",
    "contract_address": "0x495f947276749ce646f68ac8c248420045cb7b5e",
    "description": "",
    "image_thumbnail_url": "https://i.seadn.io/gae/RovVezN-w7PWHvQTqyzYnw4q1gA_mtELYC6PL2h4SujfVD70OdZCL57Z65Qu72qBnAdjiL-f9yCkomKaM679IXUC7YHYNl7CYmIc8g?w=500\u0026auto=format",
    "image_url": "https://i.seadn.io/gae/RovVezN-w7PWHvQTqyzYnw4q1gA_mtELYC6PL2h4SujfVD70OdZCL57Z65Qu72qBnAdjiL-f9yCkomKaM679IXUC7YHYNl7CYmIc8g?w=500\u0026auto=format",
    "name": "#3463",
    "token_id": "91903724186857662875719432177565115683543862836338196628572893226484356874241",
    "token_type": "erc1155"
  }
}

400 response

Error
Name Type Description
errcode string Required: An error code.
error string A human-readable error message. 
{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}

GET /api/v1/data/common/link_address

Generating link address for address scan url, contract scan url, collection and nft url.
Rate-limited: No
Requires authentication: No

Request

Request parameters

header parameters
Name Type Description
X-API-KEY string Required: api key.
query parameters
Name Type Description
chain string Required: ethereum,polygon,binance-smart-chain,arbitrum,optimism,solana,avalanche,klaytn
contract_address string nft contract address
token_id string nft token id
wallet string wallet address

Responses

Status Description
200 The operation is ok.
400 Internal error.

200 response

{
  "collection_opensea_url": "https://opensea.io/assets/bsc/0x85f0e02cb992aa1f9f47112f815f519ef1a59e2d",
  "nft_opensea_url": "https://opensea.io/assets/bsc/0x85f0e02cb992aa1f9f47112f815f519ef1a59e2d/10003260080",
  "scan_contract_url": "https://www.bscscan.com/address/0x85f0e02cb992aa1f9f47112f815f519ef1a59e2d",
  "scan_wallet_url": "https://www.bscscan.com/address/0x823A4220d98e98F91128A0B3E0A0e801160c0D3f"
}

400 response

{
  "errcode": "M_UNKNOW",
  "error": "Internal error."
}