List combo activity

Keyset-paginated combo lifecycle + redemption feed for a user, in the standard { data, pagination } envelope.

Pass ?cursor= from a prior response’s next_cursor to fetch the next page. Unlike the activity feed, the anchor behind the cursor is (block_number, log_index); this endpoint’s total order.

A malformed condition combo condition id is a 400 naming the value; a well-formed one that matches nothing serves an empty data array, which is the meaningful zero-state.

GET /v2/activity/combos

List combo activity

cURL

curl --request GET \
  --url https://data-api.polymarket.com/v2/activity/combos \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "block_number": 123,
      "combo_condition_id": "<string>",
      "combo_position_id": "<string>",
      "id": "<string>",
      "legs": [
        {
          "leg_condition_id": "<string>",
          "leg_current_price": 123,
          "leg_index": 123,
          "leg_outcome_index": 123,
          "leg_outcome_label": "<string>",
          "leg_position_id": "<string>",
          "leg_status": "<string>",
          "market": {
            "category": "<string>",
            "end_date": "<string>",
            "event": {
              "event_id": "<string>",
              "event_image": "<string>",
              "event_slug": "<string>",
              "event_title": "<string>"
            },
            "icon_url": "<string>",
            "image_url": "<string>",
            "market_id": "<string>",
            "outcome": "<string>",
            "slug": "<string>",
            "subcategory": "<string>",
            "tags": [
              "<string>"
            ],
            "title": "<string>",
            "group_item_title": "<string>",
            "line": 123,
            "outcomes": [
              "<string>"
            ],
            "question": "<string>",
            "sports_market_type": "<string>"
          },
          "leg_resolved_at": "<string>"
        }
      ],
      "proxy_wallet": "<string>",
      "timestamp": 123,
      "transaction_hash": "<string>",
      "type": "<string>",
      "amount_usdc": 123,
      "payout_usdc": 123
    }
  ],
  "pagination": {
    "has_more": true,
    "limit": 1,
    "offset": 1,
    "next_cursor": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

user · string | null

Required; the feed is user-anchored.

limit · integer<int32> | null

First-page size. Ignored when cursor is supplied.

Required range: 0 <= x <= 1000

cursor · string | null

Opaque pagination cursor from a prior response's next_cursor.

condition · string | null

Combo condition id(s), comma-separated (at most 20 distinct values). condition_id / conditionId are accepted aliases.

Response

200

application/json

A page of combo activity

{ data, pagination } envelope for /v2/activity/combos.

data · object[] · required

The page's rows.

Show child attributes

pagination · object · required

Paging envelope: follow next_cursor until null.

Show child attributes