Skip to main content
POST
Returns tokens ranked by trending score across the requested chains. Tokens from every requested chain are ranked as one set.

Request body

chains is required and must list at least one chain. A repeated chain slug counts once.
  • window sets the period the score covers: 5m, 30m, 1h, 6h or 24h. The default is 24h.
  • limit sets the number of tokens on the board. The default is 100, and out-of-range values are clamped to 1–100.
  • filters takes the same filters as Discovery boards. A token must match every filter to be ranked.
An unknown top-level field returns 400 VALIDATION_ERROR. Unknown filter names inside filters are ignored, as on Discovery boards.

Ranking

The trending score combines USD volume, trade count and volume growth over the window. Tokens created in the last 24 hours receive a bonus. On 24h, the score also includes holder growth and favors tokens with recent activity. The score is not returned. rank gives the order, and tokens with equal scores are returned in a stable order. The board can contain fewer tokens than limit.

Response

deltas lists the board, with one item per rank starting from 1. Each item’s data is the same token object that Token details returns. The spot.trending channel streams changes to the same board.

Errors

Authorizations

Authorization
string
header
required

Send an API key, or a session token a key minted, as Authorization: Bearer <credential>. A browser opening /v1/stream offers its session token in Sec-WebSocket-Protocol instead.

Body

application/json

A trending board request: the chains, the window and the filters.

chains
enum<string>[]
required

Chains to rank over, as one set. At least one is required.

Chain slug. One spelling per chain, in paths and bodies alike. Only a chain with spot data is published.

Available options:
solana,
base,
bsc,
robinhood,
arc
filters
null | object

Conditions every ranked token must match. Absent ranks every candidate.

limit
integer<int32> | null

Number of tokens on the board. The default is 100, and out-of-range values are clamped to 1–100.

Required range: x >= 0
window
enum<string>

Period the trending score covers. The default is 24h.

Available options:
5m,
30m,
1h,
6h,
24h

Response

The ranked board, rank 1 first.

The trending board, rank 1 first.

deltas
object[]
required

One entry per rank.