Skip to navigation
Predict REST APIOutcome

Get outcome

Retrieve one Predict outcome by ID, including its event relationship, market labels, status, question metadata, and Hyperliquid trading identifiers for trading.

Path parameters

idstringRequired
Stable unique identifier for the id.

Response

OK
idstringOptional
Stable unique identifier for the id.
slugstringOptional

Human-readable label. Backend-generated for sports; caller-supplied otherwise. Always present and non-empty.

event_idstringOptional
Stable unique identifier for the event.
titlestringOptional
statusenumOptional
Allowed value for status.
Allowed values:
hl_question_idstringOptional

Hyperliquid identifiers, null until the market is deployed.

Wrapper types rather than plain int64, and deliberately not optional int64: proto3 optional is a synthetic oneof, which EmitUnpopulated skips, so an unset field would vanish from the response instead of being null. Every key is always present — a null one is spelled null.

hl_idstringOptional
Stable unique identifier for the hl.
created_atdatetimeOptional
updated_atdatetimeOptional
hl_template_idstringOptional

The validator-approved template this market instantiates.

hl_keywordsmap from strings to stringsOptional

A map has no wrapper type, and needs none: an outcome with no template has no keywords either, and an empty object says that unambiguously.

hl_settle_fractionstringOptional

How it settled on chain, as a decimal string: “1” pays side 0 in full, “0” pays side 1, anything between splits. Null until Hyperliquid confirms. Compare it as a decimal — the chain reports “0” back as “0.0”.

hl_rulesstringOptional
question_idstringOptional

The question this outcome belongs to. Null on a standalone market. Several outcomes of one event share one question_id.

settlement_initiated_atdatetimeOptional
settlement_approved_atdatetimeOptional
settled_atdatetimeOptional
settlementlist of objectsOptional

Predict-approved payout, both sides, empty until settlement_approved_at.

hl_settlementlist of objectsOptional

Chain-confirmed payout, both sides, empty until settled_at.

sideslist of objectsOptional

The two Hyperliquid tokens, ordered side 0 then side 1. Always length 2. A participant’s name and abbreviation are joined live; token names without a participant (Up/Down, No) are stored on the row.

tradingobjectOptional

Order constraints a client needs to construct a Hyperliquid order without reading /info. Always present, including on drafts: HIP-4’s defaults are known before deploy, and deploy overwrites them from the chain.

providerslist of objectsOptional

Identities this market is known by at external data providers. Fixture and event ids stay on the event; market ids (a Polymarket token, a Kalshi ticker) live here. Empty until linked.

sports_marketobjectOptional
The sports market type, or null when the outcome has no sports market facet.
price_targetobjectOptional
An asset, comparison operator, and exact decimal strike.
participant_idstringOptional

This instrument is about that team. Set on a soccer home/away leg; unset on a two-way moneyline and on draw. The event already renders the team.

Errors

400
Bad Request Error
404
Not Found Error
405
Method Not Allowed Error
500
Internal Server Error
503
Service Unavailable Error