v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
NFT API

Get tokens from a collection

/v4/data/collections

20 credits per API call

> 📘 **Note for v3 API users:** > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/collections. Users can refer to GET /v4/data/collections for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version.

Get all NFTs (ERC-721 and ERC-1155) and multitokens (ERC-1155 only) of your favorite collections! Our API lets you search for all tokens on:

  • Ethereum - ethereum-mainnet / ethereum-sepolia
  • Base - base-mainnet / base-sepolia
  • Arbitrum - arb-one-mainnet / arb-testnet
  • BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet
  • Polygon - polygon-mainnet / polygon-amoy
  • Optimism - optimism-mainnet / optimism-testnet
  • Berachain - berachain-mainnet
  • Unichain - unichain-mainnet / unichain-sepolia
  • Monad - monad-testnet
  • Celo - celo-mainnet / celo-testnet
  • Chiliz - chiliz-mainnet
  • Tezos - tezos-mainnet
  • Avalanche - avax-mainnet / avax-testnet
  • Gnosis - gno-mainnet / gno-testnet
  • zkSync - zksync-mainnet / zksync-testnet
  • Rootstock - rsk-mainnet / rsk-testnet

To get started:

  • Provide a chain name and comma-separated list of collection addresses. Our API will return relevant information about each token, including its name, description, image, and more.
  • Aside from relevant information about each token, the response also contains metadata (they can, however, be excluded by setting excludeMetadata to true).
  • If not specified, the API returns results for all supported types of tokens (nft, multitokens), but you can also choose to filter only one tokenType.
  • For Tezos blockchain query parameters excludeMetadata and tokenType won't have any effect on filtering data.
get/v4/data/collections

Query parameters

chain'ethereum-mainnet' | 'ethereum-sepolia' | 'base-mainnet' | 'base-sepolia' | 'arb-one-mainnet' | 'arb-testnet' | 'bsc-mainnet' | 'bsc-testnet' | 'polygon-mainnet' | 'optimism-mainnet' | 'optimism-testnet' | 'berachain-mainnet' | 'unichain-mainnet' | 'unichain-sepolia' | 'monad-testnet' | 'celo-mainnet' | 'celo-testnet' | 'chiliz-mainnet' | 'tezos-mainnet' | 'avax-mainnet' | 'avax-testnet' | 'gno-mainnet' | 'gno-testnet' | 'zksync-mainnet' | 'zksync-testnet' | 'rsk-mainnet' | 'rsk-testnet' required
Example:ethereum-mainnet

The blockchain to work with.

collectionAddressesstring required

Contract address of the token.

Example:0xba30E5F9Bb24caa003E9f2f0497Ad287FDF95623

The blockchain addresses of the collections. It is possible to enter list of up to 10 addresses as a comma separated string.

tokenTypes'nft' | 'multitoken'
Example:nft

The option to select only specific token types. It is possible to enter list of multiple types as a comma separated string. Use nft (includes ERC-721 and ERC-1155) or multitoken (ERC-1155 only).

excludeMetadataboolean

The option to exclude metadata from the response.

pageSizenumber
Example:10

The number of items per page (default is 50).

offsetnumber

The offset to obtain next page of the data.

Response

OK

Example response

[
  {
    "chain": "ethereum",
    "tokenId": "3",
    "tokenAddress": "0xba30E5F9Bb24caa003E9f2f0497Ad287FDF95623",
    "tokenType": "nft",
    "metadataURI": "ipfs://QmTDcCdt3yb6mZitzWBmQr65AW6Wska295Dg9nbEYpSUDR/3",
    "metadata": {
      "image": "ipfs://QmamEqaaVttv9AvfgM4Wa7d9Ettonep1NBQSDCtM7THUSX",
      "attributes": [
        {
          "trait_type": "Background",
          "value": "Club Exterior"
        },
        {
          "trait_type": "Fur",
          "value": "Radioactive"
        },
        {
          "trait_type": "Back",
          "value": "Beer Kegs"
        },
        {
          "trait_type": "Mouth",
          "value": "Goofball"
        },
        {
          "trait_type": "Eyes",
          "value": "Closed"
        }
      ]
    }
  }
]