Hyperliquid Hypercore

Direct access to a Spectrum-operated Hyperliquid node. Hypercore is Hyperliquid’s high-performance L1 state machine - the on-chain order book, perp/spot clearinghouse, vault accounting, staking, and HIP-3 oracle data all live here. This page covers Hypercore-specific data exposed in addition to the unified Hyperliquid EVM API.

Live request/response info methods are available today. WebSocket data streams and indexed historical data are coming soon.

Properties

Endpoint

All info methods are POSTed to a single endpoint with the method name passed as the type field:

POST https://your-endpoint.simplystaking.xyz/hypercore/info
Content-Type: application/json

{ "type": "<method>", ...optional params }

Methods Index

The 29 info methods below are live today. Two further capabilities are on the roadmap:

• Live Data Streams - real-time WebSocket feeds for trades, fills, order updates, book, oracle, and core-writer events. Coming soon.
• Historical Data - indexed time-range queries for trades, fills, funding, liquidations, vault PnL, and more. Coming soon.

Universe & Metadata

meta

Perpetuals universe: list of every perp asset, its size decimals, max leverage, and the margin table it uses.

Request

{ "type": "meta" }

spotMeta

Spot universe: list of spot pairs and the tokens they reference. tokens are indices into the spot tokens array.

Request

{ "type": "spotMeta" }

marginTable

Tiered margin requirements for a specific margin table. The table id comes from meta.universe[i].marginTableId.

Request

{ "type": "marginTable", "id": 1 }

perpDexs

Registered perp DEXs (HIP-3). The first entry is null for the canonical Hyperliquid perp DEX; subsequent entries are third-party deployers.

Request

{ "type": "perpDexs" }

Exchange-wide State

exchangeStatus

Current exchange status flags and server timestamp. specialStatuses is null during normal operation.

Request

{ "type": "exchangeStatus" }

perpsAtOpenInterestCap

Perp assets currently at the open-interest cap. New positions cannot be opened on these symbols until OI drops.

Request

{ "type": "perpsAtOpenInterestCap" }

maxMarketOrderNtls

Maximum market-order notional sizes by leverage tier. Each entry is [leverage, maxNotionalUsd].

Request

{ "type": "maxMarketOrderNtls" }

perpDeployAuctionStatus

State of the current perp listing Dutch auction.

Request

{ "type": "perpDeployAuctionStatus" }

liquidatable

Accounts currently eligible for liquidation. Empty during healthy market conditions.

Request

{ "type": "liquidatable" }

Spot Token Deploys

spotDeployState

Status of in-progress spot token deployments for a specific user plus the global gas auction.

Request

{ "type": "spotDeployState", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

User State - Perpetuals

clearinghouseState

Margin summary, positions, and balances for a user.

Request

{ "type": "clearinghouseState", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

activeAssetData

Per-user, per-asset margin and leverage state including current mark price and max trade sizes.

Request

{ "type": "activeAssetData", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b", "coin": "BTC" }

User State - Spot

spotClearinghouseState

Spot token balances for a user.

Request

{ "type": "spotClearinghouseState", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

Orders

openOrders

Plain list of a user’s open orders.

Request

{ "type": "openOrders", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

frontendOpenOrders

Open orders enriched with frontend-friendly fields (trigger conditions, TP/SL relationships, order type, TIF, cloid).

Request

{ "type": "frontendOpenOrders", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

Vaults

vaultSummaries

Summary stats for all vaults. May be empty if no vaults are currently indexed on the perp DEX you’re querying.

Request

{ "type": "vaultSummaries" }

userVaultEquities

A user’s equity across the vaults they have deposited into.

Request

{ "type": "userVaultEquities", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

leadingVaults

Vaults that the given user is leading (managing).

Request

{ "type": "leadingVaults", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

Accounts & Agents

subAccounts

Sub-accounts owned by a user. null when the user has no sub-accounts.

Request

{ "type": "subAccounts", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

extraAgents

Authorized API agents (signing keys) for a user.

Request

{ "type": "extraAgents", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

userToMultiSigSigners

Multisig signers configured for a user. null when the user is not a multisig.

Request

{ "type": "userToMultiSigSigners", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

userRole

Role classification for a user. Possible values: "missing", "user", "agent", "vault", "subAccount".

Request

{ "type": "userRole", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

Fees & Rate Limits

userFees

Effective fee schedule, daily volume history, and active referral / staking discounts for a user.

Request

{ "type": "userFees", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

userRateLimit

Current rate-limit usage and caps for a user. Limit grows with cumulative trading volume.

Request

{ "type": "userRateLimit", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

maxBuilderFee

Maximum builder fee (in tenths of a basis point) that the user has approved for a given builder address.

Request

{
  "type": "maxBuilderFee",
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
  "builder": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
}

Staking

delegations

A user’s current staking delegations to validators.

Request

{ "type": "delegations", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

delegatorSummary

Aggregate delegator state: total delegated, undelegated, pending withdrawals.

Request

{ "type": "delegatorSummary", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

validatorL1Votes

L1 governance votes by validators.

Request

{ "type": "validatorL1Votes" }

Frontend Bundle

webData2

Bundled frontend payload combining clearinghouseState, openOrders, market metadata, and recent fills for a user. Spectrum’s implementation does not compute assetCtxs (which are user-independent and best fetched separately).

Request

{ "type": "webData2", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b" }

Live Data Streams (Coming Soon)

Direct subscription streams sourced from the same Hypercore node will be available over WebSocket alongside the request/response API above.

Historical Data (Coming Soon)

Indexed historical Hypercore data with time-range and pagination support, sourced from the same node feeds. Useful for backtesting, analytics, and reconstructing user activity outside the rolling window the live info endpoint exposes.

Related Pages

• Hyperliquid (HyperEVM) chain
• Perpetuals API
• Authentication