Get wallet activity feed

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^0x[a-fA-F0-9]{40}$

Wallet address (0x + 40 hex). Kalshi addresses return 400.

Query Params
string

Comma-separated list of condition ids (0x + 64 hex). Up to 50 entries.
Mutually exclusive with eventId.

string

Comma-separated list of Polymarket numeric event ids. Up to 50 entries.
Mutually exclusive with market.

string

Comma-separated list of event types to include. Up to 8 entries from the
PredictionActivityType enum.

string
enum

Filter trade-type rows by direction. Non-trade rows always have
side = null and are unaffected.

Allowed:
integer
0 to 4102444800

Inclusive lower bound on event timestamp, in unix-seconds. Values that
look like milliseconds (~13 digits) are rejected with 400.

integer
0 to 4102444800

Inclusive upper bound on event timestamp, in unix-seconds. Must be
start when both are provided.

string
enum

Sort key. Defaults to TIMESTAMP.

Allowed:
string
enum

Sort direction. Defaults to DESC.

Allowed:
integer
1 to 500
Defaults to 100

Page size. Defaults to 100.

integer
0 to 10000
Defaults to 0

Page offset. Defaults to 0.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json