> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Hyperliquid Get Outcome Markets

Get all available HIP-4 outcome (prediction) markets on Hyperliquid. Returns binary and bucket markets with underlying asset, target price, expiry, and tradeable sides with their coin notations and asset IDs. Filter by underlying asset or include settled markets. Ideal for: prediction market monitoring, cross-venue comparison with Polymarket, outcome arbitrage detection, and automated trading strategies.

![Hyperliquid Get Outcome Markets logo](https://cdn.b3.fun/hyperliquid-logo.png)
Catalog action Hyperliquid

Get all available HIP-4 outcome (prediction) markets on Hyperliquid. Returns binary and bucket markets with underlying asset, target price, expiry, and tradeable sides with their coin notations and asset IDs. Filter by underlying asset or include settled markets. Ideal for: prediction market monitoring, cross-venue comparison with Polymarket, outcome arbitrage detection, and automated trading strategies.


## At a Glance

| Field | Value |
| --- | --- |
| Action ID | `hyperliquid-get-outcome-markets` |
| Category | Hyperliquid |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | `hyperliquid`, `prediction-market`, `trading`, `read` |

## Payload Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `underlying` | `string` | No | Filter by underlying asset \(e.g., BTC, ETH\). Omit to return all outcome markets. |
| `includeSettled` | `boolean` | No | Include settled/resolved outcomes \(default: false\). |
| `tradeableOnly` | `boolean` | No | Return only outcomes whose orderbook is live on BOTH sides — best bid and best ask present for every side, verified per side via l2Book \(default: false\). Filters out empty-book outcomes \(fallback buckets, settling markets\). Registry order is preserved; for depth before sizing an order, read get-outcome-price. |

## Result Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `outcomes` | `array` | Yes | Available outcome markets |
| `questions` | `array` | No | Grouped questions \(for multi-outcome bucket markets\) |
| `count` | `number` | No | Total number of outcomes returned |

## Examples

**Workflow node**

```json
{
  "type": "hyperliquid-get-outcome-markets",
  "payload": {
    "underlying": "example-underlying",
    "includeSettled": false,
    "tradeableOnly": false
  },
  "children": []
}
```
  **Test with API**

```bash
curl -X POST "https://api.b3os.org/v1/actions/hyperliquid-get-outcome-markets/test" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "inputs": {
    "underlying": "example-underlying",
    "includeSettled": false,
    "tradeableOnly": false
  }
}'
```

**Use expressions for dynamic values**

Payload fields can use workflow expressions such as `{{$trigger.body.amount}}`, `{{$nodes.fetch.result.price}}`, and `{{$props.asset}}` when the value should come from a trigger, prior node, or reusable workflow prop.