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
: metadatacollection
.image_url
: the image associated with a collectioncollection
.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.