Active Listings by NFT

get

https://api.simplehash.xyz/api/v0/nfts/listings/{chain}/{contract_address}/{token_id}

This endpoint is commonly used to retrieve metadata of all of the active listings for a single NFT

On Solana, provide the chain and contract address, and a token ID of 0

Path Params

chain

string

enum

required

Defaults to ethereum

Name of the chain (e.g., ethereum)

contract_address

string

required

Defaults to 0x4a8c9d751eeabc5521a68fb080dd7e72e46462af

Address of the NFT contract

token_id

string

required

Defaults to 513

Token ID of the given NFT. For Solana and Bitcoin, this can be omitted or set to 0.

Query Params

include_nft_details

string

enum

Include the associated NFT details for the listing within the response (pass include_nft_details=1)

Allowed:

marketplaces

string

Marketplace IDs, comma separated for mulitple values (e.g., opensea, x2y2). Allowed values: opensea, blur, x2y2, looksrare, tensor, cryptopunks

from_timestamp

int32

Lower bound listing timestamp (inclusive). Seconds since the Unix epoch.

to_timestamp

int32

Upper bound listing timestamp (inclusive). Seconds since the Unix epoch.

count

string

Include the total distinct count of Listings in the response (pass count=1)

cursor

string

Used to retrieve the next page of results

order_by

string

enum

Defaults to listing_timestamp_desc

Available values are: listing_timestamp_desc (default), listing_timestamp_asc, price_asc, or price_desc

Allowed:

limit

int32

Defaults to 50

Limit. Defaults to 50, capped at 50.

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400

401401

403403