API reference / Builder-market perps (Hyperliquid HIP-3)

Builder-market perps (Hyperliquid HIP-3)

Synthetic 24/7 oracle-priced perps on permissionless builder DEXs — US equities, commodities (gold/oil/copper), FX, and global index perps that Hyperliquid's core perps and US-only stock feeds don't carry. Marks are a live proxy for the underlying, not its official quote.

5 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/hip3/dexs$0.01

List Hyperliquid HIP-3 builder perp DEXs — 24/7 synthetic markets for stocks, commodities, FX & global indices

List every permissionless builder-deployed perp DEX on Hyperliquid (HIP-3). Each lists synthetic, oracle-priced 24/7 perp markets — US equities, commodities (gold, oil, copper), FX, and global index perps — that Hyperliquid's core perps and US-only stock feeds don't carry. Returns each DEX's id, name, deployer, and market count. Then read a DEX's markets at /api/v1/hip3/{dex}.

Example request
GET /api/v1/hip3/dexs

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

GET/api/v1/hip3/{dex}$0.02

All markets in one HIP-3 builder DEX: 24/7 synthetic mark, funding & open interest

All markets in one Hyperliquid HIP-3 builder DEX (pass the dex id, e.g. `xyz`): 24/7 synthetic mark & oracle price, funding rate + APR, open interest, and day volume each. Covers equity perps (NVDA, TSLA), commodities (GOLD, BRENTOIL, COPPER), FX, and index perps. Oracle-priced proxies carrying funding — not the underlying's official last trade. List DEXs at /api/v1/hip3/dexs.

Example request
GET /api/v1/hip3/DEX

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

GET/api/v1/hip3/{dex}/{market}$0.01

One HIP-3 builder-DEX market (e.g. xyz/NVDA, xyz/GOLD): 24/7 synthetic mark & funding

One market in a Hyperliquid HIP-3 builder DEX by underlying symbol (e.g. `xyz`/`NVDA`, `xyz`/`GOLD`): its 24/7 synthetic mark & oracle price, funding rate + APR, premium, open interest, and day volume. A round-the-clock live proxy for the underlying that carries funding — NOT its official last trade, exchange close, or spot price. List a DEX's markets at /api/v1/hip3/{dex}.

Example request
GET /api/v1/hip3/DEX/gold

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

GET/api/v1/basis$0.05

Cross-venue basis board: where every cross-listed stock trades 24/7 vs its official price

Scans every US stock that also trades as a 24/7 synthetic perp and returns the gap: official (delayed) price, prev close, perp mark and oracle, funding APR, open interest, and computed `basis_percent` + `basis_vs_prev_close_percent` — the implied overnight move while the US market is shut. Widest dislocation first, plus a plain-English `reading`. `?limit=`, `?min_basis=`.

Example request
GET /api/v1/basis
Response type (TypeScript)
interface BasisResponse {
  source: string;
  as_of: string;
  venue_map: {
    equity: string;
    perp: string;
  };
  us_market_open: boolean;
  method: string;
  reading: string;
  count: number;
  rows: Array<{
    ticker: string;
    equity_price: number;
    equity_prev_close: number;
    equity_change_percent: number;
    equity_as_of: string;
    perp_symbol: string;
    perp_mark: number;
    perp_oracle: number;
    perp_funding_apr_percent: number;
    perp_open_interest: number;
    perp_day_volume_usd: number;
    basis_percent: number;
    basis_absolute: number;
    basis_vs_prev_close_percent: number;
    direction: string;
    comparable: boolean;
    excluded_reason: null;
  }>;
  sections: {
    perps: string;
    equities: string;
  };
  note: string;
  total_available: number;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-07-30T23:17:18.872Z",
  "venue_map": {
    "equity": "us_listed",
    "perp": "hyperliquid:xyz"
  },
  "us_market_open": false,
  "method": "Legs are joined by ticker symbol. Macro perps (commodities, FX, indices) are excluded because their symbols collide with unrelated US tickers, and any remaining pair differing by more than 25% is treated as a symbol collision rather than a dislocation — see `comparable` and `excluded_reason` per row.",
  "reading": "US market closed — the 24/7 perp is the live opinion of where these reopen. Widest vs last print: GEV at 9.33%.",
  "count": 8,
  "rows": [
    {
      "ticker": "GEV",
      "equity_price": 987.8459,
      "equity_prev_close": 900.28,
      "equity_change_percent": 9.07,
      "equity_as_of": "2026-07-30T22:50:00.000Z",
      "perp_symbol": "xyz:GEV",
      "perp_mark": 1080,
      "perp_oracle": 1080,
      "perp_funding_apr_percent": 0,
      "perp_open_interest": 0,
      "perp_day_volume_usd": 0,
      "basis_percent": 9.33,
      "basis_absolute": 92.1541,
      "basis_vs_prev_close_percent": 19.96,
      "direction": "premium",
      "comparable": true,
      "excluded_reason": null
    },
    {
      "ticker": "SKHY",
      "equity_price": 154.45,
      "equity_prev_close": 126.79,
      "equity_change_percent": 21.48,
      "equity_as_of": "2026-07-30T23:01:00.000Z",
      "perp_symbol": "xyz:SKHY",
      "perp_mark": 151.07,
      "perp_oracle": 151.22,
      "perp_funding_apr_percent": -40.637,
      "perp_open_interest": 1098345.16,
      "perp_day_volume_usd": 400571544.56,
      "basis_percent": -2.19,
      "basis_absolute": -3.38,
      "basis_vs_prev_close_percent": 19.15,
      "direction": "discount",
      "comparable": true,
      "excluded_reason": null
    },
    {
      "ticker": "SNDK",
      "equity_price": 1353,
      "equity_prev_close": 1015.89,
      "equity_change_percent": 32.99,
      "equity_as_of": "2026-07-30T23:01:00.000Z",
      "perp_symbol": "xyz:SNDK",
      "perp_mark": 1325,
      "perp_oracle": 1325,
      "perp_funding_apr_percent": -27.094,
      "perp_open_interest": 120671.762,
      "perp_day_volume_usd": 825124743.03,
      "basis_percent": -2.07,
      "basis_absolute": -28,
      "basis_vs_prev_close_percent": 30.43,
      "direction": "discount",
      "comparable": true,
      "excluded_reason": null
    },
    {
      "ticker": "DRAM",
      "equity_price": 53.81,
      "equity_prev_close": 44.85,
      "equity_change_percent": 19.58,
      "equity_as_of": "2026-07-30T23:01:00.000Z",
      "perp_symbol": "xyz:DRAM",
      "perp_mark": 52.701,
      "perp_oracle": 52.691,
      "perp_funding_apr_percent": 5.475,
      "perp_open_interest": 1337563.8,
      "perp_day_volume_usd": 407610329.14,
      "basis_percent": -2.06,
      "basis_absolute": -1.109,
      "basis_vs_prev_close_percent": 17.51,
      "direction": "discount",
      "comparable": true,
      "excluded_reason": null
    },
    {
      "ticker": "EWY",
      "equity_price": 163,
      "equity_prev_close": 144.21,
      "equity_change_percent": 12.9,
      "equity_as_of": "2026-07-30T23:01:00.000Z",
      "perp_symbol": "xyz:EWY",
      "perp_mark": 160.19,
      "perp_oracle": 160.16,
      "perp_funding_apr_percent": 5.475,
      "perp_open_interest": 100885.866,
      "perp_day_volume_usd": 102451416.01,
      "basis_percent": -1.72,
      "basis_absolute": -2.81,
      "basis_vs_prev_close_percent": 11.08,
      "direction": "discount",
      "comparable": true,
      "excluded_reason": null
    },
    {
      "ticker": "BOT",
      "equity_price": 29.8585,
      "equity_prev_close": 27.22,
      "equity_change_percent": 9.69,
      "equity_as_of": "2026-07-30T22:56:00.000Z",
      "perp_symbol": "xyz:BOT",
      "perp_mark": 29.345,
      "perp_oracle": 29.608,
      "perp_funding_apr_percent": -690.891,
      "perp_open_interest": 127659.26,
      "perp_day_volume_usd": 787910.34,
      "basis_percent": -1.72,
      "basis_absolute": -0.5135,
      "basis_vs_prev_close_percent": 7.81,
      "direction": "discount",
      "comparable": true,
      "excluded_reason": null
    },
    {
      "ticker": "MU",
      "equity_price": 908.48,
      "equity_prev_close": 739,
      "equity_change_percent": 22.71,
      "equity_as_of": "2026-07-30T23:01:00.000Z",
      "perp_symbol": "xyz:MU",
      "perp_mark": 893.7,
      "perp_oracle": 893.93,
      "perp_funding_apr_percent": -45.513,
      "perp_open_interest": 230112.38,
      "perp_day_volume_usd": 783555681.44,
      "basis_percent": -1.63,
      "basis_absolute": -14.78,
      "basis_vs_prev_close_percent": 20.93,
      "direction": "discount",
      "comparable": true,
      "excluded_reason": null
    },
    {
      "ticker": "WDC",
      "equity_price": 560,
      "equity_prev_close": 462.04,
      "equity_change_percent": 21.2,
      "equity_as_of": "2026-07-30T23:01:00.000Z",
      "perp_symbol": "xyz:WDC",
      "perp_mark": 553.3,
      "perp_oracle": 552.96,
      "perp_funding_apr_percent": 14.788,
      "perp_open_interest": 1924.168,
      "perp_day_volume_usd": 1953213.12,
      "basis_percent": -1.2,
      "basis_absolute": -6.7,
      "basis_vs_prev_close_percent": 19.75,
      "direction": "discount",
      "comparable": true,
      "excluded_reason": null
    }
  ],
  "sections": {
    "perps": "ok",
    "equities": "ok"
  },
  "note": "11 name(s) lack one leg (no US listing, or no 24/7 market). 27 name(s) were excluded as symbol collisions rather than dislocations (see excluded_reason).",
  "total_available": 65
}
GET/api/v1/basis/{ticker}$0.03

Cross-venue basis for one ticker: 24/7 price vs the official listing

One stock priced on every rail at once: its official US listing (delayed, closed overnight) against the 24/7 Hyperliquid HIP-3 synthetic perp. Returns both prices, funding APR, open interest, and the gap as `basis_percent` + `basis_vs_prev_close_percent` — while the US market is shut, the live view of where the name reopens.

Example request
GET /api/v1/basis/AAPL
Response type (TypeScript)
interface BasisTickerResponse {
  source: string;
  as_of: string;
  venue_map: {
    equity: string;
    perp: string;
  };
  us_market_open: boolean;
  method: string;
  reading: string;
  count: number;
  rows: Array<{
    ticker: string;
    equity_price: number;
    equity_prev_close: number;
    equity_change_percent: number;
    equity_as_of: string;
    perp_symbol: string;
    perp_mark: number;
    perp_oracle: number;
    perp_funding_apr_percent: number;
    perp_open_interest: number;
    perp_day_volume_usd: number;
    basis_percent: number;
    basis_absolute: number;
    basis_vs_prev_close_percent: number;
    direction: string;
    comparable: boolean;
    excluded_reason: null;
  }>;
  sections: {
    perps: string;
    equities: string;
  };
  note: null;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-07-30T23:17:18.770Z",
  "venue_map": {
    "equity": "us_listed",
    "perp": "hyperliquid:xyz"
  },
  "us_market_open": false,
  "method": "Legs are joined by ticker symbol. Macro perps (commodities, FX, indices) are excluded because their symbols collide with unrelated US tickers, and any remaining pair differing by more than 25% is treated as a symbol collision rather than a dislocation — see `comparable` and `excluded_reason` per row.",
  "reading": "US market closed — the 24/7 perp is the live opinion of where these reopen. Widest vs last print: NVDA at -0.05%.",
  "count": 1,
  "rows": [
    {
      "ticker": "NVDA",
      "equity_price": 196.21,
      "equity_prev_close": 190.01,
      "equity_change_percent": 3.31,
      "equity_as_of": "2026-07-30T23:01:00.000Z",
      "perp_symbol": "xyz:NVDA",
      "perp_mark": 196.11,
      "perp_oracle": 196.11,
      "perp_funding_apr_percent": 5.475,
      "perp_open_interest": 795118.516,
      "perp_day_volume_usd": 112992460.08,
      "basis_percent": -0.05,
      "basis_absolute": -0.1,
      "basis_vs_prev_close_percent": 3.21,
      "direction": "discount",
      "comparable": true,
      "excluded_reason": null
    }
  ],
  "sections": {
    "perps": "ok",
    "equities": "ok"
  },
  "note": null
}