/polymarket/trader/pnl/{address}/positions
GET /polymarket/trader/pnl/{address}/positions is an endpoint of the Polymarket API by Struct API, listed on Proxygate by Struct. Get trader position PnL AI agents call it per request through a transparent proxy and pay $0.0010 per request in USDC on Solana, with no subscription and no API key to manage.
$0.0010 / request
GET
USDC on Solana
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| won | boolean | No | Filter by outcome: true (won), false (lost), only for status=closed |
| limit | integer | No | Results limit (default: 10, max: 200) |
| offset | integer | No | Row-skip offset (max: 3500). Takes precedence over pagination_key when both are set. |
| search | string | No | Search by market title |
| status | string | Yes | Required. Filter by position status |
| sort_by | string | No | Sort field (default: realized_pnl_usd) |
| min_shares | number | No | Minimum shares balance to include. Status filtering already treats balances below 0.01 shares as dust. |
| market_slug | string | No | Filter by market slug (alternative to condition_id) |
| position_id | string | No | Filter by specific outcome token (position ID) |
| condition_id | string | No | Filter by market condition ID (or use market_slug) |
| pagination_key | string | No | Opaque cursor from a previous response. Pass verbatim for the next page. |
| sort_direction | string | No | Sort direction: asc, desc (default: desc) |
Call /polymarket/trader/pnl/{address}/positions with an AI agent
# Call this endpoint with the Proxygate CLI
proxygate proxy polymarket-api-by-struct /polymarket/trader/pnl/{address}/positions -X GET// Call it from an AI agent over the Proxygate MCP server
call_api({
listing_id: "7742c7e4-1afe-483b-bdd6-e78dfc527a0e",
method: "GET",
path: "/polymarket/trader/pnl/{address}/positions"
})Polymarket API by Struct /polymarket/trader/pnl/{address}/positions: frequently asked questions
Get trader position PnL
It costs $0.0010 per request, settled in USDC on Solana. There is no subscription and no monthly minimum: an agent pays per call from a single prepaid balance.
The agent calls GET /polymarket/trader/pnl/{address}/positions through the Proxygate gateway with the Proxygate CLI, SDK, or MCP server. Proxygate routes the request to the upstream provider, injects the provider key server-side, and returns the response with a signed receipt.
No. The upstream provider key never leaves the Proxygate gateway. Your agent authenticates once to Proxygate; the key is injected server-side per request and is never shared with or exposed to the agent.