Hyperliquid

Perpetual Markets

Returns Hyperliquid perpetual market definitions and live context from hyperliquid.hl_perp_market — leverage limits, funding, open interest, and current prices. Filter by market name.

POST/v2/semantic/retrieve/parameterized

Query Parameters

namestring

Perpetual market name (coin). ALL returns every perpetual market.

Example:

"ALL"

Response Fields

Field	Type	Description
`name`	String	Perpetual market name (coin)
`sz_decimals`	Integer	Size decimal precision
`max_leverage`	Integer	Maximum allowed leverage
`only_isolated`	Boolean	Whether only isolated margin is permitted
`funding`	Number	Current hourly funding rate
`open_interest`	Number	Open interest, in base units
`prev_day_px`	Number	Mark price 24h ago
`day_ntl_vlm`	Number	24h notional (USD) volume
`premium`	Number	Current premium
`oracle_px`	Number	Oracle price
`mark_px`	Number	Mark price
`mid_px`	Number	Mid price
`dex`	String	Builder-deployed DEX identifier; empty for the main perp dex

Perpetual Markets

curl --request POST \
  --url https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_id": 616,
  "params": {
    "name": "ALL"
  },
  "pagination": {
    "limit": 10,
    "offset": 0
  },
  "formatter_config": {
    "format_type": "raw"
  }
}'

200Example response

{
  "timestamp": "",
  "params": {
    "name": "ALL"
  },
  "pagination": {
    "limit": 50,
    "offset": 0,
    "has_more": false
  },
  "data": {
    "results": [
      {
        "name": "0G",
        "sz_decimals": 0,
        "max_leverage": 3,
        "only_isolated": false,
        "funding": -0.0000346116,
        "open_interest": 1591008,
        "prev_day_px": 0.20441,
        "day_ntl_vlm": 218606.95021,
        "premium": -0.0002085308,
        "oracle_px": 0.211,
        "mark_px": 0.2105,
        "mid_px": 0.21075,
        "dex": ""
      },
      {
        "name": "2Z",
        "sz_decimals": 0,
        "max_leverage": 3,
        "only_isolated": false,
        "funding": 0.0000125,
        "open_interest": 12323774,
        "prev_day_px": 0.065772,
        "day_ntl_vlm": 309957.282051,
        "premium": 0,
        "oracle_px": 0.06664,
        "mark_px": 0.066594,
        "mid_px": 0.066641,
        "dex": ""
      }
    ]
  }
}