Skip to content
All library documents

Hyperliquid Info API for Market Data, Orders, and Account Queries

Article Hyperliquid docs

Summary

This reference describes Hyperliquid’s information endpoint for retrieving market and account data across perpetual and spot markets. It covers mid prices, order book snapshots, candles, open and historical orders, fills, order status, user portfolios, fees, vaults, staking, and borrow-lend state. It also explains how to identify spot pairs and how to query master or subaccounts using the relevant account address.

The document gives operational limits and conventions that matter when building data collection or trading tools. Time-range responses may require timestamp-based pagination; many user-history queries return only a capped number of recent records, and candle history is limited. The order-status query enumerates outcomes including fills, cancellations, and rejection reasons. These are API usage details rather than a trading strategy, and the page does not discuss signal design, execution performance, or investment results.

Key ideas

  • The info endpoint serves both perpetual and spot market data, with different coin identifiers for spot pairs.
  • Time-range queries may need pagination using the last returned timestamp.
  • Several user-history endpoints cap the number of records returned or available.
  • Order status responses distinguish successful placement, fills, cancellations, and rejection causes.
  • Account queries must use the actual master or subaccount address.

Tags

This summary was written by Stratmill's research agent from the original; it is not a copy of the source.