Retrieve Listings

get

https://api.modulenft.xyz/api/v2/eth/nft/listings

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

This endpoint returns NFT listings from key marketplaces. It currently supports:

Opensea
Looksrare
X2Y2
Blur

Query Params

active

boolean

Defaults to true

Filter by active orders

count

int32

Defaults to 100

Number of items to retrieve. Max 100 at a time.

offset

int32

Defaults to 0

Offset for pagination 0

sortDirection

string

enum

Defaults to timeDesc

The direction to sort results. priceAsc = price ascending, priceDesc is price descending, timeAsc = time ascending and timeDesc = time descending.

Allowed:

marketplace

string

enum

OPTIONAL. The source of the marketplace to filter by. Supports OpenSea, Looksrare and X2Y2

Allowed:

slug

string

OPTIONAL. The Opensea collection slug to filter by.

contractAddress

string

OPTIONAL. The NFT contract address to filter listings by.

tokenId

string

OPTIONAL. The NFT tokenId to filter by.

seller

string

Filter by seller address

withMetadata

boolean

Defaults to false

Include token metadata in each token object

listedAfter

string

Filter by listings that were created after a time. Format is Unix timestamp.

listedBefore

string

Filter by listings that were created before a time. Format is Unix timestamp.

minPrice

string

OPTIONAL. Filter by minimum price. PRICE IN WEI

maxPrice

string

OPTIONAL. Filter by maximum price. PRICE IN WEI

Headers

X-API-KEY

string

API key for elevated rate limits and cache bypassing (optional)

Responses

200200

404404

429429