Sales & Transfers by Wallet(s)

get

https://api.simplehash.xyz/api/v0/nfts/transfers/wallets?chains={chains}&wallet_addresses={wallet_addresses}

This endpoint is commonly used to pass specific wallet addresses to get back a list of inbound and outbound NFT transfers:

To supply multiple values, provide them comma separated in the query params, e.g., chains=optimism,ethereum&wallet_addresses=0xa12,0xb34

Query Params

chains

string

required

Defaults to ethereum

Name of the chain(s) (e.g., optimism), comma-separated for multiple values (e.g, optimism,ethereum)

wallet_addresses

string

required

Defaults to 0xfa6e0addf68267b8b6ff2da55ce01a53fad6d8e2

Owner wallet address(es), comma-separated for multiple values (e.g., 0xa12,0xb34). Limit of 20 addresses.

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.

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:

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