Skip to main content
GET
Get a user's trades and on-chain activities

Authorizations

Authorization
string
header
required

Raw database-backed API key.

Query Parameters

user
string
required

A 20-byte 0x wallet address, @username, or bare Polymarket username.

Required string length: 1 - 255
types
string

Comma-separated activity types. Omit to include every supported type. Supported types are trade, split, merge, redeem, conversion

Pattern: ^(trade|split|merge|redeem|conversion)(,(trade|split|merge|redeem|conversion))*$
market_id
string

Restrict results by up to 20 comma-separated selectors: market slugs, 0x-prefixed condition IDs, decimal outcome token IDs, or category:<dotted-slug>. Mixed selectors are ORed. Exact market identifiers do not expand to grouped markets; category parents include descendants through inherited category membership.

Maximum string length: 5299
token_id
string

Restrict results to one decimal outcome token ID.

Pattern: ^[0-9]+$
from
string<date-time>

Inclusive RFC3339 activity timestamp lower bound.

to
string<date-time>

Exclusive RFC3339 activity timestamp upper bound. Must be after from when both are supplied.

limit
integer
default:50
Required range: 1 <= x <= 100
cursor
string

Opaque cursor returned by the previous page.

Response

A curated page of user activity.

user_address
string
required

Canonical lowercase data address after user resolution.

Pattern: ^0x[0-9a-f]{40}$
activities
object[]
required
page
object
required