Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token search

GET /tokens/search
GetTokensSearch

Search tokens by symbol, name, or contract address. Returns matching tokens ordered by relevance. Use q for the query string and limit (max 50) to cap results.

Parameters

q string QUERY required

Search query. For tokens this matches symbol, name, or contract address; for accounts it matches display name or handle.

Example:string

limit integer QUERY

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

Example:50

Responses

200 OK
400 Bad Request ErrorResponse

Media type application/json

query
string optional

Normalized query string that was searched.

tokens
array<object> optional

Matching tokens ordered by relevance.
tokens[].coingecko_id
string optional

CoinGecko asset identifier when available; null otherwise.

tokens[].followers
integer (int64) optional

Project follower count when available; null otherwise.

tokens[].handle
string optional

Primary social handle for the token's project; null when unknown.

tokens[].image_url
string optional

Token logo URL.

tokens[].market_cap_usd
number (double) optional

Latest known market capitalization in USD; null when unavailable.

tokens[].name
string optional

Human-readable token name.

tokens[].price_change_24h_pct
number (double) optional

24h price change percentage; null when unavailable.

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.

total
integer optional

Number of tokens returned in this response.