API Reference

Active Listings by Wallet(s)

get
https://api.simplehash.xyz/api/v0/nfts/listings/wallets
This endpoint is commonly used to retrieve metadata of all of the active NFT listings by one or more wallets.
Query Params
string
required
Defaults to 0x234C472e21DEdb9737c63e396669D07411A9B723,0x2294326Bd4DA3891822a8AFd44656810384D3B8B,0xA15d302aB420E13616Bd2728Eb44d9348A4002ef,0x272982074bf6e976bbD1876b264497f7d9f300f4,

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 listing within the response (pass include_nft_details=1)

Allowed:
string

Marketplace IDs, comma separated for mulitple values (e.g., opensea, x2y2). Allowed values: opensea, blur, x2y2, looksrare, tensor, cryptopunks

int32

Lower bound listing timestamp (inclusive). Seconds since the Unix epoch.

int32

Upper bound listing timestamp (inclusive). Seconds since the Unix epoch.

string

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

string

Include the total distinct count of Listings in the response (pass count=1)

string

Used to retrieve the next page of results

string
enum
Defaults to listing_timestamp_desc

Available values are: listing_timestamp_desc (default), listing_timestamp_asc, price_asc, or price_desc

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