Skip to main content
GET
Get trades for a user or markets

Query Parameters

limit
integer
default:100

Page size. Values above the maximum are clamped to 10000.

Required range: 0 <= x <= 10000
offset
integer
default:0

Starting index for pagination. Requests past the cap are rejected with a 400 (never silently clamped). To read history deeper than offset 10000, page inside start/end windows — each window has its own offset budget.

Required range: 0 <= x <= 10000
takerOnly
boolean
default:true
filterType
enum<string>

Must be provided together with filterAmount.

Available options:
CASH,
TOKENS
filterAmount
number

Must be provided together with filterType.

Required range: x >= 0
market
string[]

Comma-separated list of condition IDs. Mutually exclusive with eventId.

0x-prefixed 64-hex string

Pattern: ^0x[a-fA-F0-9]{64}$
eventId
integer[]

Comma-separated list of event IDs. Mutually exclusive with market.

Required range: x >= 1
user
string

User Profile Address (0x-prefixed, 40 hex chars)

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

side
enum<string>
Available options:
BUY,
SELL
start
integer

Lower-bound timestamp (epoch seconds) for the trade window. Omit or pass 0 for the default window (most recent ~3 years); pass a positive epoch (e.g. 1) to retrieve full history on user-scoped requests. Market/event-scoped requests keep the ~3-year floor — start can only narrow their window, not extend it.

Required range: x >= 0
end
integer

Upper-bound timestamp (epoch seconds) for the trade window. Omit for the default (current time); rows newer than end are excluded.

Required range: x >= 0

Response

Success

proxyWallet
string

User Profile Address (0x-prefixed, 40 hex chars)

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

side
enum<string>
Available options:
BUY,
SELL
asset
string
conditionId
string

0x-prefixed 64-hex string

Pattern: ^0x[a-fA-F0-9]{64}$
Example:

"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"

size
number
price
number
timestamp
integer<int64>
title
string
slug
string
icon
string

Market artwork. Falls back to the market image, then to the parent event's icon and image, when the market has no icon of its own.

eventSlug
string
outcome
string
outcomeIndex
integer
name
string
pseudonym
string
bio
string
profileImage
string
profileImageOptimized
string
transactionHash
string