Skip To Content

Blockdaemon Documentation

GET NFT Collection by ID

GET NFT Collection by ID (V1)
Path Parameters
Example Queries
Example Response


GET NFT Collection by ID (V1)

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

Returns information about an NFT collection by a given collection ID.

Developer documentation: GET NFT Collection by ID (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

It is also required to specify a collection ID as the last path parameter, e.g.:

  • 86c152df-55e6-562d-a868-51cc72771efb

Example Queries

The following query provides a useful example for GET NFT Collection by ID (V1).

To get a collection in the Ethereum Mainnet network, use:

https://ubiquity.api.blockdaemon.com/v1/nft/ethereum/mainnet/collection/86c152df-55e6-562d-a868-51cc72771efb

See also: How to Get a Collection by ID


Example Response

The following is a typical response from GET NFT Collection by ID (V1):

{
    "collection": {
        "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"
        }
    }
}

Notes:

  • One collection can include multiple contracts, so the collection.contracts field returns an array.
  • For the top 100 popular collections, this endpoint additionally returns metadata and image URLs:
    • collection.meta: metadata
    • collection.image_url: the image associated with a collection
    • collection.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.