Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Trending token list

GET /tokens/trending
GetTokensTrending

Trending token snapshot sorted by mindshare_change DESC. Returns the same response shape as /tokens, with optional trend metrics (mindshare_24h, mindshare_change, mindshare_change_pct). Use limit (max 50).

Parameters

limit integer QUERY

Maximum number of trending tokens to return (default 10, max 50).

Example:50

Responses

200 OK
400 Bad Request ErrorResponse

Media type application/json

limit
integer optional

Applied response size limit.

offset
integer optional

Applied page offset (always 0 for non-paginated token snapshots).

tokens
array<object> optional

Paged token rows. One entry per indexed token.
tokens[].address
string optional

Canonical contract address when available; null for native assets or unknown contracts.

tokens[].coingecko_id
string optional

CoinGecko asset identifier when available; null otherwise.

tokens[].market_cap_usd
number (double) optional

Latest known market capitalization in USD; null when unavailable.

tokens[].mindshare_24h
number (double) optional

Percent change in mindshare over the latest comparison window when available.

tokens[].mindshare_change
number (double) optional

Percent change in mindshare over the latest comparison window when available.

tokens[].mindshare_change_pct
number (double) optional

Percent change in mindshare over the latest comparison window when available.

tokens[].name
string optional

Human-readable token name.

tokens[].price_usd
number (double) optional

Latest known USD price; null when unavailable.

tokens[].symbol
string optional

Primary trading symbol.

tokens[].token_id
integer (int64) optional

Internal Ruma token identifier.

tokens[].volume_usd
number (double) optional

Latest known 24h volume in USD; null when unavailable.

total
integer optional

Total number of tokens in this response set.