Retrieve trades for one or more markets, with filtering by trader, side, price, amount, and time range
Documentation Index
Fetch the complete documentation index at: https://docs.struct.to/llms.txt
Use this file to discover all available pages before exploring further.
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
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)
Prediction trades matching filters
Tagged enum for all trade types — serializes with "trade_type": "..." discriminator
and only includes fields relevant to each type.
Trader profile info - backwards compatibility
Polymarket exchange contract types.
repr(u8) discriminants double as the database column value — DO NOT renumber
existing variants. New variants get fresh numbers.
CTFExchange, NegRiskExchange, ConditionalTokens, NegRiskAdapter, CTFExchangeV2, NegRiskExchangeV2, Unknown OrderFilled x >= 0x >= 0x >= 0x >= 0x >= 0x >= 0CLOB 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.