Skip to main content
Loading market data…
GET/api/v1/coinsHobbyist tier+ · 30 req/min

One-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.

NameTypeRequiredDefaultDescription
limitnumberoptional100
Rows. Max 500.
sortenumoptionalrank
Sort field.
rankpricechange24hvolumeoioiChangefunding
direnumoptionaldesc
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.