v1

latestOpenAPI 3.0.32026-07-2618063.1 KB

Get Positions

Fetches all Polymarket positions for a proxy wallet address. Returns positions with balance >= 10,000 shares (0.01 normalized) with market info.

get/polymarket/positions/wallet/{wallet_address}

Query parameters

limitinteger

Example:100

Maximum number of positions to return per page. Defaults to 100, maximum 100.

pagination_keystring

Example:NjhlMGM4MDAtZDkwNi00YjMyLWEzOWMtYTRlMTk5MzRkNWVl

Pagination key returned from previous request to fetch next page of results

Response

Positions response

wallet_addressstring required

The wallet address (normalized to lowercase)

Example response

{
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
  "positions": [
    {
      "wallet": "0x1234567890abcdef1234567890abcdef12345678",
      "token_id": "19701256321759583954581192053894521654935987478209343000964756587964612528044",
      "condition_id": "0x1234abcd...",
      "title": "Will Bitcoin reach $100k by end of 2025?",
      "shares": 50000000,
      "shares_normalized": 50,
      "market_slug": "will-bitcoin-reach-100k-by-end-of-2025",
      "event_slug": "bitcoin-price-predictions",
      "image": "https://polymarket.com/images/...",
      "label": "Yes",
      "winning_outcome": {
        "id": "19701256321759583954581192053894521654935987478209343000964756587964612528044",
        "label": "Yes"
      },
      "start_time": 1640995200,
      "end_time": 1672531200,
      "close_time": 1672531200,
      "game_start_time": "2025-01-15T19:00:00Z",
      "market_status": "open"
    }
  ],
  "pagination": {
    "limit": 100
  }
}