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.