Wallet Combo Trades

List confirmed combo fills for one wallet with side, size, price, role, counterparty, and transaction data.

Returns confirmed combo fills where the requested wallet participated as maker or taker. Use this endpoint for combo-only trade history.

For the same fills before confirmation, subscribe to the combo_execution WebSocket event.

Request

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

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
side	string	—	BUY, SELL, or all
limit	integer	100	Results per page, max 300
offset	integer	0	Pagination offset

Example

curl -H "x-api-key: $POLYNODE_API_KEY" \
  "https://api.polynode.dev/v3/wallets/0x0d8b4fb38999aaf7658df758f3587d25fe7fd417/combos/trades?limit=2"

{
  "address": "0x0d8b4fb38999aaf7658df758f3587d25fe7fd417",
  "trades": [
    {
      "position_type": "combo",
      "wallet_role": "maker",
      "wallet_address": "0x0d8b4fb38999aaf7658df758f3587d25fe7fd417",
      "counterparty_address": "0xe3333700ca9d93003f00f0f71f8515005f6c00aa",
      "combo_condition_id": "0x03af499212591cdbfd21ab04df07b8fb720000000000000000000000000000",
      "condition_id": "0x03af499212591cdbfd21ab04df07b8fb720000000000000000000000000000",
      "position_id": "1666644547653825639538654505467109608411697937035881104213580452779446501376",
      "side": "BUY",
      "price": "0.5700",
      "size": "40.350877",
      "fee": "0.494500",
      "tx_hash": "0xf4f973bcca17c05081574c36183a5f61fae8eb5895a2d46d71aaadb3cf11e556",
      "log_index": 549,
      "block_number": 91404731,
      "timestamp": 1785812123
    },
    {
      "position_type": "combo",
      "wallet_role": "taker",
      "wallet_address": "0x0d8b4fb38999aaf7658df758f3587d25fe7fd417",
      "counterparty_address": "0xe2315b15280fc49bc6e60eaaeea30c0df64493a5",
      "combo_condition_id": "0x03af499212591cdbfd21ab04df07b8fb720000000000000000000000000000",
      "condition_id": "0x03af499212591cdbfd21ab04df07b8fb720000000000000000000000000000",
      "position_id": "1666644547653825639538654505467109608411697937035881104213580452779446501377",
      "side": "BUY",
      "price": "0.4300",
      "size": "40.350877",
      "fee": "0.000000",
      "tx_hash": "0xf4f973bcca17c05081574c36183a5f61fae8eb5895a2d46d71aaadb3cf11e556",
      "log_index": 539,
      "block_number": 91404731,
      "timestamp": 1785812123
    }
  ],
  "rows_returned": 2,
  "has_more": true,
  "position_type": "combo",
  "source": "v3.wallet_combos.trades"
}

Response fields

Field	Type	Description
position_type	string	Always combo
wallet_role	string	Requested wallet’s role for this fill: maker or taker
wallet_address	string	Requested wallet
counterparty_address	string	Counterparty for this fill; this can be ExchangeV3 for the taker order
combo_condition_id	string	Combo condition ID
condition_id	string	Alias of combo_condition_id
position_id	string	YES or NO combo position filled
side	string	Signed order maker’s BUY or SELL direction
price	string	Actual fill price
size	string	Combo shares filled
fee	string	Fee in USDC
tx_hash	string	Polygon transaction hash
log_index	integer	Log index within the transaction
block_number	integer	Polygon block number
timestamp	integer	Unix timestamp in seconds

Maker and taker roles

One combo match contains multiple signed orders, so the requested wallet can appear in more than one row for the same transaction. In the example, the wallet is the maker of the YES taker order and the taker/counterparty of the complementary NO maker order.

The static API projects each receipt fill from the requested wallet’s point of view. The WebSocket preserves the underlying signed-order view directly: trades[].maker, trades[].taker, and trades[].side describe that order, while top-level taker_* fields identify the transaction’s taker order.

The static endpoint does not currently return order_hash or amount_usdc. Both are present on pending WebSocket trade rows; correlate the two surfaces with tx_hash, position_id, side, price, and size.