Hyperliquid

Spot Markets

Returns Hyperliquid spot market definitions and live context from hyperliquid.hl_spot_market — token pair, canonical flag, and current prices/volume. Filter by pair identifier.

POST/v2/semantic/retrieve/parameterized

Query Parameters

coinstring

Spot market pair identifier. Canonical pair uses BASE/QUOTE (only PURR/USDC); others use @<index> (e.g. @107 = HYPE/USDC). ALL returns every spot market.

Example:

"ALL"

Response Fields

Field	Type	Description
`coin`	String	Spot market pair identifier (`BASE/QUOTE` for the canonical pair, otherwise `@<index>`)
`index`	Integer	Spot market index
`base_token`	String	Base token symbol
`quote_token`	String	Quote token symbol
`is_canonical`	Boolean	Whether this is the canonical market for the pair
`prev_day_px`	Number	Mark price 24h ago
`mark_px`	Number	Mark price
`mid_px`	Number	Mid price
`day_ntl_vlm`	Number	24h notional (USD) volume
`day_base_vlm`	Number	24h base-token volume

Spot 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": 617,
  "params": {
    "coin": "ALL"
  },
  "pagination": {
    "limit": 10,
    "offset": 0
  },
  "formatter_config": {
    "format_type": "raw"
  }
}'

200Example response

{
  "timestamp": "",
  "params": {
    "coin": "@107"
  },
  "pagination": {
    "limit": 50,
    "offset": 0,
    "has_more": false
  },
  "data": {
    "results": [
      {
        "coin": "@107",
        "index": 107,
        "base_token": "HYPE",
        "quote_token": "USDC",
        "is_canonical": false,
        "prev_day_px": 64.717,
        "mark_px": 65.544,
        "mid_px": 65.5525,
        "day_ntl_vlm": 76912970.31807004,
        "day_base_vlm": 1204106.729999999
      }
    ]
  }
}