Sales

get

https://api.reservoir.tools/sales/v6

Get recent sales for a contract or token. Paid mints are returned in this sales endpoint, free mints can be found in the /activities/ endpoints. Array of contracts max limit is 20.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

contract

array of strings

length ≤ 20

contract

tokens

array of strings

length ≤ 20

Array of tokens. Max limit is 20. Example: tokens[0]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:704tokens[1]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:979

tokens

includeTokenMetadata

boolean

If enabled, also include token metadata in the response. Default is false.

includeDeleted

boolean

If enabled, include sales that have been deleted. In some cases the backfilling process deletes sales that are no longer relevant or have been reverted. defaults to false

collection

string

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

attributes

string

Filter to a particular attribute. Attributes are case sensitive. Note: Our docs do not support this parameter correctly. To test, you can use the following URL in your browser. Example: https://api.reservoir.tools/sales/v6?collection=0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63&attributes[Type]=Original or https://api.reservoir.tools/sales/v6?collection=0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63&attributes[Type]=Original&attributes[Type]=Sibling

sortBy

string

enum

Order the items are returned in the response. Options are price, time, and updatedAt. Default is time.

Allowed:

sortDirection

string

enum

Order the items are returned in the response. defaults to desc

Allowed:

txHash

string

Filter to a particular transaction. Example: 0x04654cc4c81882ed4d20b958e0eeb107915d75730110cce65333221439de6afc

startTimestamp

number

Get events after a particular unix timestamp (inclusive). Relative to the sortBy time filters.

endTimestamp

number

Get events before a particular unix timestamp (inclusive). Relative to the sortBy time filters.

limit

integer

1 to 1000

Amount of items returned in response. Max limit is 1000. defaults to 100

continuation

string

Use continuation token to request next offset of items.

Response

200Successful