API Reference

Sales & Transfers by Contract

get
https://api.simplehash.xyz/api/v0/nfts/transfers//
This endpoint is commonly used to pass an NFT contract address to get back a list of its historical transfers:
Pass a specific chain and contract address, and get back a list of associated transfers
To understand more about the difference between Collections and Contracts, please refer to our FAQ
On Solana, this endpoint will function identically to Transfers by NFT
Path Params
string
enum
required
Defaults to ethereum

Name of the chain

string
required
Defaults to 0x582048c4077a34e7c3799962f1f8c5342a3f4b12

Address of the NFT contract

Query Params
string
enum

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

Allowed:
int32

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

int32

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

int32

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

int32

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

string
enum

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

Allowed:
string
enum

Exclude transfers where from_address_id == to_address_id

Allowed:
string
enum

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

Allowed:
string

Used to retrieve the next page of results

string
enum
Defaults to timestamp_desc

Available values are timestamp_desc (default) or timestamp_asc

Allowed:
int32
Defaults to 50

Limit. Defaults to 50, capped at 50.

Responses

Updated over 2 years ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated over 2 years ago