Skip to main content
GET
List oracle events

Query Parameters

condition_ids
string

Comma-separated condition IDs (max 20)

event_types
string

Comma-separated event names: Initialization, Proposal, Dispute, Settled, Resolution, ConditionResolution, Reset, Flag, Unflag, Pause, Unpause, ManualResolution, NegRiskOutcomeReported. Empty = all oracle event types.

from
integer<int64>

Start timestamp (Unix seconds)

to
integer<int64>

End timestamp (Unix seconds)

limit
integer<int32>

Results per page (default 10, max 250)

Required range: x >= 0
offset
integer<int32>

Pagination offset. Takes precedence over pagination_key.

Required range: x >= 0
pagination_key
string

Cursor-based pagination key

sort_desc
boolean

Sort direction (default true = newest first)

Response

200 - application/json

Oracle events matching the filter

Tagged enum for all trade types — serializes with "trade_type": "..." discriminator and only includes fields relevant to each type.

id
string
required
hash
string
required
trader
object
required

Trader whose fill is represented by this row.

side
string
required

Fill side from trader perspective.

position_id
string
required

ERC1155 position ID filled.

usd_amount
number<double>
required

USDC notional for the fill.

shares_amount
number<double>
required

Shares filled.

price
number<double>
required

Fill price per share.

exchange
enum<string>
required

Exchange contract namespace that emitted the fill.

Available options:
CTFExchange,
NegRiskExchange,
ConditionalTokens,
NegRiskAdapter,
CTFExchangeV2,
NegRiskExchangeV2,
ComboExchange,
ComboCombinatorialModule,
ComboNegRiskModule,
Unknown
trade_type
enum<string>
required
Available options:
OrderFilled
block
integer<int64> | null
Required range: x >= 0
confirmed_at
integer<int64> | null
Required range: x >= 0
received_at
integer<int64> | null
Required range: x >= 0
log_index
integer<int64> | null
Required range: x >= 0
block_index
integer<int64> | null
Required range: x >= 0
order_hash
string | null

CLOB order hash filled by this trade.

taker
string | null

Counterparty/taker address when emitted by the exchange.

condition_id
string | null

Market condition ID for the filled position.

outcome
string | null

Human-readable outcome label, when enriched.

outcome_index
integer<int32> | null

Outcome index for the filled position.

Required range: x >= 0
question
string | null

Market question, when enriched.

image_url
string | null

Market image URL, when enriched.

slug
string | null

Market slug, when enriched.

event_slug
string | null

Parent event slug, when enriched.

probability
number<double> | null

Probability adjusted for outcome direction when outcome is known.

fee
number<double> | null

Fee in USDC when known.

fee_shares
number<double> | null

Raw share-denominated fee for buy fills when applicable.

fee_pct
number<double> | null

Fee rate as a percent value, not a fraction.

builder_code
string | null

CLOB V2 builder code (lower-cased "0x..." bytes32 hex). Always absent for V1 trades and may be 0x0000… for V2 trades placed without a builder code.

builder_fee
number<double> | null

Builder fee in USDC. Absent when no builder code is attached.

Last modified on July 13, 2026