API Reference

Top Sales by Contract Owner(s)

get
https://api.simplehash.xyz/api/v0/nfts/top_sales/contract_owner?chains=&wallet_addresses=
This endpoint is used to retrieve sales & transfers generated from contracts owned by one or more wallet addresses.

📘

What's the difference between Top Sales by Contract vs Top Sales by Contract Owner(s) Endpoint?

Top Sales by Contract returns the highest valued transfers on a single NFT contract, as determined by the sale's unit price USD equivalent at the time of the sale (in descending order) while the Top Sales by Contract Owner(s) returns the highest valued transfers on all sales generated across contracts owned by each wallet address.

Query Params
string
required
Defaults to polygon

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

string
required
Defaults to 0xD6507fC98605eAb8775f851c25A5E09Dc12ab7A7,0x5f7f9c4bb2897c6c2b6b64fccbad02e243a01cef

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

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.

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

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