Skip to main content
The Market Cap Search endpoint looks up crypto and supported TradFi assets by name or ticker. It returns current market cap, price, the day’s return, and crypto-specific FDV and estimated ATH fields where available. Use it to power “what if” comparisons across tokens, stocks, indices, and commodities.

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

string
required
Search query string. Minimum 2 characters, maximum 100. Matches asset ID, name, or symbol.

Response fields

array
Array of matching asset objects (max 20). Returns an empty array if no matches are found.
string
Canonical asset identifier (e.g., bitcoin, ethereum).
string
Full asset name.
string
Uppercase ticker symbol (e.g., BTC, ETH).
string
Asset class identifier: crypto, stock, index, or commodity.
number
Current price in USD. null when the upstream did not publish a price.
number
Current market capitalization in USD.
number
Fully diluted valuation in USD. null when FDV is not available.
number
All-time high price in USD. null when not available.
number
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.
number
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.
string
URL to the asset’s logo image. Empty string "" if no logo is published.
GET /v1/market-cap/search?q=bitcoin
Response
Read the error reference