Coins
markets.top
Ranked coin lists: trending, top, new, gainers, losers, bonding and graduated.
Details
- Endpoint
- GET /v1/markets
- Credits
- 2
- Rate class
- Light. Counts against your light requests per second.
Returns coins for one list over one window: trending, top (by volume), new, gainers, losers, bonding (still on a launch curve) or graduated. Each row has price { usd, priceAsOf }, change over 5 minutes, 1, 6 and 24 hours, market cap, 24 hour volume, liquidity, holders, creation time, a verified flag and a risk level with chips. window is 5m, 1h, 6h or 24h. Pass cursor to page.
Parameters
| Name | Type | Description |
|---|---|---|
| list | string | Which list.One of "trending", "top", "new", "gainers", "losers", "bonding", "graduated". Default "trending". |
| window | string | Window for change and the ranking.One of "5m", "1h", "6h", "24h". Default "24h". |
| cursor | string | Cursor from the previous response. |
Request
Send your key in the x-api-key header, or leave it out to use the keyless tier.
curl
curl "https://api.tide.ad/v1/markets?list=top&window=24h" \
-H "x-api-key: YOUR_API_KEY"TypeScript
const res = await fetch("https://api.tide.ad/v1/markets?list=top&window=24h", {
headers: {
"x-api-key": process.env.TIDE_API_KEY!,
},
});
const data = await res.json();Response
JSON
{
"list": "top",
"window": "24h",
"items": [
{
"coinType": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
"symbol": "SUI",
"name": "SUI Token",
"iconUrl": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Farchive.cetus.zone%2Fassets%2Fimage%2Fsui%2Fsui.png&t=0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
"price": {
"usd": 0.9112520700812441,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"change": {
"m5": -0.08361851879356008,
"h1": 0.04425811287127601,
"h6": 3.749637661276406,
"h24": 4.479260941006924
},
"marketCap": {
"usd": 3753146898.9852386,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"volume24h": {
"usd": 12039147.478808999,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"liquidity": {
"usd": 23213148.33324912,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"holders": null,
"createdAt": "2024-10-09T10:07:17.000Z",
"verified": true,
"risk": {
"level": "clear",
"chips": []
},
"curve": null
},
{
"coinType": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
"symbol": "USDC",
"name": "Native USDC",
"iconUrl": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Fres.cetus.zone%2Fcoin-metadata%2Fmainnet%2Ficon%2F0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7_28c8a56e.png&t=0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
"price": {
"usd": 0.9999,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"change": {
"m5": null,
"h1": -0.02,
"h6": -0.02,
"h24": -0.02
},
"marketCap": {
"usd": 307912896.8256285,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"volume24h": {
"usd": 42319.53,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"liquidity": {
"usd": 26664250.473178927,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"holders": 384870,
"createdAt": "2024-10-10T01:47:12.000Z",
"verified": true,
"risk": {
"level": "clear",
"chips": []
},
"curve": null
},
{
"coinType": "0x0a48f85a3905cfa49a652bdb074d9e9fabad27892d54afaa5c9e0adeb7ac3cdf::swarm_network_token::SWARM_NETWORK_TOKEN",
"symbol": "TRUTH",
"name": "Swarm Network",
"iconUrl": "https://tide.ad/tide-api/v1/img?u=https%3A%2F%2Ftruth-logo.swarmnetwork.ai%2F&t=0x0a48f85a3905cfa49a652bdb074d9e9fabad27892d54afaa5c9e0adeb7ac3cdf::swarm_network_token::SWARM_NETWORK_TOKEN",
"price": {
"usd": 0.01714633323988581,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"change": {
"m5": 0.026713435975977973,
"h1": -1.1872869946342068,
"h6": 3.2592454810365323,
"h24": 2.8118616648635575
},
"marketCap": {
"usd": 171543381.96629423,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"volume24h": {
"usd": 1047910.1442282754,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"liquidity": {
"usd": 1348426.0057035408,
"priceAsOf": "2026-11-04T10:17:55.864Z"
},
"holders": 1635,
"createdAt": "2025-09-29T06:09:44.000Z",
"verified": true,
"risk": {
"level": "clear",
"chips": []
},
"curve": null
}
],
"cursor": null,
"total": 44,
"asOf": {
"checkpoint": 341525211,
"timestamp": "2026-11-04T10:17:53.774Z",
"lagMs": 2093
}
}Long lists are cut to a few items here.