Wallet Combo Activity

Returns combo lifecycle activity for a wallet. This is the combo-only counterpart to wallet splits, merges, redemptions, and lifecycle activity.

Owner addresses. Pass an owner EOA as the wallet address and the response combines the EOA’s Polymarket wallets (Safe, proxy, deposit wallets) that have data for this endpoint. Passing a Safe, proxy or deposit wallet returns just that wallet, as before. Combined responses list the combined wallets in wallets. See Owner addresses.

Request

GET /v3/wallets/{address}/combos/activity

Query parameters

Parameter	Type	Default	Description
`market_id`	string	—	Alias for `condition_id`
`condition_id`	string	—	Combo condition ID
`position_id`	string	—	Combo position ID
`event_kind`	string	—	Filter by event kind, for example `PositionsSplit` or `PositionRedeemed`
`limit`	integer	100	Results per page, max 300
`offset`	integer	0	Pagination offset

Example

curl "https://api.polynode.dev/v3/wallets/0x63613e3b96f418332d43cd2af8dc321014d15907/combos/activity?limit=2"

{
  "address": "0x63613e3b96f418332d43cd2af8dc321014d15907",
  "activity": [
    {
      "position_type": "combo",
      "event_kind": "PositionsSplit",
      "side": "Split",
      "user_address": "0x63613e3b96f418332d43cd2af8dc321014d15907",
      "combo_condition_id": "0x03d98f6ac4c108c5ca66f79f34908a1d820000000000000000000000000000",
      "combo_position_id": "1741334187009265192213210063949860811096650382021683265628751751539647840256",
      "amount_usdc": "0.050750",
      "tx_hash": "0xf3a8985f04bf869483ef4163a185f296c834eb827b5e5ae3db5bd44558121d51",
      "log_index": 890,
      "block_number": 88276713,
      "timestamp": 1781120055,
      "legs": [
        {
          "leg_index": 0,
          "leg_position_id": "547325449395903582555711510844460161809002726131102493368605951180083822592"
        }
      ]
    }
  ],
  "rows_returned": 2,
  "has_more": true,
  "position_type": "combo",
  "source": "v3.wallet_combos.activity"
}

Response fields

Field	Type	Description
`event_kind`	string	Public lifecycle event kind
`side`	string	Human-readable lifecycle side, such as `Split` or `Merge`
`combo_condition_id`	string	Combo condition ID
`combo_position_id`	string	Combo position ID
`amount_usdc`	string	Amount formatted in USDC
`payout_usdc`	string or null	Redemption payout formatted in USDC when the activity is a redeem
`tx_hash`	string	Polygon transaction hash
`block_number`	integer	Polygon block number
`timestamp`	integer	Unix timestamp in seconds
`legs`	array	Leg position IDs involved in the lifecycle event

Owner address fields

Present only when you pass an owner EOA. See Owner addresses.

Field	Type	Description
`wallets`	array	The combined wallets, in a fixed order, each `{wallet, type}` with `type` one of `eoa`, `safe`, `proxy`, or `deposit_wallet`
`activity[].wallet`	string	The wallet this row belongs to

Redemption semantics

Combo redemptions are normalized to match Polymarket’s public combo activity shape. Router and auto-redeemer paths are returned as event_kind: "PositionRedeemed" with side: "Redeem" and the underlying module kind, such as Combinatorial, Binary, or NegRisk. The raw router/auto-redeemer contract path is used internally for indexing but is not the public event kind. When leg metadata is available, redemption rows include resolved leg statuses and leg_current_price values in the legs array. For terminal-versus-partial redemption evidence—and the reduced/residual condition IDs needed to identify a three-leg combo becoming a two-leg combo—use Wallet Combo Redemptions.

Overview

V3 Data API

Wallet P&L

Wallet Activity

Credits

Identity

Fees

Combos

Rewards

Markets & Search

Orderbook

Leaderboard & Tags

Builders

Polymarket Profiles

Global

Tokens

Perps

Perps Market Data

Perps Wallets

Perps Analytics

Perps On-Chain

Perps Streaming

Crypto

Sports

BYOL

Backtesting

Market Card

System

Search & Context

Onchain V2 (legacy)

Wallet Combo Activity

Request

Query parameters

Example

Response fields

Owner address fields

Redemption semantics

​Request

​Query parameters

​Example

​Response fields

​Owner address fields

​Redemption semantics

Request

Query parameters

Example

Response fields

Owner address fields

Redemption semantics