Polymarket — List account activity
polymarket_get_v2_activityKeyset-paginated activity feed (trades, splits, merges, Uses the caller's OpenAny gateway credentials. Charges and authorization are determined by the gateway.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Window end, epoch seconds (inclusive); omitted or `0` means now plus one day. | |
| side | No | BUY or SELL. | |
| type | No | Activity type(s), comma-separated. Accepted values: `TRADE`, `SPLIT`, `MERGE`, `REDEEM` (automatic redemptions included), `CONVERSION`, `MIGRATION`, `REWARD`, `YIELD`, `MAKER_REBATE`, `TAKER_REBATE`, `REFERRAL_REWARD`, `DEPOSIT`, `WITHDRAWAL`, `TIP`. Any other value is rejected with `400`. Omitted, the feed returns every type except `TIP`. `DEPOSIT` and `WITHDRAWAL` rows are returned only with `exclude_deposits_withdrawals=false`. Under its default (`true`) they are dropped even when named here, so `type=DEPOSIT` or `type=WITHDRAWAL` alone returns an empty page. `TIP` is **opt-in**: it is never in the default set, so it is only returned when you name it here. A tip is a user↔user pUSD transfer that is not a trade-settlement leg; `size` is the amount and `side` carries the direction (`IN` received / `OUT` sent). | |
| user | Yes | Required; the feed is user-anchored. This execution profile requires an explicit non-null value. The original optional/nullable OpenAPI declarations remain in officialOperation. | |
| limit | No | Page size; default 100, max 1000, past-cap rejected. | |
| start | No | Window start on `block_timestamp`, epoch seconds (inclusive). Omitted or `0` floors to three years back; pass `start=1` for full history. | |
| cursor | No | Opaque cursor from a prior response's `next_cursor`; binds the sort direction it was minted under. | |
| sort_by | No | Only `TIMESTAMP` is supported (v2 pages by keyset). | |
| event_id | No | Gamma event id(s), comma-separated (at most 20 distinct values); resolves to the events' markets. Mutually exclusive with `condition`. | |
| condition | No | Condition id(s), comma-separated (at most 20 distinct values). `condition_id` / `conditionId` are accepted aliases. | |
| sort_direction | No | `ASC` or `DESC` (default). The keyset seeks in the chosen direction; the minted cursor binds it, so pass it consistently when paging. | |
| exclude_deposits_withdrawals | No | Defaults to `true`, which drops `DEPOSIT` and `WITHDRAWAL` rows from the page, including when `type` names them. Pass `false` to include them. |