GET/v2/value

Get portfolio value

The user's portfolio value: single-market holdings marked to market plus unresolved combo positions at cost basis. `?user=` is required (400 otherwise). `?condition=` (CSV of `condition_id`) scopes the single-market term, and any condition filter excludes the portfolio-level combo term. `data` is a single object; a user with no positions yields `{ "data": { "proxy_wallet": …, "value": 0 } }`.

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 portfolio value to return. Required.
condition	query	stringnull	no	Comma-separated `condition_id`s (at most 20 distinct values); omit for the full portfolio.

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/value?user=<user>"

Response fields

Field	Type	Description
proxy_wallet	string	The wallet the value was computed for.
value	number	Portfolio value in USDC, rounded to 4 decimals: holdings marked to market plus non-terminal combos at cost basis.

Responses

Status	Meaning
200	Portfolio value for the user
400	Missing or empty 'user', a malformed 'condition' id, or a 'user' that is a known protocol contract address
429	Service is at heavy-query capacity; 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`

Related endpoints

GET /value Data API v1

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.