Hyperliquid

Outcome Markets

Returns Hyperliquid outcome (binary) market definitions from hyperliquid.hl_outcome_market. Filter by a coin that appears on either the YES or NO leg of a market. When a coin is supplied, each row is annotated with the matched leg (side), the matched coin, and the opposite leg (coin_counterparty).

POST/v2/semantic/retrieve/parameterized

Query Parameters

coinstring

Coin (asset) that appears as the YES or NO leg of a market. ALL returns every outcome market.

Example:

"ALL"

Response Fields

Field	Type	Description
`outcome_id`	Integer	Outcome market identifier
`name`	String	Market name
`description`	String	Pipe-encoded market metadata (`class:...\	underlying:...\	expiry:...\	targetPrice:...\	period:...`)
`underlying`	String \	null	Underlying asset (e.g. `BTC`)
`expiry`	String \	null	Expiry timestamp, `YYYYMMDD-HHMM`
`target_price`	Number \	null	Target/strike price
`period`	String \	null	Recurrence period (e.g. `1d`)
`market_class`	String \	null	Market class (e.g. `priceBinary`)
`yes_coin`	String	Asset representing the YES leg
`no_coin`	String	Asset representing the NO leg
`yes_asset_id`	Integer	Numeric asset id of the YES leg
`no_asset_id`	Integer	Numeric asset id of the NO leg
`side`	String \	null	Which leg the queried `coin` matched: `yes` or `no`. `null` when `coin` is `ALL`.
`coin`	String \	null	The matched coin. `null` when `coin` is `ALL`.
`coin_counterparty`	String \	null	The opposite leg's coin. `null` when `coin` is `ALL`.

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

200Example response

{
  "timestamp": "",
  "params": {
    "coin": "#350"
  },
  "pagination": {
    "limit": 50,
    "offset": 0,
    "has_more": false
  },
  "data": {
    "results": [
      {
        "outcome_id": 35,
        "name": "Recurring",
        "description": "class:priceBinary|underlying:BTC|expiry:20260514-0600|targetPrice:80983|period:1d",
        "underlying": "BTC",
        "expiry": "20260514-0600",
        "target_price": 80983,
        "period": "1d",
        "market_class": "priceBinary",
        "yes_coin": "#350",
        "no_coin": "#351",
        "yes_asset_id": 100000350,
        "no_asset_id": 100000351,
        "side": "yes",
        "coin": "#350",
        "coin_counterparty": "#351"
      }
    ]
  }
}