GET
/api/v1/coinsHobbyist tier+ · 30 req/minOne-call rollup table — every base asset we track, blended price, 24h change, volume, OI, and average funding.
The canonical cross-asset rollup: one row per base asset with a blended price anchor (Hyperliquid-preferred), 24h change %, 24h notional USD volume, aggregate open interest with 24h delta, and a venue-averaged funding rate. Backed by `getCoinsOverview` — the same helper that powers `/coins` on the web surface, so numbers reconcile 1:1 with the on-page table.
Query parameters
All query parameters are optional unless marked required.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| limit | number | optional | 100 | Rows. Max 500. |
| sort | enum | optional | rank | Sort field. rankpricechange24hvolumeoioiChangefunding |
| dir | enum | optional | desc | Sort direction. ascdesc |
Response shape
Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.
data payloadtypescript
// Wrapped in the standard envelope:
// {
// data: /* shape below */,
// meta?: { total?: number; limit?: number; offset?: number; ... }
// }
Array<{
base: string;
price: number;
priceChange24hPct: number | null;
volume24hUsd: number;
oiTotalUsd: number;
oiChange24hPct: number | null;
avgFundingRate: number | null;
rank: number;
}>Example
Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.
Requestbash
curl -sS "http://localhost:3000/api/v1/coins?limit=3&sort=volume" \
-H "Authorization: Bearer cg_live_YOUR_KEY"Responsejson
{
"data": [
{ "base": "BTC", "price": 63180.5, "priceChange24hPct": 1.82, "volume24hUsd": 28450000000, "oiTotalUsd": 24100000000, "oiChange24hPct": 2.4, "avgFundingRate": 0.000108, "rank": 1 },
{ "base": "ETH", "price": 3280.15, "priceChange24hPct": -0.55, "volume24hUsd": 14200000000, "oiTotalUsd": 12400000000, "oiChange24hPct": -0.8, "avgFundingRate": 0.000092, "rank": 2 }
],
"meta": { "total": 2, "limit": 3, "sort": "volume", "dir": "desc" }
}Notes
- Price anchor prefers Hyperliquid when the instrument is available; falls back to the most-liquid perp venue otherwise.
- Funding rate is venue-averaged across the largest-OI perp legs — not a simple mean of every exchange.
Next
Check the error code reference, or get an API key to try the request against your own account.