Search assets
GET /v1/market-cap/search
Searches the same crypto and TradFi universe used by the terminal and returns up to 20 results. Results are filtered to assets with non-zero market cap and sorted by market cap descending. When CoinGecko fails and no TradFi asset matches, the request returns 503 (service_unavailable, Retry-After: 60, detail “CoinGecko is unavailable.”); an answer missing its TradFi or CoinGecko half says so in meta.runtime_status: "degraded" and is never cached.
Query parameters
Search query string. Minimum 2 characters, maximum 100. Matches asset ID, name, or symbol.
Response fields
Estimated market cap at all-time high using current circulating supply. This is not historical point-in-time market cap and can overstate inflationary assets.
null when ATH or current price is unavailable.The day’s price return as a fraction (
0.0215 is +2.15%). For crypto it is the last 24 hours, to 4 decimal places; for stocks, ETFs, indices and commodity proxies it is the last trading session against the prior close, not a rolling 24 hours. null when unavailable.GET /v1/market-cap/search?q=bitcoin
Response

