OpenSea API endpoint
Returns the wallets holding one NFT plus the total owner count. ERC-721 items resolve to a single owner; ERC-1155 items can have many, each with the quantity held.
/opensea/item/{chain}/{contract_address}/{token_id}/ownersPath parameters:
chain (required): a chain identifier, e.g. ethereum. Call /api/v1/opensea/chains for the full accepted listcontract_address (required): the NFT contract addresstoken_id (required): the token id within that contractQuery parameters:
limit (optional): owners per page, 1-100, default 20cursor (optional): opaque pagination cursor taken from a previous response's next_page_cursorReturns the wallets holding the NFT plus total_owners. An ERC-721 item resolves to a single owner; an ERC-1155 item can have many, each with the quantity held. has_more reflects whether OpenSea has further owners beyond the counted set.
| Field | Filled in, of 1 checked | Values in the sample |
|---|---|---|
| quantity | 1 | 1 |
| account | 1 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| chain (path) | string | Yes | Chain identifier from /opensea/chains | ethereum | |
| contract_address (path) | string | Yes | NFT contract address | 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d | |
| token_id (path) | string | Yes | Token id within the contract | 1 | |
| limit | integer | No | Owners 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/item/ethereum/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d/1/owners?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"chain": "ethereum",
"contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
"token_id": "1",
"total_owners": 1,
"has_more": false,
"owners": [
{
"quantity": "1",
"account": {
"address": "0x46efbaedc92067e6d60e84ed6395099723252496",
"display_name": "gordongoner",
"image_url": "https://i2c.seadn.io/profiles/0x46efba.png"
}
}
],
"next_page_cursor": null
}
}Request schema
No body schema
Response schema
#/definitions/opensea.itemOwnersResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | opensea.ItemOwnersResponse | No | ||||
| data.chain | string | No | ethereum | |||
| data.contract_address | string | No | ||||
| data.has_more | boolean | No | ||||
| data.next_page_cursor | string | No | ||||
| data.owners | array | No | ||||
| data.owners[].account | opensea.Account | No | ||||
| data.owners[].account.address | string | No | 0x46efbaedc92067e6d60e84ed6395099723252496 | |||
| data.owners[].account.display_name | string | No | gordongoner | |||
| data.owners[].account.image_url | string | No | ||||
| data.owners[].quantity | string | No | 1 | |||
| data.token_id | string | No | 1 | |||
| data.total_owners | integer | No | 1 | |||
| 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/item/ethereum/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d/1/owners?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"