Skip to main content
GET
/
polymarket
/
positions
/
wallet
/
{wallet_address}
Get Positions
curl --request GET \
  --url https://api.domeapi.io/v1/polymarket/positions/wallet/{wallet_address}
{
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
  "positions": [
    {
      "wallet": "0x1234567890abcdef1234567890abcdef12345678",
      "token_id": "19701256321759583954581192053894521654935987478209343000964756587964612528044",
      "condition_id": "0xabcd1234...",
      "title": "Will Bitcoin reach $100k by end of 2025?",
      "shares": 50000000,
      "shares_normalized": 50,
      "redeemable": false,
      "market_slug": "will-bitcoin-reach-100k-by-end-of-2025",
      "event_slug": "bitcoin-price-predictions",
      "image": "https://polymarket.com/images/...",
      "label": "Yes",
      "winning_outcome": null,
      "start_time": 1640995200,
      "end_time": 1672531200,
      "completed_time": null,
      "close_time": null,
      "game_start_time": null,
      "market_status": "open",
      "negativeRisk": false
    }
  ],
  "pagination": {
    "has_more": false,
    "limit": 100,
    "pagination_key": null
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.domeapi.io/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
wallet_address
string
required

The Proxy wallet address to fetch positions for

Pattern: ^0x[0-9a-fA-F]{40}$
Example:

"0x1234567890abcdef1234567890abcdef12345678"

Query Parameters

​
limit
integer
default:100

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

Required range: 1 <= x <= 100
Example:

100

​
pagination_key
string

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

Example:

"NjhlMGM4MDAtZDkwNi00YjMyLWEzOWMtYTRlMTk5MzRkNWVl"

Response

Positions response

​
wallet_address
string
required

The wallet address (normalized to lowercase)

Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
positions
object[]
required

Array of position objects

​
pagination
object
required

Pagination information