Get market trades
Retrieve trades for one or more markets, with filtering by trader, side, price, amount, and time range
Query Parameters
Comma-separated condition IDs (max 20)
Comma-separated market slugs
Comma-separated position IDs
Comma-separated trader addresses (max 25)
Comma-separated builder codes (max 25)
Trade side: 0 (Buy), 1 (Sell)
0, 1 Outcome name filter (e.g. Yes, No)
Outcome index: 0 (Yes), 1 (No)
0, 1 Comma-separated trade types: OrderFilled, Redemption, Merge, Split, Cancelled, PositionsConverted, OrdersMatched, MakerRebate, Reward, Yield, ComboCreation, ComboExecution, ComboStatusUpdate, ComboPositionsSplit, ComboPositionsMerged, ComboSplitOnCondition, ComboMergedOnCondition, ComboExtracted, ComboInjected, ComboConvertedToYesBasket, ComboMergedFromYesBasket, ComboCompressed, ComboPositionRedeemed, ComboWrapped, ComboUnwrapped, ComboHorizontalSplit, ComboHorizontalMerge, ComboPositionConverted, ComboPositionMigrated
Min USD amount
Max USD amount
Min shares amount
Max shares amount
Min price (0.0-1.0)
Max price (0.0-1.0)
Start timestamp (ms)
End timestamp (ms)
Results per page (default: 10, max: 250)
x >= 0Pagination offset (number of results to skip). Takes precedence over pagination_key.
x >= 0Cursor-based pagination key obtained from previous response's pagination.pagination_key
Sort newest first (default: true)
Return truncated response optimized for AI consumers (default: false)
Response
Prediction trades matching filters
- OrderFilled
- OrdersMatched
- MakerRebate
- Reward
- Yield
- Redemption
- Merge
- Split
- PositionsConverted
- Cancelled
- Initialization
- Proposal
- Dispute
- Settled
- Resolution
- ConditionResolution
- Reset
- Flag
- Unflag
- Pause
- Unpause
- ManualResolution
- NegRiskOutcomeReported
- RegisterToken
- Approval
- ComboCreation
- ComboExecution
- ComboStatusUpdate
- ComboPositionsSplit
- ComboPositionsMerged
- ComboSplitOnCondition
- ComboMergedOnCondition
- ComboExtracted
- ComboInjected
- ComboConvertedToYesBasket
- ComboMergedFromYesBasket
- ComboCompressed
- ComboPositionRedeemed
- ComboWrapped
- ComboUnwrapped
- ComboHorizontalSplit
- ComboHorizontalMerge
- ComboPositionConverted
- ComboPositionMigrated
Tagged enum for all trade types — serializes with "trade_type": "..." discriminator
and only includes fields relevant to each type.
Trader whose fill is represented by this row.
Fill side from trader perspective.
ERC1155 position ID filled.
USDC notional for the fill.
Shares filled.
Fill price per share.
Exchange contract namespace that emitted the fill.
CTFExchange, NegRiskExchange, ConditionalTokens, NegRiskAdapter, CTFExchangeV2, NegRiskExchangeV2, ComboExchange, ComboCombinatorialModule, ComboNegRiskModule, Unknown OrderFilled x >= 0x >= 0x >= 0x >= 0x >= 0CLOB order hash filled by this trade.
Counterparty/taker address when emitted by the exchange.
Market condition ID for the filled position.
Human-readable outcome label, when enriched.
Outcome index for the filled position.
x >= 0Market question, when enriched.
Market image URL, when enriched.
Market slug, when enriched.
Parent event slug, when enriched.
Probability adjusted for outcome direction when outcome is known.
Fee in USDC when known.
Raw share-denominated fee for buy fills when applicable.
Fee rate as a percent value, not a fraction.
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 in USDC. Absent when no builder code is attached.