List the largest coins by market cap
/v1/markets/top-coinsCall this for the coins at the top of CoinGecko's market-cap ranking, with their price in US dollars, market cap, 24 hour change and logo. A coin that has a contract on Ethereum, Monad or Arc lists it in tokens, so a client can link the coin to the token page of that chain and address. A coin with none (Bitcoin, Ethereum's own coin) has an empty list. as_of is the newest update time CoinGecko gives, and a coin without a price or market cap is left out. limit is 1 to 100, 50 by default. The route is not scoped to a chain.
Sona refreshes the list every 5 minutes in the background, so a call never waits for CoinGecko. Sona keeps an answer for 2 minutes.
Query parameters
| Name | Type | Description |
|---|---|---|
limit | integerDefault 50 | How many coins to return, from 1 to 100. A value out of range answers 400 |
Response
The answer, wrapped in the {data, meta, links} envelope.
| Field | Type | Description |
|---|---|---|
| as_of | string | |
| coverage | array of strings | The codes of the limits that apply to this answer, in a fixed order. It is empty when none applies. |
| items | array of objects | |
| kind | string | top_coins |
Cost
1 credit. The time limit is 5 seconds.
Errors
| Status | Code |
|---|---|
| 400 | invalid_query |
| 429 | rate_limitedcredits_exhausted |
| 500 | internal |
| 503 | upstream_unavailable |
| 504 | deadline_exceeded |
400 invalid_query for a limit outside 1 to 100 or another query key, 429 rate_limited or credits_exhausted, 503 upstream_unavailable before the first refresh, and 504 deadline_exceeded.