OpenSea API endpoint
Returns public marketplace metadata and trading statistics for one NFT collection: name, description, imagery, verification flag, contract address and chain, social links, current floor price and top collection offer, plus lifetime and rolling one-hour/one-day/seven-day/thirty-day sales, volume, and floor-price change. Delisted and blacklisted collections return 404 rather than an empty payload.
/opensea/collection/{slug}Path parameters:
slug (required): the OpenSea collection slug, e.g. boredapeyachtclubPrices carry both the settlement token amount (amount + currency) and a USD conversion. Delisted and blacklisted collections return 404 rather than an empty payload, so a missing collection is distinguishable from one with no data.
| Field | In the sample | Value in the sample |
|---|---|---|
| id | Has a value | |
| slug | Has a value | |
| name | Has a value | “Bored Ape Yacht Club” |
| description | Has a value | 451 characters |
| category | Has a value | “PFPS” |
| image_url | Has a value | i2c.seadn.io |
| banner_image_url | Has a value | i2c.seadn.io |
| is_verified | Has a value | true |
| contract_address | Has a value | |
| chain | Has a value | “ethereum” |
| created_at | Has a value | 2021-04-22 |
| external_url | Has a value | boredapeyachtclub.com |
| twitter_username | Has a value | |
| discord_url | Has a value | discord.gg |
| floor_price.amount | Has a value | 5.09 |
| floor_price.currency | Has a value | “ETH” |
| floor_price.usd | Has a value | 12,757.93 |
| top_offer.amount | Has a value | 4.9 |
| top_offer.currency | Has a value | “WETH” |
| top_offer.usd | Has a value | 12,284.74 |
| stats.sales | Has a value | 57,819 |
| stats.total_supply | Has a value | 9,996 |
| stats.unique_item_count | Has a value | 9,996 |
| stats.listed_item_count | Has a value | 262 |
| stats.volume_native | Has a value | 1,583,110.89 |
| stats.volume_usd | Has a value | 3,762,768,723.59 |
| stats.volume_currency | Has a value | “ETH” |
| stats.one_hour | Has a value | |
| stats.one_day | Has a value | |
| stats.seven_days | Has a value | |
| stats.thirty_days | Has a value |
| 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" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "46188685bcac4206ace63c9d017abbb7",
"slug": "boredapeyachtclub",
"name": "Bored Ape Yacht Club",
"category": "PFPS",
"image_url": "https://i2c.seadn.io/collection/boredapeyachtclub/image/1a09c26b.png",
"is_verified": true,
"contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"chain": "ethereum",
"created_at": "2021-04-22T23:14:24.000Z",
"twitter_username": "BoredApeYC",
"floor_price": {
"amount": 7.85,
"currency": "ETH",
"usd": 19295.3
},
"top_offer": {
"amount": 7.38,
"currency": "WETH",
"usd": 18097.09
},
"stats": {
"sales": 57369,
"total_supply": 9998,
"unique_item_count": 9998,
"listed_item_count": 298,
"volume_native": 1580610.96,
"volume_usd": 3756342321.66,
"volume_currency": "ETH",
"one_hour": {
"sales": 1,
"volume_native": 8.2,
"volume_usd": 20140.5,
"floor_price_change": 0.0012
},
"one_day": {
"sales": 11,
"volume_native": 96.4,
"volume_usd": 236820.1,
"floor_price_change": 0.0065
},
"seven_days": {
"sales": 78,
"volume_native": 642.1,
"volume_usd": 1577400.2,
"floor_price_change": -0.0312
},
"thirty_days": {
"sales": 341,
"volume_native": 2810.7,
"volume_usd": 6904200.9,
"floor_price_change": 0.0841
}
}
}
}Request schema
No body schema
Response schema
#/definitions/opensea.collectionResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | opensea.Collection | No | ||||
| data.banner_image_url | string | No | ||||
| data.category | string | No | PFPS | |||
| data.chain | string | No | ethereum | |||
| data.contract_address | string | No | 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d | |||
| data.created_at | string | No | 2021-04-22T23:14:24.000Z | |||
| data.description | string | No | ||||
| data.discord_url | string | No | ||||
| data.external_url | string | No | ||||
| data.floor_price | opensea.Price | No | Price record, 5 fields: amount, chain, contract_address, currency, usd. Described under Get a single OpenSea NFT API. | |||
| data.id | string | No | 46188685bcac4206ace63c9d017abbb7 | |||
| data.image_url | string | No | ||||
| data.instagram_username | string | No | ||||
| data.is_verified | boolean | No | true | |||
| data.name | string | No | Bored Ape Yacht Club | |||
| data.slug | string | No | boredapeyachtclub | |||
| data.stats | opensea.CollectionStats | No | ||||
| data.stats.listed_item_count | integer | No | 298 | |||
| data.stats.one_day | opensea.WindowStats | No | ||||
| data.stats.one_day.floor_price_change | number | No | 0.0065 | |||
| data.stats.one_day.sales | integer | No | 42 | |||
| data.stats.one_day.volume_native | number | No | 318.4 | |||
| data.stats.one_day.volume_usd | number | No | 782344.1 | |||
| data.stats.one_hour | opensea.WindowStats | No | ||||
| data.stats.one_hour.floor_price_change | number | No | 0.0065 | |||
| data.stats.one_hour.sales | integer | No | 42 | |||
| data.stats.one_hour.volume_native | number | No | 318.4 | |||
| data.stats.one_hour.volume_usd | number | No | 782344.1 | |||
| data.stats.sales | integer | No | 57369 | |||
| data.stats.seven_days | opensea.WindowStats | No | ||||
| data.stats.seven_days.floor_price_change | number | No | 0.0065 | |||
| data.stats.seven_days.sales | integer | No | 42 | |||
| data.stats.seven_days.volume_native | number | No | 318.4 | |||
| data.stats.seven_days.volume_usd | number | No | 782344.1 | |||
| data.stats.thirty_days | opensea.WindowStats | No | ||||
| data.stats.thirty_days.floor_price_change | number | No | 0.0065 | |||
| data.stats.thirty_days.sales | integer | No | 42 | |||
| data.stats.thirty_days.volume_native | number | No | 318.4 | |||
| data.stats.thirty_days.volume_usd | number | No | 782344.1 | |||
| data.stats.total_supply | integer | No | 9998 | |||
| data.stats.unique_item_count | integer | No | 9998 | |||
| data.stats.volume_currency | string | No | ETH | |||
| data.stats.volume_native | number | No | 1580610.96 | |||
| data.stats.volume_usd | number | No | 3756342321.66 | |||
| data.top_offer | opensea.Price | No | Price record, 5 fields: amount, chain, contract_address, currency, usd. Described under Get a single OpenSea NFT API. | |||
| data.twitter_username | string | No | ||||
| 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" \
-H "x-api-key: $CRAWLORA_API_KEY"