Endpoint Playground

Try the OpenSea NFT Listings API

Test Crawlora's OpenSea NFT Listings API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /opensea/item/{chain}/{contract_address}/{token_id}/listings
Platform: OpenSea
Auth: apiKey
Credits: 2 credits/request
Required params: chain, contract_address, token_id
Common optional params: limit, cursor, sort_direction

OpenSea NFT Listings API documentation OpenSea platform page Crawlora API pricing Try OpenSea Marketplace Activity API Try List OpenSea's browse categories API Try List the chains OpenSea indexes API Try Get an OpenSea collection API Try OpenSea Collection Activity API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/opensea/item/<chain>/<contract_address>/<token_id>/listings?sort_direction=ASC" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
chain (path)	string	Yes		Chain identifier from /opensea/chains
contract_address (path)	string	Yes		NFT contract address
token_id (path)	string	Yes		Token id within the contract
limit	integer	No		Listings per page, 1-100
cursor	string	No		Opaque pagination cursor from a previous next_page_cursor
sort_direction	string	No	ASC	Sort direction by price

Example JSON response

{
  "code": 200,
  "data": {
    "chain": "ethereum",
    "contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "next_page_cursor": "sample",
    "orders": [
      {
        "end_time": "sample",
        "id": "sample-id",
        "maker": {
          "address": "0x46efbaedc92067e6d60e84ed6395099723252496",
          "display_name": "gordongoner",
          "image_url": "https://example.com/resource"
        },
        "marketplace": "opensea",
        "price": {
          "amount": 7.85,
          "chain": "ethereum",
          "contract_address": "0x0000000000000000000000000000000000000000",
          "currency": "ETH",
          "usd": 19295.3
        },
        "quantity": "1",
        "start_time": "sample"
      }
    ],
    "token_id": "1"
  },
  "msg": "OK"
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestopensea.itemOrdersResponseDocOpenSea

GET /opensea/item/{chain}/{contract_address}/{token_id}/listings

List standing listings for an OpenSea NFT

Returns every standing sell order for one NFT, with price, quantity, validity window, marketplace, and the maker's wallet. An item with no active listings returns an empty list rather than a 404.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Path parameters

chain

requiredstring

Chain identifier from /opensea/chainscontract_address

requiredstring

NFT contract addresstoken_id

requiredstring

Token id within the contract

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "data": {
    "chain": "ethereum",
    "contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "next_page_cursor": "sample",
    "orders": [
      {
        "end_time": "sample",
        "id": "sample-id",
        "maker": {
          "address": "0x46efbaedc92067e6d60e84ed6395099723252496",
          "display_name": "gordongoner",
          "image_url": "https://example.com/resource"
        },
        "marketplace": "opensea",
        "price": {
          "amount": 7.85,
          "chain": "ethereum",
          "contract_address": "0x0000000000000000000000000000000000000000",
          "currency": "ETH",
          "usd": 19295.3
        },
        "quantity": "1",
        "start_time": "sample"
      }
    ],
    "token_id": "1"
  },
  "msg": "OK"
}

Endpoint details

Returns every standing sell order for one NFT, with price, quantity, validity window, marketplace, and the maker's wallet. An item with no active listings returns an empty list rather than a 404.

Method: GET
Path: /opensea/item/{chain}/{contract_address}/{token_id}/listings
Authentication: apiKey
Credit cost: 2 credits/request
Platform: OpenSea
Parameters: 7 documented fields

Request parameters

chain:pathcontract_address:pathtoken_id:pathlimit:querycursor:querysort_direction:queryx-api-key:header

Response schema fields

codedatadata.chaindata.contract_addressdata.next_page_cursordata.ordersdata.orders[].end_timedata.orders[].iddata.orders[].makerdata.orders[].maker.addressdata.orders[].maker.display_namedata.orders[].maker.image_url

Sample response summary

{
  "code": 200,
  "data": {
    "chain": "ethereum",
    "contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "next_page_cursor": "sample",
    "orders": [
      {
        "end_time": "sample",
        "id": "sample-id",
        "maker": {
          "address": "0x46efbaedc92067e6d60e84ed6395099723252496",
          "display_name": "gordongoner",
          "image_url": "https://example.com/resource"
        },
        "marketplace": "opensea",
        "price": {
          "amount": 7.85,
          "chain": "ethereum",
          "contract_address": "0x0000000000000000000000000000000000000000",
          "currency": "ETH",
          "usd": 19295.3
        },
        "quantity": "1",
        "start_time": "sample"
      }
    ],
    "token_id": "1"
  },
  "msg": "OK"
}

cURL example

curl "https://api.crawlora.net/api/v1/opensea/item/<chain>/<contract_address>/<token_id>/listings" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing List marketplace-wide OpenSea activity List OpenSea's browse categories List the chains OpenSea indexes Get an OpenSea collection List an OpenSea collection's marketplace activity

Endpoint Playground

Try the OpenSea NFT Listings API

Endpoint facts

Method: GET
API path: /opensea/item/{chain}/{contract_address}/{token_id}/listings
Platform: OpenSea
Auth: apiKey
Credits: 2 credits/request
Required params: chain, contract_address, token_id
Common optional params: limit, cursor, sort_direction

Prefilled cURL

curl "https://api.crawlora.net/api/v1/opensea/item/<chain>/<contract_address>/<token_id>/listings?sort_direction=ASC" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
chain (path)	string	Yes		Chain identifier from /opensea/chains
contract_address (path)	string	Yes		NFT contract address
token_id (path)	string	Yes		Token id within the contract
limit	integer	No		Listings per page, 1-100
cursor	string	No		Opaque pagination cursor from a previous next_page_cursor
sort_direction	string	No	ASC	Sort direction by price

Example JSON response

{
  "code": 200,
  "data": {
    "chain": "ethereum",
    "contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "next_page_cursor": "sample",
    "orders": [
      {
        "end_time": "sample",
        "id": "sample-id",
        "maker": {
          "address": "0x46efbaedc92067e6d60e84ed6395099723252496",
          "display_name": "gordongoner",
          "image_url": "https://example.com/resource"
        },
        "marketplace": "opensea",
        "price": {
          "amount": 7.85,
          "chain": "ethereum",
          "contract_address": "0x0000000000000000000000000000000000000000",
          "currency": "ETH",
          "usd": 19295.3
        },
        "quantity": "1",
        "start_time": "sample"
      }
    ],
    "token_id": "1"
  },
  "msg": "OK"
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestopensea.itemOrdersResponseDocOpenSea

GET /opensea/item/{chain}/{contract_address}/{token_id}/listings

List standing listings for an OpenSea NFT

Returns every standing sell order for one NFT, with price, quantity, validity window, marketplace, and the maker's wallet. An item with no active listings returns an empty list rather than a 404.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Path parameters

chain

requiredstring

Chain identifier from /opensea/chainscontract_address

requiredstring

NFT contract addresstoken_id

requiredstring

Token id within the contract

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "data": {
    "chain": "ethereum",
    "contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "next_page_cursor": "sample",
    "orders": [
      {
        "end_time": "sample",
        "id": "sample-id",
        "maker": {
          "address": "0x46efbaedc92067e6d60e84ed6395099723252496",
          "display_name": "gordongoner",
          "image_url": "https://example.com/resource"
        },
        "marketplace": "opensea",
        "price": {
          "amount": 7.85,
          "chain": "ethereum",
          "contract_address": "0x0000000000000000000000000000000000000000",
          "currency": "ETH",
          "usd": 19295.3
        },
        "quantity": "1",
        "start_time": "sample"
      }
    ],
    "token_id": "1"
  },
  "msg": "OK"
}

Endpoint details

Returns every standing sell order for one NFT, with price, quantity, validity window, marketplace, and the maker's wallet. An item with no active listings returns an empty list rather than a 404.

Method: GET
Path: /opensea/item/{chain}/{contract_address}/{token_id}/listings
Authentication: apiKey
Credit cost: 2 credits/request
Platform: OpenSea
Parameters: 7 documented fields

Request parameters

chain:pathcontract_address:pathtoken_id:pathlimit:querycursor:querysort_direction:queryx-api-key:header

Response schema fields

Sample response summary

{
  "code": 200,
  "data": {
    "chain": "ethereum",
    "contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "next_page_cursor": "sample",
    "orders": [
      {
        "end_time": "sample",
        "id": "sample-id",
        "maker": {
          "address": "0x46efbaedc92067e6d60e84ed6395099723252496",
          "display_name": "gordongoner",
          "image_url": "https://example.com/resource"
        },
        "marketplace": "opensea",
        "price": {
          "amount": 7.85,
          "chain": "ethereum",
          "contract_address": "0x0000000000000000000000000000000000000000",
          "currency": "ETH",
          "usd": 19295.3
        },
        "quantity": "1",
        "start_time": "sample"
      }
    ],
    "token_id": "1"
  },
  "msg": "OK"
}

cURL example

curl "https://api.crawlora.net/api/v1/opensea/item/<chain>/<contract_address>/<token_id>/listings" \
  -H "x-api-key: $CRAWLORA_API_KEY"