Asks (listings)

get

https://api.reservoir.tools/orders/asks/v4

Get a list of asks (listings), filtered by token, collection or maker. This API is designed for efficiently ingesting large volumes of orders, for external processing.

Please mark excludeEOA as true to exclude Blur orders.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

ids

array of strings

ids

token

string

Filter to a particular token. Example: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:123

tokenSetId

string

Filter to a particular set, e.g. contract:0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63

maker

string

Filter to a particular user. Example: 0xF296178d553C8Ec21A2fBD2c5dDa8CA9ac905A00

community

string

Filter to a particular community. Example: artblocks

collectionsSetId

string

Filter to a particular collection set. Example: 8daa732ebe5db23f267e58d52f1c9b1879279bcdf4f78b8fb563390e6946ea65

contractsSetId

string

Filter to a particular contracts set.

contracts

array of strings

length ≤ 80

contracts

status

string

activeª^º = currently valid inactiveª^ = temporarily invalid expiredª^, canceledª^, filledª^ = permanently invalid anyªº = any status ª when an id is passed ^ when a maker is passed º when a contract is passed

source

string

Filter to a source by domain. Only active listed will be returned. Example: opensea.io

native

boolean

If true, results will filter only Reservoir orders.

includePrivate

boolean

If true, private orders are included in the response. defaults to false

includeCriteriaMetadata

boolean

If true, criteria metadata is included in the response. defaults to false

includeRawData

boolean

If true, raw data is included in the response. defaults to false

includeDynamicPricing

boolean

If true, dynamic pricing data will be returned in the response. defaults to false

excludeEOA

boolean

Exclude orders that can only be filled by EOAs, to support filling with smart contracts. defaults to false

startTimestamp

number

Get events after a particular unix timestamp (inclusive)

endTimestamp

number

Get events before a particular unix timestamp (inclusive)

normalizeRoyalties

boolean

If true, prices will include missing royalties to be added on-top. defaults to false

sortBy

string

enum

Order the items are returned in the response, Sorting by price allowed only when filtering by token defaults to createdAt

Allowed:

sortDirection

string

continuation

string

Use continuation token to request next offset of items.

limit

integer

1 to 1000

Amount of items returned in response. defaults to 50

displayCurrency

string

Return result in given currency

Response

200Successful