Get Trades For A User Or Markets
Returns cached trade fills with filters for user, market, pagination, side selection, taker flags, and notional thresholds
Query Parameters
limit?integer
Maximum rows to return (max 10,000).
Range
0 <= value <= 10000Default
100offset?integer
Cursor offset for pagination.
Range
0 <= value <= 10000Default
0takerOnly?boolean
Limit results to taker fills (default true).
Default
truefilterType?string
Apply a cash or token threshold filter (requires filterAmount).
Value in
- "CASH"
- "TOKENS"
filterAmount?number
Threshold used alongside filterType.
Range
0 <= valuemarket?array<>
Comma-separated list of condition IDs.
user?string
Wallet address to scope results to.
side?string
Limit to BUY or SELL fills.
Value in
- "BUY"
- "SELL"
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/trades"[ { "proxyWallet": "0x56687bF447db6fFa42FfE2204a05edAa20f55839", "side": "BUY", "asset": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:0", "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917", "size": 420.5, "price": 0.46, "timestamp": 1718121600, "usdcSize": 193.43, "title": "Will the Fed cut rates in September?", "slug": "fed-rate-cut-sep-2024", "icon": "https://cdn.domain.com/markets/fed.png", "eventSlug": "fomc-2024-policy", "outcome": "Yes", "outcomeIndex": 0, "name": "Macro Whale", "pseudonym": "macro.whale", "bio": "Macro strategist backing major economic events.", "profileImage": "https://cdn.domain.com/users/macro-whale.png", "profileImageOptimized": "https://cdn.domain.com/users/macro-whale@2x.jpg", "transactionHash": "0xa8b1be184ad6b5a219d121935e7b4f6a1cb5df38e7b74d2880aed672541da831" }, { "proxyWallet": "0x56687bF447db6fFa42FfE2204a05edAa20f55839", "side": "SELL", "asset": "0x8eee3789813eead2d47db3bdf6a1c5021f564ef18e2aefc8b80b9dcd5d6f8ac5:1", "conditionId": "0x8eee3789813eead2d47db3bdf6a1c5021f564ef18e2aefc8b80b9dcd5d6f8ac5", "size": 280.75, "price": 0.51, "timestamp": 1717660800, "usdcSize": 143.18, "title": "Will turnout exceed 60% in the French election?", "slug": "france-turnout-60", "icon": "https://cdn.domain.com/markets/france-election.png", "eventSlug": "french-presidential-2024", "outcome": "No", "outcomeIndex": 1, "name": "Civic Data Fund", "pseudonym": "civic.fund", "bio": "Collective focused on political prediction markets.", "profileImage": "https://cdn.domain.com/users/civic-fund.png", "profileImageOptimized": "https://cdn.domain.com/users/civic-fund@2x.jpg", "transactionHash": "0x4ce08d5e23b884ddaf8b4691cfd04e6c4f80c378a9cfd76f4043f8197a9482cd" }]{ "error": "unknown_field: takerOnly"}{ "error": "unauthorized: ip_not_allowlisted"}{ "error": "internal_error: unexpected database failure"}