OpenSea API endpoint
Returns the full bid/ask ladder for a collection: resting listings and offers grouped into price levels with the quantity available at each. This is the depth chart behind OpenSea's own collection page, and it is the fastest way to see how thin or deep the book is above the floor.
/opensea/collection/{slug}/depthPath parameters:
slug (required): the OpenSea collection slug, e.g. boredapeyachtclubListings ascend from the floor; offers descend from the top bid.
| Field | Filled in, of 50 checked | Values in the sample |
|---|---|---|
| quantity | 50 | 1 to 69, median 26 |
| price | 50 |
| 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/depth" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"slug": "boredapeyachtclub",
"listings": [
{
"quantity": 2,
"price": {
"amount": 7.85,
"currency": "ETH",
"usd": 19295.54
}
},
{
"quantity": 3,
"price": {
"amount": 7.8875,
"currency": "ETH",
"usd": 19387.71
}
},
{
"quantity": 4,
"price": {
"amount": 7.8876,
"currency": "ETH",
"usd": 19387.96
}
}
],
"offers": [
{
"quantity": 1,
"price": {
"amount": 7.38,
"currency": "WETH",
"usd": 18097.09
}
},
{
"quantity": 4,
"price": {
"amount": 7.2,
"currency": "WETH",
"usd": 17655.5
}
}
]
}
}Request schema
No body schema
Response schema
#/definitions/opensea.depthResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | opensea.DepthResponse | No | ||||
| data.chain | string | No | ||||
| data.contract_address | string | No | ||||
| data.listings | array | No | DepthLevel record, 7 fields: price, quantity. Described under Get an OpenSea NFT's order book API. | |||
| data.offers | array | No | DepthLevel record, 7 fields: price, quantity. Described under Get an OpenSea NFT's order book API. | |||
| data.slug | string | No | boredapeyachtclub | |||
| data.token_id | 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/depth" \
-H "x-api-key: $CRAWLORA_API_KEY"