Skip to main content
API reference
Market data REST
Docs
Help

Get a market ranking at every bucket of a window

GET 
/v1/defi/market/market-data/scans/history

Returns the ranking a scanner or a universe rotation is built on, taken at every bucket across a lookback window rather than only at now.

Every span a ranking measures is read backwards from its own bucket, so no bucket reflects a figure the market had not reported yet. Ranking a month of hourly buckets over the whole tracked universe would be hundreds of thousands of rows, so each bucket carries only its top per_bucket assets, ordered best first on the requested source. Assets without a symbol or without a spot price source are dropped, the same way the live feeds drop them.

value is the figure the source ranks on: a trending ratio, a recent volume in USD, or a signed price change percentage. Ranking is on that signed figure, so sort=desc on a surging_* source is the gainers and sort=asc is the fallers.

See the Time Window & Resolution section for the format of window and resolution.

Request​

Responses​

The ranking at each bucket of the window