Skip to main content
GET
Closed positions with metadata
Returns closed positions for a wallet with market metadata (title, outcome, slug) and realized P&L. Supports pagination and sorting.
Data source — read before you integrate. This endpoint uses Polymarket’s own data-api.polymarket.com/closed-positions format and wraps it with pagination metadata. Row field names are Polymarket’s names preserved as-is — so you’ll see asset (not token_id), proxy_wallet, cur_price, title (not market). Coverage follows Polymarket’s closed-position dataset; positions missing there won’t appear here.For onchain truth with our own P&L calculations and consistent field naming across the rest of the API, use /v2/wallets/{address}/positions/onchain — that endpoint returns every position the wallet has ever held (open and closed), with token_id, size, realized_pnl, and unrealized_pnl in a shape consistent with the other /v2/onchain/* endpoints.

Request

Response

Example

Authorizations

x-api-key
string
header
required

Path Parameters

address
string
required

Wallet address (0x-prefixed)

Query Parameters

limit
integer
default:10

Results per page (max 50)

Required range: 1 <= x <= 50
offset
integer
default:0

Pagination offset

Required range: x >= 0
sortBy
enum<string>
default:TIMESTAMP

Sort field

Available options:
REALIZEDPNL,
AVGPRICE,
PRICE,
TITLE,
TIMESTAMP
sortDirection
enum<string>
default:DESC

Sort direction

Available options:
ASC,
DESC
market
string

Filter by market slug

title
string

Filter by title substring

Response

Closed positions with metadata