Asks status changes

Every time an ask status changes, an event is generated. This API is designed to be polled at high frequency, in order to keep an external system in sync with accurate prices for any token.

There are multiple event types, which describe what caused the change in price:

  • new-order > new listing at a lower price

  • expiry > the previous best listing expired

  • sale > the previous best listing was filled

  • cancel > the previous best listing was canceled

  • balance-change > the best listing was invalidated due to no longer owning the NFT

  • approval-change > the best listing was invalidated due to revoked approval

  • revalidation > manual revalidation of orders (e.g. after a bug fixed)

  • reprice > price update for dynamic orders (e.g. dutch auctions)

  • bootstrap > initial loading of data, so that all tokens have a price associated

Note: Private listings (asks) will not appear in the results.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Filter to a particular contract. Example: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63

number

Get events after a particular unix timestamp (inclusive)

number

Get events before a particular unix timestamp (inclusive)

boolean

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

string
enum

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

Allowed:
string

Use continuation token to request next offset of items.

integer
1 to 1000

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

boolean

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

string

Input any ERC20 address to 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:
*/*