ZEzerion
nfts

Get list of NFTs

Returns a list of NFTs matching the references you pass. Both ERC-721 and ERC-1155 are covered.

See also: Testnets (X-Env: testnet) · Resource IDs

get/v1/nfts/

Request

  • Base URL
    https://api.zerion.io
  • URL
    https://api.zerion.io/v1/nfts/
  • Auth
    HTTP basic

Query parameters

filter[references]string
Example:ethereum:0x932261f9fc8da46c4a22e31b45c4de60623848bf:93673,polygon:0x3d8c06e65ebf06a9d40f313a35353be06bd46038:104901

Keep only NFTs matching these references (comma-separated list). This parameter is currently required.

Each reference is chain_id:contract_address:token_id:

  • chain_id - the chain the NFT is on, as listed by GET /v1/chains/.
  • contract_address - the contract the NFT belongs to.
  • token_id - the NFT's ID within that contract.
currency'eth' | 'btc' | 'usd' | 'eur' | 'krw' | 'rub' | 'gbp' | 'aud' | 'cad' | 'inr' | 'jpy' | 'nzd' | 'try' | 'zar' | 'cny' | 'chf'

Denominated currency value of returned prices

includestring[]

Related resources to include in the response (comma-separated list), following the JSON:API include convention.

[
  "nft_collections"
]

Headers

X-Env'testnet'

Set to testnet to return testnet data instead of mainnet.

Response

Response for requested list of NFTs

Example response

{
  "links": {
    "self": "https://api.zerion.io/v1/nfts/?currency=usd&filter%5Breferences%5D=ethereum%3A0x909899c5dbb5002610dd8543b6f638be56e3b17e%3A57896044618658097711785492504343953928676686534345912800509039648547174119787%2Cpolygon%3A0x3a422450db73c450310e6e24191d4221a5be81b1%3A30&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"
          }
        ]
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 3 revisions of this API.