Polymarket API reference / Data API v1
GET/v1/activity/combos

Get user combo activity

**Data API v2:** this route has a v2 counterpart, `GET /v2/activity/combos`. See [Migrating to Data API v2](/migrate/data-api-v1-to-v2). Combo lifecycle and redeem events (split / merge / convert / compress / wrap / unwrap / redeem) for a user, with per-leg breakdown. The combo counterpart to /activity trade rows. Also available at /v1/data/user/{address}/activity/combos (address from the path).

Base URL
https://data-api.polymarket.com
Auth
Public, no key
Rate limit
1,000 req / 10s (100 per second)
Limit applies to
Data API general

Things to know

Data API v1 has been frozen since 4 September 2026. It still answers, but new fields and endpoints only go to v2.

Parameters

NameInTypeRequiredDescription
userquerystringyes
market_idqueryobject[]noComma-separated combo_condition_id values to filter to specific combos. These equal the market_id of isCombo rows on /activity. Omit for all of the user's combo activity.
limitqueryintegerno
offsetqueryintegerno
cursorquerystringnoOpaque continuation token from a previous response's pagination.next_cursor. When present it supersedes offset (which is ignored). Invalid, tampered, or cross-endpoint tokens return 400.

Example

curl -X GET "https://data-api.polymarket.com/v1/activity/combos?user=<user>"

Response fields

FieldTypeDescription
activityobject[]
paginationobjectStandard pagination metadata. No total count; has_more is derived from page fullness. next_cursor is opaque.

Responses

StatusMeaning
200Success
400Bad Request
401Unauthorized
500Server Error

Related endpoints

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.