HIP-4 outcome markets overview
get_outcome_marketsRead-only
Hyperliquid HIP-4 outcome markets (prediction markets on sports, central bank decisions, IPOs and daily BTC price contracts) over the last 4 hours, 1 day or 1 week: traded volume (each trade counted once), fills, wallets and active markets, plus the most traded outcomes with their last traded price (the implied probability, 0 to 1) and last-24-hour traded volume. Each outcome has a Yes and a No side whose prices sum to 1. For one outcome's trades or candles pass its symbol to get_recent_trades or get_candles; settled outcomes stay queryable. For per-wallet outcome activity use run_query on hl.wallet_daily with market_class = 'prediction'.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_outcome_markets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of outcomes to return, most traded first (1-200, default 20) | |
| window | No | Lookback window for the totals (default 1d) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notice | No | Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key | |
| volume_usd | No | Traded volume in USD over the window, each trade counted once | |
| computed_at | No | When the summary was computed, Unix seconds | |
| fills_total | No | Fill rows over the window, both sides of each trade plus settlements, splits and merges | |
| top_markets | No | Most traded outcome sides, highest 24h traded volume first | |
| window_hours | No | Window of the totals, in hours | |
| wallets_total | No | Wallets with any fill over the window, including wallets that only settled, split or merged | |
| markets_active | No | Outcome sides with a fill in the window | |
| notional_total | No | Not traded volume: USD over every fill row, both sides of each trade plus settlements, splits and merges. Use volume_usd |