Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Trending token list

GET /tokens/trending

Growth

Description

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).

Path Parameters

No path parameters for this endpoint.

Query Parameters

limit
integeroptional

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

Responses

OK

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.