Active Listings by Contract

get https://api.simplehash.com/api/v0/nfts/listings/{chain}/{contract_address}

This endpoint is commonly used to retrieve metadata of all of the active NFT listings on a single contract (e.g., Mutant Ape Yacht Club):

Pass a chain and contract address to get back information on the active listings for this contract.

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

Path Params

chain

string

required

Defaults to ethereum

Name of the chain (e.g., ethereum)

contract_address

string

required

Defaults to 0x8a90cab2b38dba80c64b7734e58ee1db38b8992e

Address of the NFT contract

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 timestamp (inclusive). Seconds since the Unix epoch.

to_timestamp

int32

Upper bound 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

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/ethereum/0x8a90cab2b38dba80c64b7734e58ee1db38b8992e?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