Skip to main content
The hyperliquid.predictions.trades_enriched table contains every Hyperliquid HIP-4 prediction-market trade with outcome, question, and market-resolution context attached on each row. Useful when you want one row per trade with everything needed to filter or label.
Every column from hyperliquid.predictions.trades is available on this table. The columns documented below are the additions beyond the base trades view.

Additional Columns

Outcome metadata

Column NameDescription
side_labelDisplay label for this row’s token_side (e.g. ‘Yes’, ‘No’, or a categorical label).
token_nameThe fee-token symbol form (e.g. ‘+5476’) used in fee_token for opens.
outcome_nameOutcome display name from the HL API. The literal string ‘Recurring’ marks HL’s auto-generated price-binary outcomes.
outcome_descriptionOutcome description string. For Recurring outcomes this is a structured pipe-separated payload (class:...|underlying:...|expiry:...|targetPrice:...|period:...). For named outcomes this is free-form prose.
is_recurringTrue for HL’s auto-generated price-binary outcomes.
classThe market class for Recurring outcomes (e.g. ‘priceBinary’). NULL for non-Recurring outcomes.
underlyingThe asset whose price the outcome resolves against (e.g. ‘HYPE’, ‘BTC’). NULL for non-Recurring outcomes.
target_priceThe target price for Recurring outcomes. Stored as VARCHAR. token_side=0 resolves YES iff underlying price >= target_price at expiry; token_side=1 resolves YES iff price < target_price. NULL for non-Recurring outcomes.
periodThe recurrence cadence (e.g. ‘15m’, ‘1h’, ‘1d’). NULL for non-Recurring outcomes.
expiry_tsResolution timestamp (UTC). NULL for non-Recurring outcomes.

Question metadata

Column NameDescription
question_idParent question ID. NULL for Recurring / orphan outcomes.
question_nameQuestion name from the HL API.
question_descriptionQuestion description from the HL API.
is_namedTrue when this outcome is one of the parent question’s named outcomes.
is_fallbackTrue when this outcome is the parent question’s fallback outcome.

Resolution & Settlement

Column NameDescription
is_winnerTrue for the winning side of a settled outcome. NULL while unsettled.
is_settledTrue once the outcome has been resolved on-chain.
settled_atSettlement timestamp (UTC). NULL while unsettled.
resolution_outcomeThe winning side_label when is_settled.

Market metadata

Column NameDescription
market_titleHuman-readable market title; never null.
categoryMarket type. One of ‘price_binary’, ‘categorical’, ‘binary’.
sub_categoryUnderlying asset for Recurring outcomes (e.g. ‘BTC’). NULL otherwise.
market_statusOne of ‘active’ (open), ‘closed’ (expired, awaiting settlement), ‘settled’ (resolved).
activeTrue when the market is currently open for trading.
closedTrue when the market is no longer accepting new trades.
For all base trade columns (price, size, fees, counterparties, PnL, etc.) see Trades.

Sample Query

SELECT
  timestamp,
  market_title,
  side_label,
  size,
  price,
  usd_collateral_amount,
  buyer_address,
  seller_address
FROM hyperliquid.predictions.trades_enriched
WHERE timestamp >= CURRENT_DATE - 7
ORDER BY timestamp DESC
LIMIT 100