Skip to main content
GET
/
v1
/
nfts
Get list of NFTs
curl --request GET \
  --url https://api.zerion.io/v1/nfts/ \
  --header 'Authorization: Basic <encoded-value>'
{
  "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",
      "id": "<string>",
      "attributes": {
        "contract_address": "0x74ee68a33f6c9f113e22b3b77418b75f85d07d22",
        "token_id": "10",
        "interface": "erc1155",
        "metadata": {
          "name": "<string>",
          "description": "<string>",
          "tags": [
            "<string>"
          ],
          "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": {
          "prices": {
            "floor": 123
          },
          "last_sale": {
            "price": 31,
            "quantity": {
              "int": "12345678",
              "decimals": 5,
              "float": 123.45678,
              "numeric": "123.45678"
            }
          }
        },
        "external_links": [
          {
            "url": "https://www.indexcoop.com",
            "type": "website",
            "name": "Website"
          }
        ],
        "flags": {
          "is_spam": true
        }
      },
      "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": {
          "name": "<string>",
          "description": "<string>",
          "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"
            }
          },
          "payment_token_symbol": "<string>"
        },
        "implementations": [
          {
            "chain_id": "ethereum",
            "address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
          }
        ]
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

X-Env
enum<string>

Custom header that allows you to get data for testnets.

Available options:
testnet

Query Parameters

filter[references]
string

Keep only NFTs matching specified references.

Reference format is chain_id:contract_address:token_id.

References should be separated by comma ,.

chain_id- ID of the chain where NFT exists, can be found in /chains endpoint.

contract_address address of the deployed contract which NFT belongs to.

token_id id of the NFT withing specified contract_address.

NOTE: parameter currently is mandatory and can not be omitted.

Example:

"ethereum:0x932261f9fc8da46c4a22e31b45c4de60623848bf:93673,polygon:0x3d8c06e65ebf06a9d40f313a35353be06bd46038:104901"

currency
enum<string>
default:usd

Denominated currency value of returned prices

Available options:
eth,
btc,
usd,
eur,
krw,
rub,
gbp,
aud,
cad,
inr,
jpy,
nzd,
try,
zar,
cny,
chf
include
enum<string>[]

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

Available options:
nft_collections

Response

Response for requested list of NFTs

data
object[]
required
included
object[]