v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket

Get Wallet Positions

Fetch current positions for a wallet address.

Returns all open positions with cost basis, current market prices, and P&L calculations. Supports filtering by market_slug or condition_id.

get/v2/polymarket/wallet/positions/{wallet}

Path parameters

walletstring required

Wallet address to fetch positions for

Wallet address to fetch positions for

Query parameters

include_closedboolean

Include zero-balance (closed) positions

Include zero-balance (closed) positions

min_sharesnumber

Minimum number of shares to include

Minimum number of shares to include

market_slugstring nullable

Filter by market slug

Filter by market slug

condition_idstring nullable

Filter to a specific market by condition ID

Filter to a specific market by condition ID

sort_by'value' | 'unrealized_pnl' | 'realized_pnl' | 'cost' | 'avg_price' | 'current_price' | 'entry_date'

Sort options for positions.

Field to sort by

order'asc' | 'desc'

Sort order direction enum.

Sort order: asc or desc

limitinteger

Maximum number of positions to return (1-200)

Maximum number of positions to return (1-200)

pagination_keystring nullable

Cursor for pagination

Cursor for pagination

Response

Successful Response

wallet_addressstring required