v1

latestOpenAPI 3.0.32026-07-2639188178.2 KB

nfts

Get single NFT by ID

This endpoint returns single NFT by its unique identifier.

This endpoint supports testnets. To get data for testnets use X-Env header.

get/v1/nfts/{nft_id}

Path parameters

nft_idstring required

NFT unique identifier

Query parameters

currency'eth' | 'btc' | 'usd' | 'eur' | 'krw' | 'rub' | 'gbp' | 'aud' | 'cad' | 'inr' | 'jpy' | 'nzd' | 'try' | 'zar' | 'cny' | 'chf'

Denominated currency value of returned prices

includestring[]

Array of related resources to be included to the response (comma-separated list). This parameter corresponds to the JSON API schema.

[
  "nft_collections"
]

Headers

X-Env'testnet'

Custom header that allows you to get data for testnets.

Response

Requested NFT

Example response

{
  "links": {
    "self": "https://api.zerion.io/v1/nfts/polygon:0x3a422450db73c450310e6e24191d4221a5be81b1:2/?currency=usd&include=nft_collections"
  },
  "data": {
    "type": "nfts",
    "attributes": {
      "contract_address": "0x74ee68a33f6c9f113e22b3b77418b75f85d07d22",
      "token_id": "10",
      "interface": "erc1155",
      "metadata": {
        "content": {
          "preview": {
            "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
            "content_type": "image/png"
          },
          "detail": {
            "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
            "content_type": "image/png"
          },
          "audio": {
            "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
            "content_type": "image/png"
          },
          "video": {
            "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
            "content_type": "image/png"
          }
        },
        "attributes": [
          {
            "key": "Rarity",
            "value": "common"
          }
        ]
      },
      "market_data": {
        "last_sale": {
          "price": 31,
          "quantity": {
            "int": "12345678",
            "decimals": 5,
            "float": 123.45678,
            "numeric": "123.45678"
          }
        }
      },
      "external_links": [
        {
          "type": "website",
          "name": "Website",
          "url": "https://www.indexcoop.com"
        }
      ]
    },
    "relationships": {
      "chain": {
        "links": {
          "related": "https://api.zerion.io/v1/chains/polygon"
        },
        "data": {
          "type": "chains",
          "id": "polygon"
        }
      },
      "nft_collection": {
        "data": {
          "type": "nft_collections",
          "id": 14
        }
      }
    }
  },
  "included": [
    {
      "type": "nft_collections",
      "id": 14,
      "attributes": {
        "metadata": {
          "content": {
            "icon": {
              "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
            },
            "banner": {
              "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
              "content_type": "image/png"
            }
          }
        },
        "implementations": [
          {
            "chain_id": "ethereum",
            "address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
          }
        ]
      }
    }
  ]
}