Bids (offers)

get

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

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

ids

string

token

string

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

tokenSetId

string

Filter to a particular set. Example: contract:0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63 or token:0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:1

maker

string

Filter to a particular user. Example: 0xF296178d553C8Ec21A2fBD2c5dDa8CA9ac905A00

community

string

Filter to a particular community. Example: artblocks

collection

string

Filter to a particular collection bids with collection-id. Example: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63

attribute

string

Filter to a particular attribute within a collection. Example: attribute[Mouth]=Bored (Collection must be passed as well when filtering by attribute)

contracts

array of strings

length ≤ 50

Filter to an array of contracts. Example: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63

contracts

status

string

active = currently valid
inactive = temporarily invalid
expired, cancelled, filled = permanently invalid

Available when filtering by maker, otherwise only valid orders will be returned

source

string

Filter to a source by domain. Example: opensea.io

native

boolean

If true, results will filter only Reservoir orders.

includeMetadata

boolean

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

includeRawData

boolean

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

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:

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