Sales & Transfers by Chain

get

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

This endpoint is commonly used to get the most recent transfers on a given chain:

Pass a specific chain, and get back a list of the most recent transfers

Path Params

chain

string

enum

required

Defaults to ethereum

Name of the chain

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.

contract_addresses

string

Filter to specific contracts (e.g., 0x60e4d786628fea6478f785a6d7e704777c86a7c6), comma-separated for multiple values (e.g., 0x60e4d786628fea6478f785a6d7e704777c86a7c6,0x8a90cab2b38dba80c64b7734e58ee1db38b8992e). Maximum of 100 addresses. When this parameter is specified, a time window of <= 7 days must also be provided, using from_timestamp and to_timestamp.

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