Asks (listings)

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
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
ids
array of strings
ids
string

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

string

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

string

Filter to a particular user. Example: 0xF296178d553C8Ec21A2fBD2c5dDa8CA9ac905A00

string

Filter to a particular community. Example: artblocks

string

Filter to a particular collection set. Example: 8daa732ebe5db23f267e58d52f1c9b1879279bcdf4f78b8fb563390e6946ea65

string

Filter to a particular contracts set.

contracts
array of strings
length ≤ 80
contracts
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

string

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

boolean

If true, results will filter only Reservoir orders.

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

number

Get events after a particular unix timestamp (inclusive)

number

Get events before a particular unix timestamp (inclusive)

boolean

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

string
enum

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

Allowed:
string
string

Use continuation token to request next offset of items.

integer
1 to 1000

Amount of items returned in response. defaults to 50

string

Return result in given currency

Response

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*