How to Get a Subcollection

Some collections, e.g. Art Blocks, contain subcollections. This tutorial explains the steps involved in getting a subcollection of a given parent collection in Ethereum Mainnet.

Step 1. Use the collections or collections search endpoint to find a parent collection.

For example, you can follow these steps: How to Get a Collection by Name

Step 2. Copy a collection ID from the id field:

{
    "id": "d4d662da-d02a-5ae1-9e79-783c5abe020f",
    "name": "Art Blocks",
    ...more properties...
}

Step 3. Use the collection endpoint with the following details:

• protocol: ethereum

• network: mainnet

• collection ID: d4d662da-d02a-5ae1-9e79-783c5abe020f (copied in the previous step)

  https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/collection/d4d662da-d02a-5ae1-9e79-783c5abe020f
  

Step 4. Execute the query.

For example, in cURL, you should run the following code:

curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/collection/d4d662da-d02a-5ae1-9e79-783c5abe020f' -H 'Authorization: Bearer YOUR_API_KEY'

📘

Note!

To authorize your request, you need to get an API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide

Step 5. Copy a subcollection id from the sub_collection section:

{
    "collection": {
        "id": "d4d662da-d02a-5ae1-9e79-783c5abe020f",
        "name": "Art Blocks",
        "description": "Art Blocks is leading a new generation of art. Hosting projects from today’s most innovative digital artists, our platform combines creative coding with blockchain technology to establish a new paradigm for the creation and ownership of art.",
        "logo": "collection/d4d662da-d02a-5ae1-9e79-783c5abe020f/logo.png",
        "banner": "",
        "verified": true,
        "contracts": [],
        "meta": {},
        "sub_collection": [
            {
                "id": "937538b7-9d37-526c-aa41-0a6af53e1b73",
                "name": "Art Blocks Curated"
            },
            { ...more subcollections... }
        ]
    }
}

Step 6. Use the collection endpoint with the following details:

• protocol: ethereum

• network: mainnet

• collection ID: 937538b7-9d37-526c-aa41-0a6af53e1b73 (copied in the previous step)

  https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/collection/937538b7-9d37-526c-aa41-0a6af53e1b73
  

Step 7. Execute the query.

For example, in cURL, you should run the following code:

curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/collection/937538b7-9d37-526c-aa41-0a6af53e1b73' -H 'Authorization: Bearer YOUR_API_KEY'

📘

Note!

To authorize your request, you need to get an API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide

Step 8. Get the response.

Some subcollections contain their own subcollections, which can be retrieved with the same endpoint. See the sub_collection section in the example below. Also, please note that the parent_id field contains the ID of the parent collection.

{
    "collection": {
        "id": "937538b7-9d37-526c-aa41-0a6af53e1b73",
        "name": "Art Blocks Curated",
        "description": "The Curated Collection includes projects that have been selected by Art Blocks’ Curation Board for their world-class innovation, technical rigor, and aesthetic beauty.",
        "logo": "",
        "banner": "",
        "verified": false,
        "contracts": [],
        "meta": null,
        "parent_id": "d4d662da-d02a-5ae1-9e79-783c5abe020f",
        "sub_collection": [
            {
                "id": "e2ff882b-4218-5011-86d5-e0251ec99049",
                "name": "Sudfah by Melissa Wiederrecht"
            },
            { ...more subcollections... }
        ]
    }
}

👋 Need Help?

Contact us through email or our support page for any issues, bugs, or assistance you may need.