Skip to main content
GET
/
nft
/
{collectionAddress}
/
asset
/
{tokenId}
Get detailed information about a specific NFT asset.
curl --request GET \
  --url https://openapiv1.coinstats.app/nft/{collectionAddress}/asset/{tokenId} \
  --header 'X-API-KEY: <api-key>'
{
  "address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
  "blockchain": "ethereum",
  "tokenId": "0",
  "attributes": [
    {
      "key": "Background",
      "kind": "string",
      "value": "Orange",
      "tokenCount": 1274,
      "onSaleCount": 41,
      "floorAskPrice": 10.5,
      "topBidValue": 10,
      "createdAt": "2024-01-27T07:15:58.523Z"
    },
    {
      "key": "Clothes",
      "kind": "string",
      "value": "Striped Tee",
      "tokenCount": 412,
      "onSaleCount": 10,
      "floorAskPrice": 10.72,
      "topBidValue": null,
      "createdAt": "2024-01-27T07:15:58.719Z"
    }
  ],
  "collectionId": "e1d92f9a882dd4db91feabe806a326af",
  "name": null,
  "previewUrl": "https://img.reservoir.tools/images/v2/mainnet/7%2FrdF%2Fe%2F0iXY8HduhRCoIehkmFeXPeOQQFbbmIPfjCZeLloToqp073iyCX%2FAT3E6uYDqjoHHp1CsuC3u6gJ%2BxixS6XKRAFdBaJMUefz4QR69ZDW9ItgF7Bv047qTmFku0Hxt5Ib2RmfppbDYaFxKWQ%3D%3D",
  "rarityRank": 2673,
  "rarityScore": 75.409,
  "source": "reservoir",
  "standard": "ERC721",
  "url": "https://img.reservoir.tools/images/v2/mainnet/i9YO%2F4yHXUdJsWcTqhqvf%2BytcG2XMhnD4zz%2BhMYH9%2FZK%2FhVtu%2B3gYAAVBBdL1dsMoZPY79XY4AQ%2FN91VDNlxaLilzKrcVKu%2FcHUBfdHr%2BSM%3D",
  "lastSaleDate": "2024-01-15T10:30:00.000Z",
  "lastSalePrice": 15.75,
  "listSource": "opensea",
  "listPrice": 20.5
}
5 credits per request

Authorizations

​
X-API-KEY
string
header
required

API key needed to access the endpoints. Example: 'demo-api-key'

Path Parameters

​
collectionAddress
string
required

The address of the NFT collection

Example:

"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

​
tokenId
string
required

The Token ID of the NFT asset

Example:

"1029"

Response

Get single asset

​
address
string
required

The contract address of the NFT

Example:

"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

​
blockchain
string
required

The blockchain network where the NFT exists

Example:

"ethereum"

​
tokenId
string
required

The unique token ID of the NFT within the collection

Example:

"0"

​
attributes
object[]
required

Array of NFT attributes/traits with detailed metadata

Example:
[
  {
    "key": "Background",
    "kind": "string",
    "value": "Orange",
    "tokenCount": 1274,
    "onSaleCount": 41,
    "floorAskPrice": 10.5,
    "topBidValue": 10,
    "createdAt": "2024-01-27T07:15:58.523Z"
  },
  {
    "key": "Clothes",
    "kind": "string",
    "value": "Striped Tee",
    "tokenCount": 412,
    "onSaleCount": 10,
    "floorAskPrice": 10.72,
    "topBidValue": null,
    "createdAt": "2024-01-27T07:15:58.719Z"
  }
]
​
collectionId
string
required

Unique identifier for the NFT collection

Example:

"e1d92f9a882dd4db91feabe806a326af"

​
name
string | null
required

Name of the NFT (can be null for some NFTs)

Example:

null

​
previewUrl
string
required

URL for the preview/thumbnail image of the NFT

Example:

"https://img.reservoir.tools/images/v2/mainnet/7%2FrdF%2Fe%2F0iXY8HduhRCoIehkmFeXPeOQQFbbmIPfjCZeLloToqp073iyCX%2FAT3E6uYDqjoHHp1CsuC3u6gJ%2BxixS6XKRAFdBaJMUefz4QR69ZDW9ItgF7Bv047qTmFku0Hxt5Ib2RmfppbDYaFxKWQ%3D%3D"

​
rarityRank
number
required

Rarity rank of the NFT within its collection (lower numbers indicate higher rarity)

Example:

2673

​
rarityScore
number
required

Numerical rarity score calculated based on trait distribution

Example:

75.409

​
source
string
required

Data source provider for the NFT information

Example:

"reservoir"

​
standard
string
required

NFT token standard (ERC721, ERC1155, etc.)

Example:

"ERC721"

​
url
string
required

Full-resolution image URL of the NFT

Example:

"https://img.reservoir.tools/images/v2/mainnet/i9YO%2F4yHXUdJsWcTqhqvf%2BytcG2XMhnD4zz%2BhMYH9%2FZK%2FhVtu%2B3gYAAVBBdL1dsMoZPY79XY4AQ%2FN91VDNlxaLilzKrcVKu%2FcHUBfdHr%2BSM%3D"

​
lastSaleDate
string<date-time>

Date of the last sale transaction for this NFT

Example:

"2024-01-15T10:30:00.000Z"

​
lastSalePrice
number

Price of the last sale transaction for this NFT

Example:

15.75

​
listSource
object

Source platform where the NFT is currently listed

Example:

"opensea"

​
listPrice
number

Current listing price of the NFT if it is for sale

Example:

20.5

⌘I