Sales & Transfers by NFT

get

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

This endpoint is commonly used to pass a single specific NFT to get back a list of its historical transfers:

Pass a specific chain, contract address and token ID, and get back a list of associated transfers

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

Path Params

chain

string

enum

required

Defaults to ethereum

Name of the chain

contract_address

string

required

Defaults to 0x60e4d786628fea6478f785a6d7e704777c86a7c6

Address of the NFT contract

token_id

string

required

Defaults to 8999

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 transfer within the response (pass include_nft_details=1)

Allowed:

from_timestamp

int32

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

to_timestamp

int32

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

from_block

int32

Lower bound block_number (inclusive). The from_timestamp param takes precedence if both from_timestamp and from_block are specified.

to_block

int32

Upper bound block_number (inclusive). The to_timestamp param takes precedence if both to_timestamp and to_block are specified.

include_lazy_mints

string

enum

Include lazy mint events alongside the on-chain activity. Only applies to the OpenSea shared contracts (ethereum.0x495f947276749ce646f68ac8c248420045cb7b5e and polygon.0x2953399124f0cbb46d2cbacd8a89cf0599974963)

Allowed:

exclude_self_transfers

string

enum

Exclude transfers where from_address_id == to_address_id

Allowed:

only_sales

string

enum

Filter results for only records with sales information (pass only_sales=1)

Allowed:

cursor

string

Used to retrieve the next page of results

order_by

string

enum

Defaults to timestamp_desc

Available values are timestamp_desc (default) or timestamp_asc

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