Retrieve Sales

get

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

This endpoints returns NFT sales data from multiple different marketplaces and aggregators. These include:

OpenSea: Wyvern
OpenSea: Wyvern V1
OpenSea: Seaport
Looksrare
X2Y2
Blur.io

Aggregators

Gem.XYZ
Genie

Orders can be filtered by almost every queryable field. This includes for example marketplace, aggregator, contract, token ID and more.

Max items to be returned at once is 100, and the offset param can be used to paginate.

Query Params

count

int32

Defaults to 100

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

offset

int32

Defaults to 0

Offset for pagination

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:

orderSource

string

enum

OPTIONAL. The source of the marketplace to filter by. Supports OpenSea: Wyvern, OpenSea: Wyvern V1, OpenSea: Seaport, LooksRare, X2Y2 and Blur.io

Allowed:

orderSide

string

enum

OPTIONAL. The order side the sale was fulfilled on. ask = listing, bid = offer.

Allowed:

aggregator

string

enum

OPTIONAL. The aggregator / fulfiller of the order. Supports Gem.XYZ and Genie.

Allowed:

contractAddress

string

OPTIONAL. The NFT contract address to filter sales by.

slug

string

OPTIONAL. The Opensea collection slug to filter by.

tokenId

string

OPTIONAL. The NFT tokenId to filter by.

from

string

OPTIONAL. The seller address to filter by.

string

OPTIONAL. The buyer address to filter by.

minPrice

string

OPTIONAL. The minimum sale price to filter by.

maxPrice

string

OPTIONAL. The maximum sale price to filter by.

withMetadata

boolean

Defaults to false

Include token metadata in each token object

Headers

X-API-KEY

string

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

Responses

200200

404404

429429