Skip to main content
POST
perpDexLimits | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "perpDexLimits" is used to fetch the open-interest, position-size, and transfer limits for a HIP-3 perp DEX.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "perpDexLimits", "dex": "..."}.
  • The dex field names the HIP-3 builder-deployed perp DEX to inspect. Enumerate deployed DEX names with perpDexs.
  • Returns null for a DEX that has no configured limits (including the empty-string native perp DEX).
  • coinToOiCap is an array of [coin, cap] tuples; all limit values are decimal strings.
Returns the risk limits configured for a HIP-3 builder-deployed perpetual DEX: the total open-interest cap, the per-perp open-interest size cap, the maximum transfer notional, and the per-asset open-interest caps. This is a per-DEX type. Pass a builder DEX name from perpDexs as the dex field to inspect that DEX’s limits.

Endpoint

Request

string
default:"perpDexLimits"
required
Always "perpDexLimits".
string
required
The HIP-3 builder DEX name (e.g. "xyz"). Enumerate deployed DEX names with perpDexs. An empty string selects the native Hyperliquid perp DEX, which has no configured limits and returns null.

Example

Response

A single object describing the DEX’s limits, or null when the DEX has no configured limits.

Field descriptions

All limit values 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
Total open-interest cap across the DEX, in USD notional.
string
Open-interest size cap applied per perp on this DEX.
string
Maximum transfer notional allowed on this DEX.
array<[string, string]>
Per-asset open-interest caps, encoded as [coin, cap] tuples. Values are decimal strings.
Last reviewed: 2026-07-24