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, totalLp (every DEX pool holding the coin, read from chain, with pools: how many), 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.852061711904762,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"change": {
"m5": -0.20943820287382398,
"h1": -1.010459844641176,
"h6": 0.9612778603314442,
"h24": -8.185783758369581
},
"marketCap": {
"usd": 3509317129.492531,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"volume24h": {
"usd": 25669189.53,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"liquidity": {
"usd": 21161833.696707126,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"totalLp": {
"usd": 22078927,
"priceAsOf": "2026-11-06T04:28:32.375Z",
"pools": 5697
},
"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": 1.00034,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"change": {
"m5": null,
"h1": 0.01,
"h6": -0.02,
"h24": 0.03
},
"marketCap": {
"usd": 325521434.788054,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"volume24h": {
"usd": 48422226.94,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"liquidity": {
"usd": 25741605.05848438,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"totalLp": {
"usd": 27232261,
"priceAsOf": "2026-11-06T04:28:32.375Z",
"pools": 1204
},
"holders": 384443,
"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.019089493487061637,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"change": {
"m5": -0.1263008462339621,
"h1": -0.37086143509836855,
"h6": 1.3251941262842237,
"h24": 6.023115781612165
},
"marketCap": {
"usd": 190966507.98460633,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"volume24h": {
"usd": 1209195.87,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"liquidity": {
"usd": 1422850.1315206303,
"priceAsOf": "2026-11-06T04:28:32.375Z"
},
"totalLp": {
"usd": 1420136,
"priceAsOf": "2026-11-06T04:28:32.375Z",
"pools": 6
},
"holders": 1635,
"createdAt": "2025-09-29T06:09:44.000Z",
"verified": true,
"risk": {
"level": "clear",
"chips": []
},
"curve": null
}
],
"cursor": null,
"total": 45,
"asOf": {
"checkpoint": 342153590,
"timestamp": "2026-11-06T04:28:31.636Z",
"lagMs": 746
}
}Long lists are cut to a few items here.