Just released: A Traits API on Center.dev

All users now have full access to our Traits API.

By Center 4 min read

We are excited to announce that we have now opened our Traits API to all users.

Builders can use this API to:

Check out a few examples below, or reach out to our support team with any questions.

Demo: Get traits of assets in a collection

Note: This demo returns the third trait set for BAYC (”Earring”) only. To return all traits, the user should not include an offset or limit in the query.

Request:

<https://api.center.dev/v1/ethereum-mainnet/>
0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/traits?offset=2&limit=1

Response:

{
  "items": [
    {
      "trait": "Earring",
      "values": [
        {
          "value": "Cross",
          "count": 149
        },
        {
          "value": "Diamond Stud",
          "count": 222
        },
        {
          "value": "Gold Hoop",
          "count": 462
        },
        {
          "value": "Gold Stud",
          "count": 439
        },
        {
          "value": "Silver Hoop",
          "count": 882
        },
        {
          "value": "Silver Stud",
          "count": 823
        }
      ],
      "totalValues": 6
    }
  ],
  "offset": 2,
  "limit": 1,
  "onLastPage": false
}

Demo: Get attribute values for a specific trait

Note: This demo returns the distribution of attributes for “Background” within BAYC.

Request:

<https://api.center.dev/v1/ethereum-mainnet/>
0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/traits/Background

Response:

{
  "items": [
    {
      "value": "Aquamarine",
      "count": 1266
    },
    {
      "value": "Army Green",
      "count": 1243
    },
    {
      "value": "Blue",
      "count": 1242
    },
    {
      "value": "Gray",
      "count": 1170
    },
    {
      "value": "New Punk Blue",
      "count": 1232
    },
    {
      "value": "Orange",
      "count": 1273
    },
    {
      "value": "Purple",
      "count": 1291
    },
    {
      "value": "Yellow",
      "count": 1283
    }
  ],
  "offset": 0,
  "limit": 10,
  "onLastPage": true
}

Demo: Search for assets within a collection that have certain traits

Note: This demo searches for all assets within BAYC that have either “Army Green” or “Blue” backgrounds. The demo limits search results to 2 for readability.

Request:

curl --request POST \\
     --url '<https://api.center.dev/v1/ethereum-mainnet/0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/assets/searchByTraits?limit=2>' \\
     --header 'accept: application/json' \\
     --header 'content-type: application/json' \\
     --data '
{
     "query": {
          "Background": [
               "Army Green",
               "Blue"
          ]
     }
}
'

Response:

{
"items": [
{
"address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
"collection_name": "BoredApeYachtClub",
"token_id": "4",
"url": "[<https://center.app/collections/0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/4>](<https://center.app/collections/0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/4>)",
"name": "4",
"metadata": {
"attributes": [
{
"trait_type": "Clothes",
"value": "Navy Striped Tee"
},
{
"trait_type": "Mouth",
"value": "Phoneme L"
},
{
"trait_type": "Hat",
"value": "Party Hat 2"
},
{
"trait_type": "Fur",
"value": "Golden Brown"
},
{
"trait_type": "Eyes",
"value": "Closed"
},
{
"trait_type": "Background",
"value": "Blue"
}
],
"image": "ipfs://QmSg9bPzW9anFYc3wWU5KnvymwkxQTpmqcRSfYj7UmiBa7"
},
"small_preview_image_url": "[<https://cdn.center.app/v2/1/c514264780694729a9951793357abfa6ac1b90f411f09545265e44d2f84502fd/f62d940a8472a403c4ed64c076d087ec09c0d40e2fd9320e2c8f7aa7fd44ebfb.png>](<https://cdn.center.app/v2/1/c514264780694729a9951793357abfa6ac1b90f411f09545265e44d2f84502fd/f62d940a8472a403c4ed64c076d087ec09c0d40e2fd9320e2c8f7aa7fd44ebfb.png>)"
},
{
"address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
"collection_name": "BoredApeYachtClub",
"token_id": "5",
"url": "[<https://center.app/collections/0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/5>](<https://center.app/collections/0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/5>)",
"name": "5",
"metadata": {
"attributes": [
{
"trait_type": "Hat",
"value": "Bayc Flipped Brim"
},
{
"trait_type": "Eyes",
"value": "X Eyes"
},
{
"trait_type": "Fur",
"value": "Brown"
},
{
"trait_type": "Background",
"value": "Army Green"
},
{
"trait_type": "Clothes",
"value": "Bayc T Red"
},
{
"trait_type": "Mouth",
"value": "Dumbfounded"
}
],
"image": "ipfs://QmNwbd7ctEhGpVkP8nZvBBQfiNeFKRdxftJAxxEdkUKLcQ"
},
"small_preview_image_url": "[<https://cdn.center.app/v2/1/0ecc27df7a7d70161144ab9e4cd27f6b134235916b7d809fba455c02e10a577d/cd693370545ba79f717eb836d4c375f424adddee9698d7b9a51047cc0b2385d0.png>](<https://cdn.center.app/v2/1/0ecc27df7a7d70161144ab9e4cd27f6b134235916b7d809fba455c02e10a577d/cd693370545ba79f717eb836d4c375f424adddee9698d7b9a51047cc0b2385d0.png>)"
}
],
"offset": 0,
"limit": 2,
"onLastPage": false
}

Other requests or ideas? Please submit a feature request or reach out to our support team.

Get started

If you haven’t started building yet, what are you waiting for?

About Center

https://storage.googleapis.com/center-inc-blog-media/public/media/2022-07-09-one.png

Center is a multi-chain, high-performance NFT API designed with speed and developer productivity in mind. Our seasoned team has working experience at Coinbase, WhatsApp, Facebook, Google, Square and Paradigm. We’ve led teams and built products where scalability, performance, and security are paramount — and we bring that mindset to everything we build.

To date, Center has indexed over 150TB of NFTs across 14 chains. We offer a a 99.999% uptime SLA and support users ranging from individual hackers to large enterprises.

Our APIs also power center.app, an NFT search engine that we are building. We encourage you to check it out!

What is an NFT API?

https://storage.googleapis.com/center-inc-blog-media/public/media/2022-07-09-api.jpg

Building NFT-related applications from scratch is complicated. It might require indexing multiple chains, ingesting vast quantities of data, and meticulously building low-level infrastructure to ensure all of the data is processed correctly. This could take engineers months to get right before they even start building an application.

Our APIs allow builders to abstract away this complexity and focus on building useful products for end users right away— we take care of the infrastructure and low-level technical details. With just a few lines of code, builders can use our APIs for a range of use cases including NFT rendering, search and data retrieval.

Our Investors

https://storage.googleapis.com/center-inc-blog-media/public/media/2022-07-09-one.png

Our Team

https://storage.googleapis.com/center-inc-blog-media/public/media/2022-07-09-two.png