Skip to main content
Streams one trending board. The first update contains the full board, and later updates contain only the rows that changed. Subscribe on an open stream connection. See WebSocket streams for connections, frames and reconnection.

​
Filters

The filter is the Trending request body: chains, window, limit and filters. chains must list at least one chain. Each subscription uses one unit of the address limit. The channel does not accept throttleMs or any other subscribe option.

​
Updates

  • The full board is sent as one update after the ack. It matches the REST response for the same body, in content and order, and can be up to 10 seconds old.
  • The board is ranked again every 60 seconds. The update after each ranking contains only the rows that changed.
  • Between rankings, changes to a ranked token’s state are sent at most once per second, in one update.
  • A token is added to the board only when the board is ranked again.
  • A token whose new state no longer matches filters is removed between rankings, and the rows below it move up.
  • No update is sent when nothing changed, so an empty board sends no update.
Each update counts against the organization’s credits. A board uses at most about one credit per second, plus one per minute for each ranking.

​
Message format

Each update’s data contains a deltas list, the same shape that Trending returns. Keep one row per chain and address, and apply each delta in order: The score is not sent. After a reconnect, subscribe again: the first update contains the full board, so no REST request is needed.

​
Errors