Wallet Positions
Wallet
Wallet Positions
Fetch Polymarket positions for any wallet address.
Requires API key in Authorization header (rate limited: 60/minute). Cached for 30s per wallet to prevent heavy pollers from saturating the API.
GET
Wallet Positions
Fetch Polymarket positions for any wallet address.
Overview
This endpoint retrieves all current positions held by a specific wallet address on Polymarket. It returns a structured summary including each position’s market title, side, shares, current price, and value.Rate Limiting
- 60 requests per minute per API key
- 30-second cache per wallet address to prevent heavy pollers from saturating the API
Response Fields
| Field | Type | Description |
|---|---|---|
wallet_address | string | The queried wallet address |
position_count | integer | Number of active positions |
positions | array | List of position objects |
total_value | number | null | Total portfolio value across all positions |
Position Object
| Field | Type | Description |
|---|---|---|
market_title | string | Title of the market |
condition_id | string | Polymarket condition ID |
token_id | string | Token asset ID |
side | string | Position side (e.g. “Yes”, “No”) |
shares | number | Number of shares held |
market_slug | string | Market URL slug |
current_price | number | Current market price |
current_value | number | Current value of the position |
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Polymarket wallet address (0x-prefixed, 40 hex chars)
Pattern:
^0x[a-fA-F0-9]{40}$