OpenSea API endpoint
Returns a cursor-paginated page of the collection's trait types and the values each takes, with per-value item counts where OpenSea publishes them. Numeric traits carry a comparison operator.
/opensea/collection/{slug}/traitsPath parameters:
slug (required): the OpenSea collection slug, e.g. boredapeyachtclubQuery parameters:
limit (optional): trait types per page, 1-100, default 20cursor (optional): opaque pagination cursor taken from a previous response's next_page_cursor| Field | Filled in, of 7 checked | Values in the sample |
|---|---|---|
| trait_type | 7 | “Background” and 6 other values |
| values | 7 | median 23 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | OpenSea collection slug | boredapeyachtclub | |
| limit | integer | No | Trait types per page, 1-100 | ||
| cursor | string | No | Opaque pagination cursor from a previous next_page_cursor | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/opensea/collection/boredapeyachtclub/traits?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"slug": "boredapeyachtclub",
"traits": [
{
"trait_type": "Background",
"values": [
{
"value": "Gray",
"count": 1170
},
{
"value": "Orange",
"count": 1273
},
{
"value": "Aquamarine",
"count": 1266
}
]
},
{
"trait_type": "Fur",
"values": [
{
"value": "Solid Gold",
"count": 46
},
{
"value": "Brown",
"count": 1370
}
]
}
],
"next_page_cursor": "WzNd"
}
}Request schema
No body schema
Response schema
#/definitions/opensea.collectionTraitsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | opensea.CollectionTraitsResponse | No | ||||
| data.next_page_cursor | string | No | ||||
| data.slug | string | No | boredapeyachtclub | |||
| data.traits | array | No | ||||
| data.traits[].comparison_operator | string | No | ||||
| data.traits[].trait_type | string | No | Background | |||
| data.traits[].values | array | No | ||||
| data.traits[].values[].count | integer | No | 1170 | |||
| data.traits[].values[].value | string | No | Gray | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/opensea/collection/boredapeyachtclub/traits?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"