Listing Events by NFT

get

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

This endpoint is used to retrieve listing events (listing added, modified, removed) in reverse chronological order. This endpoint is currently in beta.

Pass a chain, contract address, token ID, and optional UNIX timestamps to get back listing events for this contract. Note that data is available starting from April 10, 2023, and that OpenSea lazy minted items are included as well (on Ethereum & Polygon).

On Solana, only the chain and contract address should be supplied

Path Params

chain

string

enum

required

Defaults to ethereum

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

contract_address

string

required

Defaults to 0x60e4d786628fea6478f785a6d7e704777c86a7c6

Address of the NFT contract

token_id

string

required

Defaults to 20035

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

Query Params

from_timestamp

int32

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

to_timestamp

int32

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

cursor

string

Used to retrieve the next page of results

limit

int32

Defaults to 50

Limit. Defaults to 50, capped at 50.

Responses

200200

400400

401401

403403