/v4/data/prediction/wallets/{address}/trades

100 credits per API call

Trade-only fills for a wallet — one row per trade, with the buy/sell side, outcome metadata, size, price, transaction hash, and the trader's profile fields (display name, profile image). Trade-only — does not include non-trade events like splits, merges, redemptions or rewards (use /wallets/{address}/activity for the full feed).

Platform support

• Polymarket only. Kalshi wallets return 400.

Filtering and pagination

• market / eventId scope the response (mutually exclusive, up to 50 entries each).
• side filters to BUY or SELL trades.
• takerOnly defaults to true — set to false to include maker-side fills.
• filterType and filterAmount set a minimum trade size threshold. filterType=CASH filters by USDC notional; filterType=TOKENS filters by outcome-token count. Both must be provided together — passing one without the other returns 400.
• Pagination is offset-based — limit (1..10000, default 100) and offset (0..10000, default 0). The upstream feed enforces a hard cap at offset = 3000; calls past that point return an empty page rather than an error.

Other notes

• address is normalised to lowercase before being echoed in the response (every row's proxyWallet).
• timestamp is unix-seconds (not milliseconds).
• side uses the trade-direction vocabulary (BUY / SELL) — distinct from the outcome-side vocabulary (yes / no) used by /markets/{id}/trades.