On this page
Hyperliquid
Hyperliquid exposes three distinct market surfaces through one Info / Exchange endpoint pair. Artery splits them into two registered providers so capability declarations remain accurate:
| Artery provider | Surfaces |
|---|---|
hyperliquid_perp | Main perpetual futures + HIP-3 builder-deployed perps (TSLA, FX, RWA) |
hyperliquid_hip4 | HIP-4 binary YES/NO outcome markets (the actual prediction markets) |
hyperliquid_dex | HyperEVM swap (separate doc) |
HIP-3 ≠ Hyperliquid prediction markets. HIP-3 are continuous-price PERPS (TSLA, SP500, FX). The actual prediction markets are HIP-4 outcome markets, launched on mainnet 2026-05-02. Artery may be the first API gateway to aggregate HIP-4 — we ship raw passthrough so HIP-4 schema changes don't block clients.
Asset index encoding
The HL info API uses a single integer asset id with a partitioned namespace:
| Range | Surface |
|---|---|
0..N | Main perps |
10_000 + spotMeta.universe[i].index | Spot pairs |
100_000 + dex_idx*10_000 + idx_in_dex | HIP-3 perps |
100_000_000 + (10*outcome_id + side) | HIP-4 outcomes (side=0 NO, side=1 YES) |
Main perp + HIP-3 endpoints
| Artery | Upstream /info type |
|---|---|
GET /v1/hyperliquid/info/meta?dex= | meta |
GET /v1/hyperliquid/info/asset-ctxs?dex= | metaAndAssetCtxs |
GET /v1/hyperliquid/info/all-mids?dex= | allMids |
GET /v1/hyperliquid/info/perp-dexs | perpDexs |
GET /v1/hyperliquid/info/predicted-fundings | predictedFundings |
GET /v1/hyperliquid/info/l2-book?coin= | l2Book |
GET /v1/hyperliquid/info/candles | candleSnapshot |
GET /v1/hyperliquid/info/spot-meta | spotMeta |
The dex query param scopes to a HIP-3 dex (flx, xyz, etc.). Omit for
main perp.
HIP-4 endpoints
| Artery | Notes |
|---|---|
GET /v1/hyperliquid/hip4/outcome-meta | info action outcomeMeta |
POST /v1/hyperliquid/hip4/info | Raw passthrough — body forwarded verbatim |
The raw passthrough lets your client use any new HIP-4 info action as Hyperliquid ships it, without waiting for an Artery release.
Wallet model (planned)
- Master wallet — required for
withdraw3,approveAgent,approveBuilderFee,userSetAbstraction - Agent wallet — trading-only (order, cancel, modify, leverage); cannot withdraw funds
Each user gets a unique short-lived agent (named qf-<base36-ts>, max 16
chars) approved via EIP-712 typed data. Agent addresses are never reused
across users to prevent replay.
Builder fees (planned)
Artery supports the HL builder fee program:
- Perp: max 0.1% (100 tenths-bp)
- Spot: max 1% (1000), sell-side only (HL rejects buy with
f≠0) - Builder must hold ≥100 USDC perp account value
- Per user: max 10 active approvals