↑ ↓ move · Enter open · Esc close

REST API / Polymarket / Wallet Activity

Wallet Activity (Polymarket)

Complete activity feed for a Polymarket wallet - every TRADE, SPLIT, MERGE, REDEEM, CONVERSION, and REWARD event in one clean, consistent schema.

GET/v2/polymarket/activity

Parameters

userstring (query)required

Wallet address - must match ^0x[a-fA-F0-9]{40}$.

typestring

Optional. Filter to a single event type: TRADE | SPLIT | MERGE | REDEEM | CONVERSION | REWARD.

marketstring

Optional. Filter to a single market by condition_id.

limitinteger

Optional. Page size (default 100, max 500).

offsetinteger

Optional. Page offset (default 0).

Response

userstring

Wallet address (lowercased).

limitinteger

Page size returned (max 500).

offsetinteger

Page offset.

countinteger

Number of activity rows returned in this page.

has_moreboolean

True when count == limit, indicating another page may exist. Use offset += limit to fetch the next page.

activityarray

Per-event records with a clean, consistent snake_case schema.

Show 10 fields
proxy_walletstring

Polymarket proxy wallet that performed the action.

condition_idstring

Market condition ID.

typestring

TRADE | SPLIT | MERGE | REDEEM | CONVERSION | REWARD.

outcomestring

Outcome label (e.g. "Yes").

outcome_indexinteger

Outcome index in the market.

usdc_sizenumber

USDC amount of the event.

fee_amountnumber

Taker fee paid for this event in USDC.

bonus_amountnumber

Bonus/incentive amount, if any.

transaction_hashstring

Polygon tx hash.

timestampinteger

Unix seconds of the event.

_metaobject

Source and cache metadata.

Show 3 fields
sourcestring

Data source identifier.

cachestring

hit | miss - whether the response was served from the low-latency cache or freshly resolved.

cache_secondsinteger

Cache window in seconds.

Full API response