Skip To Content

Blockdaemon Documentation

GET All NFT Collections

GET All NFT Collections (V1)
Path Parameters
Query Parameters
Example Queries
Example Response


GET All NFT Collections (V1)

https://ubiquity.api.blockdaemon.com/v1/nft/{protocol}/{network}/collections

Returns all NFT collections in the network.

Developer documentation: GET All NFT Collections (V1)

Notes:

  • To authorize your request, you need to get a Ubiquity API key and use it as a bearer token.
  • Blockdaemon collects NFT information and data from various third-party sources (“NFT Content”). We do not create, own, or control NFT Content and we do not routinely monitor NFT Content for violations of these Terms. You acknowledge that Blockdaemon has no responsibility or liability related to NFT Content and agree that you must evaluate, and decide for yourself if you wish to use any NFT Content.

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

Query Parameters

NFT API supports advanced querying options, making it easy to pinpoint the exact information you need. Use query parameters to filter, sort, and paginate the results.

To filter the results by collection name, use:

  • parameter: collection_name
  • value: e.g. Bored Ape Yacht Club

To filter the results by contract address, use:

  • parameter: contract_address
  • value: e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D

To filter the results by token type, use:

  • parameter: token_type
  • value: ERC721 / ERC1155 / ERC20 / CRYPTOPUNKS

Notes:

  • You can combine these parameters to further filter the results.
  • You can filter by multiple collection names, contract addresses, or token types. Just add multiple collection_name / contract_address / token_type parameters with different values.

To sort the results, use

  • parameter: sort_by
  • value: name

To set the sort order, use

  • parameter: order
  • value: asc / desc

To set the maximum number of collections returned on one page, use

  • parameter: page_size
  • value: 100 by default, up to 500

To get the next page, use

  • parameter: page_token
  • value: returned in the next_page_token field

Example Queries

The following queries provide useful examples for GET All NFT Collections (V1).

For more examples and details, visit NFT Tutorials: Collections.

Get All Collections

For a list of all collections in the Ethereum Mainnet network, use the following query:

https://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/collections

Get Collections Filtered by Collection Name

For a list of Ethereum Mainnet collections filtered by given collection names, use the following query:

https://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/collections?collection_name=Bored Ape Yacht Club&collection_name=CryptoPunks

Get Collections filtered by Contract Address

For a list of Ethereum Mainnet collections filtered by given contract addresses, use the following query:

https://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/collections?contract_address=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&contract_address=0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB

Get Collections filtered by Token Type

For a list of Ethereum Mainnet collections filtered by given token types (ERC-721 and ERC-1155), use the following query:

https://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/collections?token_type=ERC721&token_type=ERC1155

Get Collections Sorted by Name

For a list of Ethereum Mainnet collections sorted by name in descending order, use the following query:

https://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/collections?sort_by=name&order=desc

Example Response

The following is a typical response from GET All NFT Collections (V1):

{
    "data": [
        {
            "id": "86c152df-55e6-562d-a868-51cc72771efb",
            "name": "Bored Ape Yacht Club",
            "description": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. Your Bored Ape doubles as your Yacht Club membership card, and grants access to members-only benefits, the first of which is access to THE BATHROOM, a collaborative graffiti board. Future areas and perks can be unlocked by the community through roadmap activation. Visit www.BoredApeYachtClub.com for more details.",
            "image_url": "https://ubiquity.storage.blockdaemon.com/collection/86c152df-55e6-562d-a868-51cc72771efb/logo.png",
            "contracts": [
                {
                    "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
                    "name": "BoredApeYachtClub",
                    "symbol": "BAYC",
                    "description": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. Your Bored Ape doubles as your Yacht Club membership card, and grants access to members-only benefits, the first of which is access to THE BATHROOM, a collaborative graffiti board. Future areas and perks can be unlocked by the community through roadmap activation. Visit www.BoredApeYachtClub.com for more details.",
                    "image_url": "https://ubiquity.storage.blockdaemon.com/contract/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d/logo.png",
                    "type": "ERC721"
                }
            ],
            "meta": {
                "discord_url": "https://discord.gg/3P5K3dzgdB",
                "external_url": "http://www.boredapeyachtclub.com/",
                "instagram_username": "boredapeyachtclub",
                "twitter_username": "BoredApeYC"
            }
        },
        {...more collections...}
    ],
    "meta": {
        "paging": {
            "next_page_token": "eyJuYW1lIjoiMHhJREVOVElUSUVTIEdFTiAxIiwiaWQiOiI0YjZjNDdmNy1iMjFkLTVjN2ItYTA2OC1kZjBhNjVlMmI3NWUifQ=="
        }
    }
}

Notes:

  • One collection can include multiple contracts, so the data.contracts field returns an array.
  • For the top 100 popular collections, this endpoint additionally returns metadata and image URLs:
    • data.meta: metadata
    • data.image_url: the image associated with a collection
    • data.contracts.image_url: the image associated with a contract

    All images are stored by Blockdaemon, which allows you to quickly access them. The popularity of a collection is calculated from its total volume.

We don't support Internet Explorer

Please use Chrome, Safari, Firefox, or Edge to view this site.