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

100 credits per API call

Full wallet event feed — covers every event type the upstream emits: TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION, MAKER_REBATE and REFERRAL_REWARD. Unlike /wallets/{address}/trades, this endpoint includes non-trade events and supports a native time-range filter — useful for activity logs, audit trails and tax exports.

Platform support

• Polymarket only. Kalshi wallets return 400.

Filtering, sorting and pagination

• market / eventId scope the response (mutually exclusive, up to 50 entries each).
• type is a comma-separated list of event types — up to 8 entries from the enum.
• side filters to BUY or SELL (relevant for trade-type rows; null on non-trade rows).
• start / end are unix-seconds (not milliseconds) — values that look like millisecond timestamps (~13 digits) are rejected with 400. end must be greater than or equal to start.
• sortBy accepts TIMESTAMP, TOKENS, CASH. Defaults to TIMESTAMP. Combine with sortDirection (defaults to DESC).
• Pagination is offset-based — limit (1..500, default 100) and offset (0..10000, default 0).

Other notes

• side is null on non-trade rows (e.g. REWARD, SPLIT, MERGE, REDEEM) — direction is undefined there.
• outcomeIndex can be null for rows that don't map to a position side. A sentinel value of 999 is occasionally emitted by the upstream for the same case.
• conditionId and asset can be null on rows that aren't market-scoped (e.g. some reward / referral rows).
• address is normalised to lowercase before being echoed in the response.