Info endpoint
Pagination
Responses that take a time range will only return 500 elements or distinct blocks of data. To query larger ranges, use the last returned timestamp as the next startTime for pagination.
Perpetuals vs Spot
The endpoints in this section work for both Perpetuals and Spot. For perpetuals coin is the name returned in the meta response. For Spot, coin should be PURR/USDC for PURR, and @{index} e.g. @1 for all other spot tokens where index is the index of the spot pair in the universe field of the spotMeta response. For example, the spot index for HYPE on mainnet is @107 because the token index of HYPE is 150 and the spot pair @107 has tokens [150, 0]. Note that some assets may be remapped on user interfaces. For example, BTC/USDC on app.hyperliquid.xyz corresponds to UBTC/USDC on mainnet HyperCore. The L1 name on the hyperliquid token details page can be used to detect remappings.
User address
To query the account data associated with a master or sub-account, you must pass in the actual address of that account. A common pitfall is to use an agent wallet’s address which leads to an empty result.
Retrieve mids for all coins
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Note that if the book is empty, the last trade price will be used as a fallback
Headers
Request Body
Response:
Retrieve a user’s open orders
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
See a user’s open orders
Headers
Request Body
Response:
Retrieve a user’s open orders with additional frontend info
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
Retrieve a user’s fills
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Returns at most 2000 most recent fills
Headers
Request Body
Response:
Retrieve a user’s fills by time
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Returns at most 2000 fills per response and only the 10000 most recent fills are available
Headers
Request Body
Response:
Query user rate limits
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Request Body
Response:
Query order status by oid or cloid
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Request Body
The <status> string returned has the following possible values:
Response:
Response (Missing Order):
L2 book snapshot
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Returns at most 20 levels per side
Headers
Body
Response:
Candle snapshot
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Only the most recent 5000 candles are available
Supported intervals: “1m”, “3m”, “5m”, “15m”, “30m”, “1h”, “2h”, “4h”, “8h”, “12h”, “1d”, “3d”, “1w”, “1M”
Headers
Body
Response:
Check builder fee approval
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Body
Response:
Retrieve a user’s historical orders
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Returns at most 2000 most recent historical orders
Headers
Request Body
Response:
Retrieve a user’s TWAP slice fills
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Returns at most 2000 most recent TWAP slice fills
Headers
Request Body
Response:
Retrieve a user’s subaccounts
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
Retrieve details for a vault
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
Retrieve a user’s vault deposits
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
Query a user’s role
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response (User):
Response (Agent):
Response (Vault):
Response (Subaccount):
Response (Missing):
Query a user’s portfolio
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
Query a user’s referral information
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
Note that rewardHistory is for legacy rewards. Claimed rewards are now returned in nonFundingLedgerUpdate
Query a user’s fees
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
Query a user’s staking delegations
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
Query a user’s staking summary
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
Query a user’s staking history
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
Query a user’s staking rewards
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
Query a user’s HIP-3 DEX abstraction state
POST https://hyperliquid-mainnet.g.alchemy.com/v2/${apiKey}/info
Headers
Request Body
Response:
