Sales & Transfers by Contract Owner(s)

get

https://api.simplehash.xyz/api/v0/nfts/transfers/contract_owner?chains={chains}&wallet_addresses={wallet_addresses} (COPY)

This endpoint is used to retrieve sales & transfers for contracts owned by one or more wallet addresses.

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

📘
What's the difference between Sales & Transfers by Wallet(s) vs Sales & Transfers by Contract Owner(s) Endpoint?
Sales & Transfers by Wallet returns sales & transfers by each wallet address, while the Sales & Transfers by Contract Owner(s) retrieves all sales & transfers generated fom a contract owned by each wallet address.

Query Params

chains

string

required

Defaults to ethereum,polygon

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

wallet_addresses

string

required

Defaults to 0xD6507fC98605eAb8775f851c25A5E09Dc12ab7A7,0x5f7f9c4bb2897c6c2b6b64fccbad02e243a01cef

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

📘What's the difference between Sales & Transfers by Wallet(s) vs Sales & Transfers by Contract Owner(s) Endpoint?

200200

400400

401401

403403

📘
What's the difference between `Sales & Transfers by Wallet(s)` vs `Sales & Transfers by Contract Owner(s)` Endpoint?