Sales & Transfers by Collection

get

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

This endpoint is commonly used to pass the identifier of a Collection to get back a list of its historical transfers:

To understand more about the difference between Collections and Contracts, please refer to our FAQ

Pass a specific collection_id, and get back a list of associated transfers

Path Params

collection_id

string

required

Defaults to 510139ec0d8cf5513d59a8d3afa1c061

The unique identifier of the collection (obtainable from an NFT response, or from the Collection endpoints)

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:

include_unit_price_eth_wei

string

enum

For sales, include the equivalent ETH price, in wei, of the transaction

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