Skip to main content
POST
activeAssetData | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "activeAssetData" is used to fetch a user’s active trading limits, leverage setting, available size, and mark price for a single Hyperliquid perpetual asset.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "activeAssetData", "user": "...", "coin": "ETH"}.
  • coin accepts the Hyperliquid asset identifier for the target perp market. For HIP-3 markets, pass the same dex-qualified coin string used by Hyperliquid for that asset.
  • maxTradeSzs and availableToTrade are returned as two directional decimal-string values. Preserve the upstream array order and use fixed-precision decimal handling.
  • For whole-account position and margin state, use clearinghouseState; this endpoint is scoped to one user and one active asset.
Returns per-user, per-asset trading state for one active perpetual market: the user’s leverage setting, directional max trade sizes, directional available-to-trade amounts, and the current mark price. User-keyed and coin-keyed. Use this when a trading UI needs to show how much size a wallet can open or close on a specific asset before placing an order. For full account margin and open positions, use clearinghouseState; for market metadata and asset context, use metaAndAssetCtxs.

Endpoint

Request

string
default:"activeAssetData"
required
Always "activeAssetData".
string
required
The wallet address (lowercase 0x-prefixed hex).
string
required
The perp asset identifier, e.g. "ETH" or "APT". For HIP-3 markets, pass the same dex-qualified coin string used by Hyperliquid for that asset.

Example

Response

A single JSON object with the user’s active trading configuration and directional trading capacity for the requested asset.

Field descriptions

Prices, sizes, and available amounts are returned as decimal strings, preserving upstream precision. Do not parse them as floats - keep them as strings or use a fixed-precision decimal type.
string
Wallet address the active asset data was computed for.
string
Hyperliquid asset identifier, such as "APT" or "ETH".
object
User’s configured leverage for this asset.
array<string>
Directional maximum trade sizes for this wallet and asset, returned as decimal strings.
array<string>
Directional available-to-trade amounts for this wallet and asset, returned as decimal strings.
string
Current mark price for the asset.

metaAndAssetCtxs

fetch the full Hyperliquid perpetuals market universe with live per-asset trading context.

spotMetaAndAssetCtxs

fetch the spot universe metadata, token configuration, and live market data in a single call.
Last reviewed: 2026-07-08