Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token list (paged)

GET /tokens

Free

Description

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.

Path Parameters

No path parameters for this endpoint.

Query Parameters

limit
integeroptional

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

offset
integeroptional

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

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.