GET/v2/user-stats

Get a user's profile stats

The profile card for one wallet in a single call. `?user=` is required. Returns `{ data: { trades, biggest_win, views, join_date, all_time_pnl } }`, or `{ data: null }` when the wallet is not a known user. **`data: null` and a row of zeros mean different things.** `null` is "no such user"; zeros are "this user exists but has never traded, never won and has no profile views".

Base URL: https://data-api.polymarket.com
Auth: Public, no key
Rate limit: 800 req / 10s (80 per second)
Limit applies to: General (all /v2 endpoints)

Things to know

Every v2 response wraps its payload in a data field. Paginated reads return an opaque cursor in pagination and do not accept offset. Under load the API answers 429 with a Retry-After header.

Parameters

Name	In	Type	Required	Description
user	query	stringnull	yes	The wallet whose profile stats to return. Required; `0x` followed by 40 hexadecimal characters.

user is listed as optional in Polymarket's OpenAPI spec, but the API returns 400 without it (checked 2026-10-04).

Example

curl -X GET "https://data-api.polymarket.com/v2/user-stats?user=<user>"

Response fields

Field	Type	Description
data

Responses

Status	Meaning
200	The wallet's profile stats, or null when it is not a known user
400	Missing or invalid 'user' address, or a 'user' that is a known protocol contract address
429	Too many requests; retry after `Retry-After`
500	Internal server error
503	Timed out (the request deadline, the datastore statement timeout, or the connection pool's acquire budget) or a serving dependency is unavailable; retry after `Retry-After`

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.