Active Listings by Collection

get https://api.simplehash.com/api/v0/nfts/listings/collection/{collection_id}

This endpoint is commonly used to retrieve metadata of all of the active NFT listings on a single collection

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

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

Include the associated NFT details for the listing within the response (pass include_nft_details=1)

marketplaces

string

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

from_timestamp

int32

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

to_timestamp

int32

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

count

string

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

cursor

string

Used to retrieve the next page of results

order_by

string

Defaults to listing_timestamp_desc

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

limit

int32

Defaults to 50

Limit. Defaults to 50, capped at 50.

Responses

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://api.simplehash.com/api/v0/nfts/listings/collection/510139ec0d8cf5513d59a8d3afa1c061?order_by=listing_timestamp_desc&limit=50' \
3
     --header 'X-API-KEY: sh_sk1_Z4jhWXXBE09em' \
4
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400

401401

403403