/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.