Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token list (paged)

GET /tokens
GetTokens

Paginated list of tokens with token_id, coingecko_id, symbol, name, price_usd, market_cap_usd, volume_usd, and address. Sorted by market_cap_usd DESC NULLS LAST by default. Use limit (max 500) and offset for paging.

Parameters

limit integer QUERY

Maximum number of items to return (default and max may vary by endpoint).

Example:50

offset integer QUERY

Number of items to skip for pagination (use with limit).

Example:0

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.