API reference / On-chain perps & spot (Hyperliquid)

On-chain perps & spot (Hyperliquid)

Funding, open interest, order books, candles, and per-address account state for on-chain perps and spot tokens.

13 endpoints. Pay per call in USDC via x402 with no account, or get unlimited calls for $99/mo. Every response is shaped { ticker, data, source, as_of }.

GET/api/v1/perps$0.02

Every on-chain perp in one call: funding rate, open interest, mark/oracle price, 24h volume

Live state of every perpetual-futures market in one call: per coin the mark and oracle price, hourly funding rate with annualized APR, premium, open interest, max leverage, previous-day price, and 24h USD and base volume. Native crypto-derivatives data — funding and open interest are perp-only, absent from any spot feed. Free on-chain DEX data (venue: Hyperliquid), no key.

Example request
GET /api/v1/perps
Response type (TypeScript)
interface HlPerpsResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  count: number;
  perps: Array<{
    coin: string;
    max_leverage: number;
    mark_price: number;
    oracle_price: number;
    mid_price: number;
    prev_day_price: number;
    funding_rate_hourly: number;
    funding_apr_percent: number;
    premium: number;
    open_interest: number;
    day_volume_usd: number;
    day_volume_base: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:48:20.210Z",
  "venue": "hyperliquid",
  "market": "perp",
  "count": 230,
  "perps": [
    {
      "coin": "BTC",
      "max_leverage": 40,
      "mark_price": 63700,
      "oracle_price": 63728,
      "mid_price": 63703.5,
      "prev_day_price": 64231,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0002526362,
      "open_interest": 31320.32022,
      "day_volume_usd": 6714881110.838834,
      "day_volume_base": 105924.1805199999
    },
    {
      "coin": "ETH",
      "max_leverage": 25,
      "mark_price": 1767.2,
      "oracle_price": 1767.8,
      "mid_price": 1767.25,
      "prev_day_price": 1815.8,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0002149564,
      "open_interest": 629870.6864,
      "day_volume_usd": 1488672095.318889,
      "day_volume_base": 839194.5139000022
    },
    {
      "coin": "ATOM",
      "max_leverage": 5,
      "mark_price": 1.7975,
      "oracle_price": 1.8005,
      "mid_price": 1.797,
      "prev_day_price": 1.856,
      "funding_rate_hourly": 0.0000087934,
      "funding_apr_percent": 7.703,
      "premium": -0.000888642,
      "open_interest": 1434660,
      "day_volume_usd": 637955.3548200001,
      "day_volume_base": 353646.7600000002
    },
    {
      "coin": "MATIC",
      "max_leverage": 20,
      "mark_price": 0.37621,
      "oracle_price": 0.3754,
      "mid_price": null,
      "prev_day_price": 0.37621,
      "funding_rate_hourly": 0,
      "funding_apr_percent": 0,
      "premium": null,
      "open_interest": 0,
      "day_volume_usd": 0,
      "day_volume_base": 0
    },
    {
      "coin": "DYDX",
      "max_leverage": 5,
      "mark_price": 0.16094,
      "oracle_price": 0.161,
      "mid_price": 0.16102,
      "prev_day_price": 0.17845,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": 0,
      "open_interest": 32905411.40000001,
      "day_volume_usd": 1074031.3981369997,
      "day_volume_base": 6404406.599999999
    },
    {
      "coin": "SOL",
      "max_leverage": 20,
      "mark_price": 68.589,
      "oracle_price": 68.63,
      "mid_price": 68.6025,
      "prev_day_price": 71.64,
      "funding_rate_hourly": -0.000007669,
      "funding_apr_percent": -6.718,
      "premium": -0.0001544514,
      "open_interest": 3850352.48,
      "day_volume_usd": 466050886.4522603,
      "day_volume_base": 6714043.1000000015
    },
    {
      "coin": "AVAX",
      "max_leverage": 10,
      "mark_price": 7.6599,
      "oracle_price": 7.665,
      "mid_price": 7.662,
      "prev_day_price": 8.0711,
      "funding_rate_hourly": -0.0000013995,
      "funding_apr_percent": -1.226,
      "premium": -0.00024788,
      "open_interest": 5426783.38,
      "day_volume_usd": 7670687.509031001,
      "day_volume_base": 984304.1099999998
    },
    {
      "coin": "BNB",
      "max_leverage": 10,
      "mark_price": 602.77,
      "oracle_price": 603.08,
      "mid_price": 602.825,
      "prev_day_price": 621.35,
      "funding_rate_hourly": 0.0000063884,
      "funding_apr_percent": 5.5962,
      "premium": -0.0003167076,
      "open_interest": 51329.868,
      "day_volume_usd": 24724436.712979987,
      "day_volume_base": 40970.148
    },
    {
      "coin": "APE",
      "max_leverage": 5,
      "mark_price": 0.13532,
      "oracle_price": 0.13545,
      "mid_price": 0.13536,
      "prev_day_price": 0.14809,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": 0,
      "open_interest": 7533318.2,
      "day_volume_usd": 939138.065815,
      "day_volume_base": 6827426.600000001
    },
    {
      "coin": "OP",
      "max_leverage": 5,
      "mark_price": 0.1113,
      "oracle_price": 0.11142,
      "mid_price": 0.11135,
      "prev_day_price": 0.12298,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0000897505,
      "open_interest": 29277466.4,
      "day_volume_usd": 1611116.842007,
      "day_volume_base": 14499771.199999996
    },
    {
      "coin": "LTC",
      "max_leverage": 10,
      "mark_price": 45.517,
      "oracle_price": 45.545,
      "mid_price": 45.523,
      "prev_day_price": 47.195,
      "funding_rate_hourly": 0.0000088717,
      "funding_apr_percent": 7.7716,
      "premium": -0.0003315402,
      "open_interest": 218504.9,
      "day_volume_usd": 5628037.719929999,
      "day_volume_base": 122422.58
    },
    {
      "coin": "ARB",
      "max_leverage": 10,
      "mark_price": 0.0887,
      "oracle_price": 0.08881,
      "mid_price": 0.08871,
      "prev_day_price": 0.09307,
      "funding_rate_hourly": -0.0000149453,
      "funding_apr_percent": -13.0921,
      "premium": -0.0004503997,
      "open_interest": 54115626.400000006,
      "day_volume_usd": 3985359.9677260015,
      "day_volume_base": 44348456.2
    },
    {
      "coin": "DOGE",
      "max_leverage": 10,
      "mark_price": 0.0882,
      "oracle_price": 0.08825,
      "mid_price": 0.088234,
      "prev_day_price": 0.0915,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0000793201,
      "open_interest": 302098886,
      "day_volume_usd": 23202670.482565995,
      "day_volume_base": 260371414
    },
    {
      "coin": "INJ",
      "max_leverage": 5,
      "mark_price": 5.4214,
      "oracle_price": 5.4275,
      "mid_price": 5.4217,
      "prev_day_price": 6.5116,
      "funding_rate_hourly": -0.000015081,
      "funding_apr_percent": -13.211,
      "premium": -0.0005730078,
      "open_interest": 991908.8,
      "day_volume_usd": 7042200.993400005,
      "day_volume_base": 1204018.1
    },
    {
      "coin": "SUI",
      "max_leverage": 10,
      "mark_price": 0.76371,
      "oracle_price": 0.76435,
      "mid_price": 0.76374,
      "prev_day_price": 0.82565,
      "funding_rate_hourly": -0.0000157518,
      "funding_apr_percent": -13.7986
… (truncated — call the endpoint for the full response)
GET/api/v1/perps/{coin}$0.01

Single on-chain perp: funding, open interest, mark/oracle price, 24h volume

Live state of one perpetual-futures market by coin (e.g. BTC, ETH, SOL): mark and oracle price, current hourly funding rate with annualized APR, premium, open interest, max leverage, previous-day price, and 24h USD and base volume. The single-coin read for funding and open-interest signals. Free on-chain DEX data (venue: Hyperliquid), no key.

Example request
GET /api/v1/perps/BTC
Response type (TypeScript)
interface HlPerpResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  data: {
    coin: string;
    max_leverage: number;
    mark_price: number;
    oracle_price: number;
    mid_price: number;
    prev_day_price: number;
    funding_rate_hourly: number;
    funding_apr_percent: number;
    premium: number;
    open_interest: number;
    day_volume_usd: number;
    day_volume_base: number;
  };
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:48:55.506Z",
  "venue": "hyperliquid",
  "market": "perp",
  "data": {
    "coin": "BTC",
    "max_leverage": 40,
    "mark_price": 63696,
    "oracle_price": 63727,
    "mid_price": 63703.5,
    "prev_day_price": 64231,
    "funding_rate_hourly": 0.0000125,
    "funding_apr_percent": 10.95,
    "premium": -0.0002683321,
    "open_interest": 31317.9911,
    "day_volume_usd": 6715014671.538914,
    "day_volume_base": 105926.2760499999
  }
}
GET/api/v1/perps/funding/{coin}$0.01

Historical funding-rate series for an on-chain perp

The historical hourly funding-rate series for one perpetual-futures market, each point with the funding rate, annualized APR, and premium, most recent first. Pass the coin in the path (e.g. BTC) and tune the window with `?hours=` (default 24, max 720) or an explicit `?start=`/`?end=` epoch-ms range. Use to study funding regimes and carry. Free on-chain DEX data (venue: Hyperliquid), no key.

Example request
GET /api/v1/perps/funding/BTC
Response type (TypeScript)
interface HlFundingResponse {
  source: string;
  as_of: string;
  venue: string;
  coin: string;
  count: number;
  history: Array<{
    time: string;
    funding_rate_hourly: number;
    funding_apr_percent: number;
    premium: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:49:12.778Z",
  "venue": "hyperliquid",
  "coin": "BTC",
  "count": 24,
  "history": [
    {
      "time": "2026-06-04T00:00:00.032Z",
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0003727867
    },
    {
      "time": "2026-06-04T01:00:00.002Z",
      "funding_rate_hourly": 0.0000116035,
      "funding_apr_percent": 10.1647,
      "premium": -0.0004071721
    },
    {
      "time": "2026-06-04T02:00:00.047Z",
      "funding_rate_hourly": 0.0000067587,
      "funding_apr_percent": 5.9206,
      "premium": -0.0004459304
    },
    {
      "time": "2026-06-04T03:00:00.080Z",
      "funding_rate_hourly": 0.0000085033,
      "funding_apr_percent": 7.4489,
      "premium": -0.0004319739
    },
    {
      "time": "2026-06-04T04:00:00.010Z",
      "funding_rate_hourly": 0.0000060531,
      "funding_apr_percent": 5.3025,
      "premium": -0.0004515753
    },
    {
      "time": "2026-06-04T05:00:00.076Z",
      "funding_rate_hourly": 0.0000042721,
      "funding_apr_percent": 3.7424,
      "premium": -0.0004658231
    },
    {
      "time": "2026-06-04T06:00:00.007Z",
      "funding_rate_hourly": 0.0000034197,
      "funding_apr_percent": 2.9957,
      "premium": -0.0004726428
    },
    {
      "time": "2026-06-04T07:00:00.059Z",
      "funding_rate_hourly": 0.000010114,
      "funding_apr_percent": 8.8599,
      "premium": -0.0004190877
    },
    {
      "time": "2026-06-04T08:00:00.004Z",
      "funding_rate_hourly": 0.0000034241,
      "funding_apr_percent": 2.9995,
      "premium": -0.0004726071
    },
    {
      "time": "2026-06-04T09:00:00.027Z",
      "funding_rate_hourly": 0.0000052245,
      "funding_apr_percent": 4.5767,
      "premium": -0.0004582042
    },
    {
      "time": "2026-06-04T10:00:00.015Z",
      "funding_rate_hourly": 0.0000066623,
      "funding_apr_percent": 5.8362,
      "premium": -0.0004467019
    },
    {
      "time": "2026-06-04T11:00:00.025Z",
      "funding_rate_hourly": -0.0000045162,
      "funding_apr_percent": -3.9562,
      "premium": -0.0005361298
    },
    {
      "time": "2026-06-04T12:00:00.078Z",
      "funding_rate_hourly": -0.000010187,
      "funding_apr_percent": -8.9238,
      "premium": -0.0005814957
    },
    {
      "time": "2026-06-04T13:00:00.006Z",
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0003922656
    },
    {
      "time": "2026-06-04T14:00:00.014Z",
      "funding_rate_hourly": 0.0000039124,
      "funding_apr_percent": 3.4273,
      "premium": -0.0004687007
    },
    {
      "time": "2026-06-04T15:00:00.006Z",
      "funding_rate_hourly": 7.613e-7,
      "funding_apr_percent": 0.6669,
      "premium": -0.0004939092
    },
    {
      "time": "2026-06-04T16:00:00.043Z",
      "funding_rate_hourly": 0.0000049885,
      "funding_apr_percent": 4.3699,
      "premium": -0.0004600917
    },
    {
      "time": "2026-06-04T17:00:00.015Z",
      "funding_rate_hourly": -6.88e-7,
      "funding_apr_percent": -0.6027,
      "premium": -0.000505504
    },
    {
      "time": "2026-06-04T18:00:00.073Z",
      "funding_rate_hourly": 0.0000069786,
      "funding_apr_percent": 6.1133,
      "premium": -0.0004441714
    },
    {
      "time": "2026-06-04T19:00:00.000Z",
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0003740205
    },
    {
      "time": "2026-06-04T20:00:00.031Z",
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0003675202
    },
    {
      "time": "2026-06-04T21:00:00.063Z",
      "funding_rate_hourly": 0.0000055109,
      "funding_apr_percent": 4.8275,
      "premium": -0.0004559132
    },
    {
      "time": "2026-06-04T22:00:00.059Z",
      "funding_rate_hourly": 0.0000036956,
      "funding_apr_percent": 3.2373,
      "premium": -0.0004704349
    },
    {
      "time": "2026-06-04T23:00:00.046Z",
      "funding_rate_hourly": 0.0000069637,
      "funding_apr_percent": 6.1002,
      "premium": -0.0004442908
    }
  ]
}
GET/api/v1/perps/predicted-funding$0.02

Predicted next-period funding for every coin across major perp venues

Predicted next-period funding rate for each coin across venues — on-chain plus centralized perp venues (Hyperliquid, Binance, Bybit) — each with the funding interval and next funding time. A cross-exchange funding-arbitrage signal in one call: compare where a coin's funding is richest or cheapest. Free on-chain DEX data, no key.

Example request
GET /api/v1/perps/predicted-funding
Response type (TypeScript)
interface HlPredictedFundingResponse {
  source: string;
  as_of: string;
  count: number;
  coins: Array<{
    coin: string;
    venues: Array<{
      venue: string;
      funding_rate: number;
      funding_interval_hours: number;
      next_funding_time: string;
    }>;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:49:40.892Z",
  "count": 230,
  "coins": [
    {
      "coin": "0G",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0.00002245,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": -0.00003862,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "2Z",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": -0.00002836,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "AAVE",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": -0.00002791,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": -0.0000242,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "ACE",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "ADA",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0.00004721,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": -0.0000194712,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": -0.00017157,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "AERO",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": -0.00018039,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "AI",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0,
          "funding_interval_hours": null,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        }
      ]
    },
    {
      "coin": "AI16Z",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0,
          "funding_interval_hours": null,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        }
      ]
    },
    {
      "coin": "AIXBT",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000017609,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "ALGO",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": -0.00021936,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": -0.00034483,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "ALT",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0.00002611,
          "fundi
… (truncated — call the endpoint for the full response)
GET/api/v1/perps/orderbook/{coin}$0.01

L2 order book (aggregated price levels) for an on-chain perp

The level-2 order book for one perpetual-futures market: aggregated bid and ask price levels, each with size and the number of resting orders, as of the book timestamp. Pass the coin in the path (e.g. BTC). Use to gauge liquidity, spread, and depth. Free on-chain DEX data (venue: Hyperliquid), no key.

Example request
GET /api/v1/perps/orderbook/BTC
Response type (TypeScript)
interface HlOrderBookResponse {
  source: string;
  as_of: string;
  venue: string;
  coin: string;
  bids: Array<{
    price: number;
    size: number;
    orders: number;
  }>;
  asks: Array<{
    price: number;
    size: number;
    orders: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:50:02.108Z",
  "venue": "hyperliquid",
  "coin": "BTC",
  "bids": [
    {
      "price": 63736,
      "size": 36.46718,
      "orders": 78
    },
    {
      "price": 63735,
      "size": 0.85526,
      "orders": 8
    },
    {
      "price": 63734,
      "size": 6.34854,
      "orders": 11
    },
    {
      "price": 63733,
      "size": 1.41491,
      "orders": 6
    },
    {
      "price": 63732,
      "size": 1.22006,
      "orders": 9
    },
    {
      "price": 63731,
      "size": 7.91279,
      "orders": 10
    },
    {
      "price": 63730,
      "size": 2.14113,
      "orders": 5
    },
    {
      "price": 63729,
      "size": 5.14867,
      "orders": 6
    },
    {
      "price": 63728,
      "size": 8.17165,
      "orders": 14
    },
    {
      "price": 63727,
      "size": 0.82584,
      "orders": 4
    },
    {
      "price": 63726,
      "size": 20.75114,
      "orders": 8
    },
    {
      "price": 63725,
      "size": 29.34051,
      "orders": 10
    },
    {
      "price": 63724,
      "size": 18.57028,
      "orders": 9
    },
    {
      "price": 63723,
      "size": 7.808,
      "orders": 6
    },
    {
      "price": 63722,
      "size": 2.92204,
      "orders": 3
    },
    {
      "price": 63721,
      "size": 10.96273,
      "orders": 9
    },
    {
      "price": 63720,
      "size": 16.60816,
      "orders": 5
    },
    {
      "price": 63719,
      "size": 1.57917,
      "orders": 3
    },
    {
      "price": 63718,
      "size": 14.64938,
      "orders": 9
    },
    {
      "price": 63717,
      "size": 20.19743,
      "orders": 4
    }
  ],
  "asks": [
    {
      "price": 63737,
      "size": 0.62793,
      "orders": 7
    },
    {
      "price": 63738,
      "size": 0.00034,
      "orders": 2
    },
    {
      "price": 63739,
      "size": 0.00017,
      "orders": 1
    },
    {
      "price": 63740,
      "size": 0.00041,
      "orders": 2
    },
    {
      "price": 63741,
      "size": 0.00017,
      "orders": 1
    },
    {
      "price": 63742,
      "size": 0.00041,
      "orders": 2
    },
    {
      "price": 63743,
      "size": 0.00317,
      "orders": 2
    },
    {
      "price": 63744,
      "size": 0.16207,
      "orders": 3
    },
    {
      "price": 63745,
      "size": 0.26706,
      "orders": 4
    },
    {
      "price": 63746,
      "size": 0.81334,
      "orders": 5
    },
    {
      "price": 63747,
      "size": 0.5273,
      "orders": 5
    },
    {
      "price": 63748,
      "size": 0.00047,
      "orders": 2
    },
    {
      "price": 63749,
      "size": 0.78534,
      "orders": 3
    },
    {
      "price": 63750,
      "size": 2.25263,
      "orders": 8
    },
    {
      "price": 63751,
      "size": 2.04021,
      "orders": 7
    },
    {
      "price": 63752,
      "size": 0.3685,
      "orders": 7
    },
    {
      "price": 63753,
      "size": 3.41925,
      "orders": 11
    },
    {
      "price": 63754,
      "size": 3.16462,
      "orders": 5
    },
    {
      "price": 63755,
      "size": 5.94561,
      "orders": 14
    },
    {
      "price": 63756,
      "size": 5.64526,
      "orders": 12
    }
  ]
}
GET/api/v1/perps/candles/{coin}$0.02

Historical OHLCV candles for an on-chain perp at any interval

Historical OHLCV candles for one perpetual-futures market at the requested interval (1m, 5m, 15m, 1h, 4h, 1d, 1w, and more) over a time window. Pass the coin in the path (e.g. BTC) and tune with `?interval=` (default 1h), `?lookback=` candles (default 200, max 5000), or an explicit `?start=`/`?end=` epoch-ms range. Free on-chain DEX data (venue: Hyperliquid), no key.

Example request
GET /api/v1/perps/candles/BTC
Response type (TypeScript)
interface HlCandlesResponse {
  source: string;
  as_of: string;
  venue: string;
  coin: string;
  interval: string;
  count: number;
  candles: Array<{
    start: string;
    end: string;
    open: number;
    high: number;
    low: number;
    close: number;
    volume: number;
    trades: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:50:19.922Z",
  "venue": "hyperliquid",
  "coin": "BTC",
  "interval": "1h",
  "count": 25,
  "candles": [
    {
      "start": "2026-06-03T23:00:00.000Z",
      "end": "2026-06-03T23:59:59.999Z",
      "open": 64884,
      "high": 64959,
      "low": 64061,
      "close": 64118,
      "volume": 6882.91177,
      "trades": 61403
    },
    {
      "start": "2026-06-04T00:00:00.000Z",
      "end": "2026-06-04T00:59:59.999Z",
      "open": 64118,
      "high": 64413,
      "low": 62980,
      "close": 63310,
      "volume": 8198.336,
      "trades": 81013
    },
    {
      "start": "2026-06-04T01:00:00.000Z",
      "end": "2026-06-04T01:59:59.999Z",
      "open": 63312,
      "high": 63496,
      "low": 62076,
      "close": 62148,
      "volume": 7562.7258,
      "trades": 80193
    },
    {
      "start": "2026-06-04T02:00:00.000Z",
      "end": "2026-06-04T02:59:59.999Z",
      "open": 62148,
      "high": 63603,
      "low": 61350,
      "close": 63190,
      "volume": 12606.95184,
      "trades": 106026
    },
    {
      "start": "2026-06-04T03:00:00.000Z",
      "end": "2026-06-04T03:59:59.999Z",
      "open": 63189,
      "high": 64508,
      "low": 63181,
      "close": 64342,
      "volume": 6377.23223,
      "trades": 59416
    },
    {
      "start": "2026-06-04T04:00:00.000Z",
      "end": "2026-06-04T04:59:59.999Z",
      "open": 64341,
      "high": 64752,
      "low": 64240,
      "close": 64374,
      "volume": 3053.52815,
      "trades": 35171
    },
    {
      "start": "2026-06-04T05:00:00.000Z",
      "end": "2026-06-04T05:59:59.999Z",
      "open": 64374,
      "high": 64374,
      "low": 63615,
      "close": 63927,
      "volume": 3157.62682,
      "trades": 43362
    },
    {
      "start": "2026-06-04T06:00:00.000Z",
      "end": "2026-06-04T06:59:59.999Z",
      "open": 63927,
      "high": 64468,
      "low": 63861,
      "close": 63994,
      "volume": 1740.94493,
      "trades": 34276
    },
    {
      "start": "2026-06-04T07:00:00.000Z",
      "end": "2026-06-04T07:59:59.999Z",
      "open": 63997,
      "high": 64046,
      "low": 63456,
      "close": 63566,
      "volume": 2520.10491,
      "trades": 37047
    },
    {
      "start": "2026-06-04T08:00:00.000Z",
      "end": "2026-06-04T08:59:59.999Z",
      "open": 63565,
      "high": 63878,
      "low": 63212,
      "close": 63605,
      "volume": 2963.29414,
      "trades": 39171
    },
    {
      "start": "2026-06-04T09:00:00.000Z",
      "end": "2026-06-04T09:59:59.999Z",
      "open": 63606,
      "high": 63618,
      "low": 62680,
      "close": 63230,
      "volume": 3677.18068,
      "trades": 48086
    },
    {
      "start": "2026-06-04T10:00:00.000Z",
      "end": "2026-06-04T10:59:59.999Z",
      "open": 63231,
      "high": 63250,
      "low": 62266,
      "close": 62386,
      "volume": 3965.43342,
      "trades": 49150
    },
    {
      "start": "2026-06-04T11:00:00.000Z",
      "end": "2026-06-04T11:59:59.999Z",
      "open": 62387,
      "high": 62802,
      "low": 62160,
      "close": 62514,
      "volume": 3136.88503,
      "trades": 43466
    },
    {
      "start": "2026-06-04T12:00:00.000Z",
      "end": "2026-06-04T12:59:59.999Z",
      "open": 62515,
      "high": 63959,
      "low": 62360,
      "close": 63736,
      "volume": 6547.47893,
      "trades": 57801
    },
    {
      "start": "2026-06-04T13:00:00.000Z",
      "end": "2026-06-04T13:59:59.999Z",
      "open": 63736,
      "high": 64244,
      "low": 63045,
      "close": 64184,
      "volume": 7128.15872,
      "trades": 66804
    },
    {
      "start": "2026-06-04T14:00:00.000Z",
      "end": "2026-06-04T14:59:59.999Z",
      "open": 64185,
      "high": 64464,
      "low": 63750,
      "close": 63925,
      "volume": 3342.89059,
      "trades": 51352
    },
    {
      "start": "2026-06-04T15:00:00.000Z",
      "end": "2026-06-04T15:59:59.999Z",
      "open": 63923,
      "high": 64380,
      "low": 63662,
      "close": 63862,
      "volume": 2198.99678,
      "trades": 41590
    },
    {
      "start": "2026-06-04T16:00:00.000Z",
      "end": "2026-06-04T16:59:59.999Z",
      "open": 63861,
      "high": 63891,
      "low": 63418,
      "close": 63536,
      "volume": 2992.87915,
      "trades": 40647
    },
    {
      "start": "2026-06-04T17:00:00.000Z",
      "end": "2026-06-04T17:59:59.999Z",
      "open": 63536,
      "high": 63692,
      "low": 62935,
      "close": 63518,
      "volume": 4189.18918,
      "trades": 46711
    },
    {
      "start": "2026-06-04T18:00:00.000Z",
      "end": "2026-06-04T18:59:59.999Z",
      "open": 63514,
      "high": 64117,
      "low": 63108,
      "close": 63788,
      "volume": 3507.95321,
      "trades": 44543
    },
    {
      "start": "2026-06-04T19:00:00.000Z",
      "end": "2026-06-04T19:59:59.999Z",
      "open": 63787,
      "high": 64138,
      "low": 63499,
      "close": 63596,
      "volume": 3834.17274,
      "trades": 39491
    },
    {
      "start": "2026-06-04T20:00:00.000Z",
      "end": "2026-06-04T20:59:59.999Z",
      "open": 63597,
      "high": 63630,
      "low": 63138,
      "close": 63615,
      "volume": 3656.90641,
      "trades": 34927
    },
    {
      "start": "2026-06-04T21:00:00.000Z",
      "end": "2026-06-04T21:59:59.999Z",
      "open": 63615,
      "high": 63848,
      "low": 63071,
      "close": 63255,
      "volume": 3799.27999,
      "trades": 37484
    },
    {
      "start": "2026-06-04T22:00:00.000Z",
      "end": "2026-06-04T22:59:59.999Z",
      "open": 63255,
      "high": 63753,
      "low": 63160,
      "close": 63715,
      "volume": 2400.61581,
      "trades": 32915
    },
    {
      "start": "2026-06-04T23:00:00.000Z",
      "end": "2026-06-04T23:59:59.999Z",
      "open": 63715,
      "high": 63830,
      "low": 63352,
      "close": 63764,
      "volume": 1884.8456,
      "trades": 21505
    }
  ]
}
GET/api/v1/perps/overview/{coin}$0.03

On-chain perp 360 in one call: live context, funding history, order book, and price candles

Everything about one on-chain perpetual-futures market in one call: live mark/oracle price with funding rate and open interest, recent funding history, the L2 order book, and OHLCV candles. Pass the coin in the path (e.g. BTC, ETH). Replaces four calls (perps/{coin} + funding + orderbook + candles) at a lower combined price. Free DEX data (venue: Hyperliquid). Sections degrade independently.

Example request
GET /api/v1/perps/overview/BTC

Example response coming soon — call the endpoint to see the live shape, or check /openapi.json.

GET/api/v1/perps/account/{address}$0.02

On-chain perp account state for any address: positions, margin, open orders

Live on-chain account state for any wallet on the Hyperliquid perp DEX, by 0x address: account value, total notional, margin used, withdrawable; every open perp position (size, long/short, leverage, entry, unrealized PnL, liquidation price, margin); and resting open orders (up to `?limit=`, default 200; `open_orders_count` is the total). Read-only public chain data, no key.

Example request
GET /api/v1/perps/account/ADDRESS

Example response coming soon — call the endpoint to see the live shape, or check /openapi.json.

GET/api/v1/perps/fills/{address}$0.02

On-chain perp trade history (fills) for any address, most recent first

Recent fills (executed trade history) for any wallet on the Hyperliquid perp DEX, by 0x address: per fill the time, coin, buy/sell side, direction (open/close long/short), price, size, start position, closed PnL, fee, and order id, most recent first. Tune with `?limit=` (default 50, max 200). Read-only public chain data, no key. Pass the address in the path.

Example request
GET /api/v1/perps/fills/ADDRESS

Example response coming soon — call the endpoint to see the live shape, or check /openapi.json.

GET/api/v1/spot$0.02

Every Hyperliquid spot token in one call: price, 24h volume, supply, market cap

Live on-chain spot prices for every token on the Hyperliquid DEX (HYPE, PURR, and hundreds more), quoted in USDC: mid/mark price, previous-day price, 24h USD and base volume, circulating and total supply, and market cap — sorted by 24h volume. Spot, not derivatives: for funding/open interest use /api/v1/perps; for major-coin fiat prices use /api/v1/crypto.

Example request
GET /api/v1/spot
Response type (TypeScript)
interface HlSpotAllResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  count: number;
  pairs: Array<{
    pair: string;
    id: string;
    base_token: string;
    quote_token: string;
    canonical: boolean;
    mark_price: number;
    mid_price: number;
    prev_day_price: number;
    day_volume_usd: number;
    day_volume_base: number;
    circulating_supply: number;
    total_supply: number;
    market_cap_usd: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-05T00:22:18.450Z",
  "venue": "hyperliquid",
  "market": "spot",
  "count": 5,
  "pairs": [
    {
      "pair": "HYPE/USDC",
      "id": "@107",
      "base_token": "HYPE",
      "quote_token": "USDC",
      "canonical": false,
      "mark_price": 62.87,
      "mid_price": 62.8335,
      "prev_day_price": 74.581,
      "day_volume_usd": 414627195.68830013,
      "day_volume_base": 6077950.050000002,
      "circulating_supply": 298358462.35153913,
      "total_supply": 999191084.3483734,
      "market_cap_usd": 18757796528.04
    },
    {
      "pair": "UBTC/USDC",
      "id": "@142",
      "base_token": "UBTC",
      "quote_token": "USDC",
      "canonical": false,
      "mark_price": 63750,
      "mid_price": 63749.5,
      "prev_day_price": 63325,
      "day_volume_usd": 96012122.16522998,
      "day_volume_base": 1515.65301,
      "circulating_supply": 20999999.997555982,
      "total_supply": 20999999.997555982,
      "market_cap_usd": 1338749999844.19
    },
    {
      "pair": "UZEC/USDC",
      "id": "@272",
      "base_token": "UZEC",
      "quote_token": "USDC",
      "canonical": false,
      "mark_price": 454.61,
      "mid_price": 454.245,
      "prev_day_price": 631.83,
      "day_volume_usd": 24318884.251700994,
      "day_volume_base": 46668.1613,
      "circulating_supply": 20999999.99544563,
      "total_supply": 20999999.99544563,
      "market_cap_usd": 9546809997.93
    },
    {
      "pair": "UETH/USDC",
      "id": "@151",
      "base_token": "UETH",
      "quote_token": "USDC",
      "canonical": false,
      "mark_price": 1765.4,
      "mid_price": 1765.35,
      "prev_day_price": 1782.2,
      "day_volume_usd": 23547626.64772,
      "day_volume_base": 13266.2289,
      "circulating_supply": 99999999.9781432,
      "total_supply": 99999999.9782341,
      "market_cap_usd": 176539999961.41
    },
    {
      "pair": "USOL/USDC",
      "id": "@156",
      "base_token": "USOL",
      "quote_token": "USDC",
      "canonical": false,
      "mark_price": 68.633,
      "mid_price": 68.6325,
      "prev_day_price": 70.5,
      "day_volume_usd": 12554680.857987994,
      "day_volume_base": 181993.411,
      "circulating_supply": 499999999.7968679,
      "total_supply": 499999999.8051735,
      "market_cap_usd": 34316499986.06
    }
  ]
}
GET/api/v1/spot/{token}$0.01

Single Hyperliquid spot token: price, 24h volume, supply, market cap

Live on-chain spot market for one Hyperliquid-listed token by symbol (e.g. HYPE, PURR) or @index: mid/mark price, previous-day price, 24h USD and base volume, circulating and total supply, and market cap, quoted in USDC. Spot, not a perp — for funding/open interest use /api/v1/perps/{coin}; for major-coin fiat prices use /api/v1/crypto.

Example request
GET /api/v1/spot/HYPE
Response type (TypeScript)
interface HlSpotResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  data: {
    pair: string;
    id: string;
    base_token: string;
    quote_token: string;
    canonical: boolean;
    mark_price: number;
    mid_price: number;
    prev_day_price: number;
    day_volume_usd: number;
    day_volume_base: number;
    circulating_supply: number;
    total_supply: number;
    market_cap_usd: number;
  };
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-05T00:22:18.451Z",
  "venue": "hyperliquid",
  "market": "spot",
  "data": {
    "pair": "HYPE/USDC",
    "id": "@107",
    "base_token": "HYPE",
    "quote_token": "USDC",
    "canonical": false,
    "mark_price": 62.87,
    "mid_price": 62.8335,
    "prev_day_price": 74.581,
    "day_volume_usd": 414627195.68830013,
    "day_volume_base": 6077950.050000002,
    "circulating_supply": 298358462.35153913,
    "total_supply": 999191084.3483734,
    "market_cap_usd": 18757796528.04
  }
}
GET/api/v1/spot/orderbook/{token}$0.01

L2 order book (aggregated price levels) for a Hyperliquid spot token

Level-2 order book for one Hyperliquid spot market: aggregated bid and ask price levels, each with size and resting order count, as of the book timestamp. Pass a token symbol (e.g. HYPE, PURR) or @index. Use to gauge spot liquidity, spread, and depth. Spot book — for the perp book use /api/v1/perps/orderbook/{coin}.

Example request
GET /api/v1/spot/orderbook/HYPE
Response type (TypeScript)
interface HlSpotOrderBookResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  pair: string;
  id: string;
  bids: Array<{
    price: number;
    size: number;
    orders: number;
  }>;
  asks: Array<{
    price: number;
    size: number;
    orders: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-05T00:22:18.775Z",
  "venue": "hyperliquid",
  "market": "spot",
  "pair": "HYPE/USDC",
  "id": "@107",
  "bids": [
    {
      "price": 62.865,
      "size": 55.67,
      "orders": 1
    },
    {
      "price": 62.83,
      "size": 79.48,
      "orders": 1
    },
    {
      "price": 62.829,
      "size": 42.26,
      "orders": 1
    },
    {
      "price": 62.811,
      "size": 2,
      "orders": 1
    },
    {
      "price": 62.799,
      "size": 63.65,
      "orders": 1
    },
    {
      "price": 62.798,
      "size": 12.5,
      "orders": 1
    },
    {
      "price": 62.797,
      "size": 56.94,
      "orders": 3
    },
    {
      "price": 62.796,
      "size": 19.9,
      "orders": 1
    },
    {
      "price": 62.792,
      "size": 45.99,
      "orders": 1
    },
    {
      "price": 62.79,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.75,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.749,
      "size": 0.26,
      "orders": 1
    },
    {
      "price": 62.71,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.67,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.669,
      "size": 89.51,
      "orders": 1
    },
    {
      "price": 62.63,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.618,
      "size": 358.11,
      "orders": 1
    },
    {
      "price": 62.614,
      "size": 54.41,
      "orders": 2
    },
    {
      "price": 62.613,
      "size": 3.5,
      "orders": 1
    },
    {
      "price": 62.612,
      "size": 6.99,
      "orders": 1
    }
  ],
  "asks": [
    {
      "price": 62.89,
      "size": 101.58,
      "orders": 1
    },
    {
      "price": 62.9,
      "size": 87.62,
      "orders": 1
    },
    {
      "price": 62.91,
      "size": 0.77,
      "orders": 1
    },
    {
      "price": 62.927,
      "size": 79.47,
      "orders": 1
    },
    {
      "price": 62.94,
      "size": 79.47,
      "orders": 1
    },
    {
      "price": 62.943,
      "size": 427.48,
      "orders": 1
    },
    {
      "price": 62.95,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.958,
      "size": 542.96,
      "orders": 1
    },
    {
      "price": 62.977,
      "size": 317.89,
      "orders": 1
    },
    {
      "price": 62.988,
      "size": 759.47,
      "orders": 1
    },
    {
      "price": 62.99,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.996,
      "size": 39.68,
      "orders": 1
    },
    {
      "price": 63,
      "size": 1,
      "orders": 1
    },
    {
      "price": 63.027,
      "size": 34.46,
      "orders": 1
    },
    {
      "price": 63.03,
      "size": 1,
      "orders": 1
    },
    {
      "price": 63.032,
      "size": 3.96,
      "orders": 1
    },
    {
      "price": 63.041,
      "size": 21.22,
      "orders": 1
    },
    {
      "price": 63.046,
      "size": 3.96,
      "orders": 1
    },
    {
      "price": 63.056,
      "size": 20,
      "orders": 1
    },
    {
      "price": 63.068,
      "size": 7.92,
      "orders": 1
    }
  ]
}
GET/api/v1/spot/candles/{token}$0.02

Historical OHLCV candles for a Hyperliquid spot token at any interval

Historical OHLCV candles for one Hyperliquid spot market at the requested interval (1m, 5m, 15m, 1h, 4h, 1d, 1w) over a time window. Pass a token symbol (e.g. HYPE, PURR) or @index and tune with `?interval=` (default 1h), `?lookback=` candles (default 200, max 5000), or `?start=`/`?end=` epoch-ms. Spot candles — for perp candles use /api/v1/perps/candles/{coin}.

Example request
GET /api/v1/spot/candles/HYPE
Response type (TypeScript)
interface HlSpotCandlesResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  pair: string;
  id: string;
  interval: string;
  count: number;
  candles: Array<{
    start: string;
    end: string;
    open: number;
    high: number;
    low: number;
    close: number;
    volume: number;
    trades: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-05T00:22:20.025Z",
  "venue": "hyperliquid",
  "market": "spot",
  "pair": "HYPE/USDC",
  "id": "@107",
  "interval": "1d",
  "count": 3,
  "candles": [
    {
      "start": "2026-05-24T00:00:00.000Z",
      "end": "2026-05-24T23:59:59.999Z",
      "open": 58.714,
      "high": 64.461,
      "low": 58.645,
      "close": 62.746,
      "volume": 3323719.51,
      "trades": 176032
    },
    {
      "start": "2026-05-25T00:00:00.000Z",
      "end": "2026-05-25T23:59:59.999Z",
      "open": 62.745,
      "high": 63.931,
      "low": 60.781,
      "close": 61.111,
      "volume": 1899989.67,
      "trades": 119107
    },
    {
      "start": "2026-05-26T00:00:00.000Z",
      "end": "2026-05-26T23:59:59.999Z",
      "open": 61.108,
      "high": 64.727,
      "low": 58.556,
      "close": 59.512,
      "volume": 2924203.9,
      "trades": 135760
    }
  ]
}