Hyperliquid Markets#

The /v1/markets/hyperliquid/* namespace covers customer-facing, normalized market data over the Hyperliquid perpetual universe. Each endpoint maps onto an HL Info call but reshapes the response into the Artery wire format — typed columns, consistent error envelope, server-side caching.

If you need the raw HL payload verbatim (e.g. for a strategy that's hard-coded against HL fields), use the /v1/hyperliquid/info/* passthrough family instead — same auth, no schema translation.

Endpoint summary#

All require the read scope and meter under the markets.read SKU.

List coins#

bashcurl -H "Authorization: Bearer art_live_<your-key>" \
  "https://api.artery.questflow.ai/v1/markets/hyperliquid/coins"

jsonc{
  "coins": [
    { "name": "BTC", "sizeDecimals": 5, "maxLeverage": 50 },
    { "name": "ETH", "sizeDecimals": 4, "maxLeverage": 50 },
    { "name": "SOL", "sizeDecimals": 2, "maxLeverage": 20 }
  ]
}

Delisted coins are filtered out. For the raw universe (including delisted entries plus the assetCtxs margin/funding overlay) use GET /v1/hyperliquid/info/meta from the passthrough family.

Coin snapshot#

bashcurl -H "Authorization: Bearer art_live_<your-key>" \
  "https://api.artery.questflow.ai/v1/markets/hyperliquid/coins/BTC"

jsonc{
  "coin": "BTC",
  "markPx": 76905.0,
  "oraclePx": 76900.5,
  "midPx": 76904.2,
  "funding": 0.00001,
  "openInterest": 12345.67,
  "dayNtlVlm": 98765432.1,
  "dayBaseVlm": 1284.91
}

• funding is the per-hour funding rate as a decimal (0.00001 = 0.001%/hr). Multiply by 8760 for annualized; by 24 × 365 for a more conventional APR representation. This matches HL's own convention.
• Unknown coin → 404 unknown_coin.
• Sandbox-aware: when called with a sandbox API key, returns a frozen mock and stamps X-Artery-Sandbox: true.

Orderbook#

bashcurl -H "Authorization: Bearer art_live_<your-key>" \
  "https://api.artery.questflow.ai/v1/markets/hyperliquid/coins/BTC/orderbook?depth=20"

jsonc{
  "coin": "BTC",
  "bids": [
    { "price": 76903.5, "size": 0.42 },
    { "price": 76902.8, "size": 1.10 }
  ],
  "asks": [
    { "price": 76905.0, "size": 0.85 },
    { "price": 76906.1, "size": 0.27 }
  ],
  "ts": 1779163200000
}

Recent trades#

bashcurl -H "Authorization: Bearer art_live_<your-key>" \
  "https://api.artery.questflow.ai/v1/markets/hyperliquid/coins/BTC/trades?limit=50"

jsonc{
  "trades": [
    {
      "coin": "BTC",
      "price": 76904.2,
      "size": 0.05,
      "side": "buy",
      "ts": 1779163198120,
      "txHash": "0x..."
    }
  ]
}

• side: "buy" = an aggressor lifted the ask; "sell" = one hit the bid.
• txHash is the HL chain transaction hash (32 hex bytes).
• limit clamped to [1, 200]; default 50.

OHLC candles#

bash# Last 100 1h candles (default window)
curl -H "Authorization: Bearer art_live_<your-key>" \
  "https://api.artery.questflow.ai/v1/markets/hyperliquid/coins/BTC/candles?interval=1h&limit=100"
 
# Explicit time range — May 18 (UTC), 1h granularity, cap at 30 rows
curl -H "Authorization: Bearer art_live_<your-key>" \
  "https://api.artery.questflow.ai/v1/markets/hyperliquid/coins/BTC/candles?interval=1h&start_time=2026-05-18T00:00:00Z&end_time=2026-05-19T00:00:00Z&limit=30"

jsonc{
  "candles": [
    {
      "ts": 1779163200000,
      "open": 76757.0,
      "high": 76927.0,
      "low":  76676.0,
      "close": 76905.0,
      "volume": 658.65,
      "source": "hl_node"      // "hl_node" | "binance" | "official_api"
    }
  ]
}

Each candle carries a source tag so backtesters can audit per-bar provenance:

A single response may mix sources at the join seam (e.g. recent rows hl_node, older ones binance).

Query parameters#

Windowing strategies#

Four shapes, picked automatically from which bounds you set:

• start_time and end_time accept either Unix milliseconds (1715766000000) or any ISO-8601 timestamp (2026-05-19T00:00:00Z).
• start_time >= end_time → 400 validation_failed.
• The 5000-bucket cap mirrors HL official's per-call response limit — sized so the common large queries land in one round-trip: 1h × 90d → 2160 buckets, 1d × 5y → 1825 buckets. 1m × 90d (≈130k buckets) still needs pagination — shrink the window and call iteratively.
• Candles are returned oldest-first within the response.

Historical reach + caching#

Artery runs its own Hyperliquid node. Recent candles (since the node's earliest indexed fill) are computed live from the raw fill stream — they match HL official o/c/h/l/v/n exactly. Older buckets come from a write-through cache that's hydrated lazily on the first miss for a (coin, interval, window) tuple.

HL official's hard limit is 5000 bars per response, no matter how wide the window (so for 5m that's ~17 days; for 1m, ~3.5 days). To make longer windows usable for backtesting, Artery pre-populates the cache with a 2-year Binance Futures USDⓈ-M backfill for the top HL crypto majors that exist on both venues. Coverage today:

BTC, ETH, SOL, NEAR, TON, WLD, XRP, SUI, ZEC, TAO, DOGE, ADA, AVAX, BNB × 1m / 5m / 15m / 1h × 2 years back.

For these symbols, an old-window request that would have returned [] from HL alone is served from the Binance backfill instead. Prices match HL within a few basis points for these names; volume totals differ (different LP venue) and trade counts reflect Binance flow, not HL. HL-native names (HYPE, xyz:* HIP-3 perps, @N spot deploys) have no Binance counterpart and remain capped at HL's 5000-bar window until our own fill index ages out far enough to serve them locally.

For uncovered (coin, interval, window) combinations beyond what either HL or the backfill provides, the response is [] for the uncovered range — never an error.

Daily market cross-section#

GET /v1/markets/hyperliquid/daily returns the day's OHLCV plus quote turnover for every HL market — the main-dex perp universe, every HIP-3 / builder-dex contract (xyz:NVDA, flx:OIL, …), and spot pairs — in a single response. It's the cross-section counterpart to the per-coin candles endpoint: pick a date, get the whole market.

bashcurl -H "Authorization: Bearer art_live_<your-key>" \
  "https://api.artery.questflow.ai/v1/markets/hyperliquid/daily?date=20260605"

Query parameters#

Response#

json{
  "date": "2026-06-05",
  "market": null,
  "count": 532,
  "snapshots": [
    {
      "tradeDate": "2026-06-05",
      "marketType": "perp",
      "symbol": "BTC",
      "open": 66732, "high": 67479, "low": 64061, "close": 64118,
      "volume": 75735.7,
      "amount": 4900000000,
      "marketCap": null,
      "source": "candle_agg_5m"
    }
  ]
}

• symbol is the perp coin (BTC), the namespaced builder-dex contract (xyz:NVDA — same id HL uses in fills/positions), or the spot pair (HYPE-USDC).
• volume is base-asset volume; amount is quote turnover (USD).
• marketCap is set for spot only (circulating supply × price); null for perp.
• source tells you how the bar was built — the two market types use different sources because HL serves no candles for most spot markets:

Error responses#

Common to every endpoint in this family:

Caching#

Cache hits are completely transparent; there's no header to opt out. If you need fresher data than the TTL allows, drop down to the /v1/hyperliquid/info/* passthrough family — those forward upstream without caching.