list_hyperliquid_perp_markets
Use one no-argument call to read up to 500 current default and HIP-3 perps, or filter by one name, then copy exact supported AssetRef values into a draft.
| Field | Meaning |
|---|---|
| Side effects | None. This is a bounded public-market read; names are informational and never authorize. |
| Next step | Use supported asset_ref values with draft_pakt; an any-asset draft needs no full scan. Resolve specific names again before changing governed assets. |
Arguments
| Argument | Type | Required |
|---|---|---|
cursor | integer | no |
include_delisted | boolean | no |
page_size | integer | no |
query | string | no |
Exact bounds, accepted values, and nested fields are in Full JSON Schema below.
Example
A no-argument call returns up to 500 markets from one live snapshot in Hyperliquid registry order. Search is a substring match when query is supplied. An any-asset draft does not require a catalogue scan. Market support does not override the policy-program or account margin-mode checks: every open position on a cross-capable market must use cross mode, and closing a position does not reset that market setting. Venue-forced isolated support requires the current policy program.
With an authenticated MCP client:
await client.callTool({
name: "list_hyperliquid_perp_markets",
arguments: {},
});Returns
Important fields in the decoded result; this is not a complete response schema.
| Field | Meaning |
|---|---|
markets[].asset_ref | Copy this exact object into a draft; do not invent venue asset IDs. |
markets[].global_asset_id | The venue-native asset index used by an order. |
markets[].pakt_support | Market-metadata support and remaining account checks; not authorization. |
next_cursor | Continue with this numeric cursor until null when searching all pages. |
provenance | Source, observation time, and completeness of this market read. |
For error handling and retry rules, see Statuses and Errors.
Read one live snapshot of Hyperliquid mainnet's perpetual DEX registry and metadata, resolve default and HIP-3 perps to exact global venue asset ids, and return draft-ready AssetRef JSON. With no arguments, returns up to 500 markets in Hyperliquid registry order; continue from next_cursor only when non-null. An any-asset draft does not require enumerating this catalogue. Read-only and informational: names never enter authorization, and this call does not draft, store, activate, prove, sign, propose, or trade. Market-metadata support covers active USDC-collateralized cross and venue-forced isolated perps with supported precision, margin tiers, and fee metadata. Authorization also checks the committed policy program and account margin modes. The current Hyperliquid policy program supports cross mode on cross-capable markets and isolated mode only where the venue requires it; Pakts committed to the retained legacy program remain cross-only. User-selected isolated mode on a cross-capable market is unsupported. Every open position on a cross-capable market must use cross mode, even when that market is absent from the order. Each cross-capable market named by the order must also have its selected mode set to cross. Closing an isolated position removes the account-wide open-position blocker but does not reset that market's selected mode. Inactive, non-USDC, or invalid-metadata markets also fail closed.
From tools/list, MCP protocol revision 2026-07-28.
{
"additionalProperties": false,
"properties": {
"cursor": {
"description": "Return global asset ids strictly after this cursor.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"include_delisted": {
"description": "Include venue entries marked delisted; defaults to false.",
"type": "boolean"
},
"page_size": {
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Optional case-insensitive symbol/name substring, for example TSLA or xyz:TSLA.",
"maxLength": 64,
"pattern": "^[A-Za-z0-9:_-]*$",
"type": "string"
}
},
"type": "object"
}