OpenSea API endpoint
Returns the rarest items in a collection that currently have a standing listing, each with its rarity rank, traits, and asking price. Unlike the trait endpoints, this shelf is scoped to what is actually buyable right now.
/opensea/collection/{slug}/rarest-itemsPath parameters:
slug (required): the OpenSea collection slug, e.g. boredapeyachtclubThe shelf is a fixed-size snapshot and is not paginated.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| token_id | 20 | |
| name | 20 | “#73” and 19 other values |
| image_url | 20 | i2c.seadn.io |
| contract_address | 20 | |
| chain | 20 | ethereum in all 20 |
| rarity_rank | 20 | 5 to 664, median 374 |
| traits | 20 | median 7 entries |
| best_listing | 20 | |
| last_sale | 16 | |
| marketplace | 20 | opensea (19), blur (1) |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | OpenSea collection slug | boredapeyachtclub | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/opensea/collection/boredapeyachtclub/rarest-items" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"slug": "boredapeyachtclub",
"shelf": "rarest_items",
"items": [
{
"id": "5a1d9b8101cf3a2e8c8ce2d2e5a8e2ba",
"token_id": "73",
"name": "#73",
"image_url": "https://i2c.seadn.io/ethereum/abc.png",
"contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"chain": "ethereum",
"rarity_rank": 5,
"traits": [
{
"trait_type": "Fur",
"value": "Solid Gold"
}
],
"best_listing": {
"amount": 180,
"currency": "ETH",
"usd": 442290
},
"marketplace": "opensea"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/opensea.itemsShelfResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | opensea.CollectionItemsShelfResponse | No | ||||
| data.items | array | No | Item record, 39 fields: best_listing, best_offer, chain, collection_name, collection_slug, contract_address, created_at, description, id, image_url, is_fungible, last_sale and 7 more. Described under Get a single OpenSea NFT API. | |||
| data.shelf | string | No | best_deals | |||
| data.slug | string | No | boredapeyachtclub | |||
| 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/rarest-items" \
-H "x-api-key: $CRAWLORA_API_KEY"