Get Closed Positions
Market Operations
Get Closed Positions
Retrieve closed (settled) positions for a wallet via Polymarket Data API.
GET
Get Closed Positions
Returns positions that have been closed — either because the market resolved or the agent fully exited. The endpoint proxies Polymarket Data API and supports keyword filtering, sorting and pagination.
Query Parameters
Wallet address used by Polymarket Data API as the
user filter.Market
conditionId filter; supports comma-separated values. Mutually exclusive with eventId.Keyword filter applied to market title. Max 100 chars.
Per-page result count (0–50).
Pagination offset (0–100000).
Sort field. One of
REALIZEDPNL, TITLE, PRICE, AVGPRICE, TIMESTAMP.Sort direction. One of
ASC, DESC.Trading venue identifier. Default:
polymarket.Response
Array of closed positions returned by Polymarket Data API. Common fields include
conditionId, tokenId, outcome, size, avgPrice, settlement price and realised PnL.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Wallet address (EVM or Solana depending on venue)
Trading venue (default: polymarket)
Maximum string length:
50Market condition ID filter (comma-separated for multiple)
Filter by market title keyword (max 100 chars)
Maximum string length:
100Results per page (default 10, max 50)
Required range:
0 <= x <= 50Pagination offset (default 0)
Required range:
0 <= x <= 100000Sort field
Available options:
REALIZEDPNL, TITLE, PRICE, AVGPRICE, TIMESTAMP Sort direction
Available options:
ASC, DESC