Closed positions with metadata
Closed Positions
Paginated list of closed positions with full metadata and P&L.
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
Path Parameters
Wallet address (0x-prefixed)
Query Parameters
Results per page (max 50)
Required range:
1 <= x <= 50Pagination offset
Required range:
x >= 0Sort field
Available options:
REALIZEDPNL, AVGPRICE, PRICE, TITLE, TIMESTAMP Sort direction
Available options:
ASC, DESC Filter by market slug
Filter by title substring
Response
Closed positions with metadata

