Skip to main content
GET
/
wallet
/
{walletAddress}
/
positions
Wallet Positions
curl --request GET \
  --url https://pm-t1.bxingupdate.com/bvapi/wallet/{walletAddress}/positions \
  --header 'Authorization: Bearer <token>'
{
  "wallet_address": "<string>",
  "position_count": 123,
  "positions": [
    {
      "market_title": "<string>",
      "condition_id": "<string>",
      "token_id": "<string>",
      "side": "<string>",
      "shares": 123,
      "market_slug": "<string>",
      "current_price": 123,
      "current_value": 123
    }
  ],
  "total_value": 123
}
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

FieldTypeDescription
wallet_addressstringThe queried wallet address
position_countintegerNumber of active positions
positionsarrayList of position objects
total_valuenumber | nullTotal portfolio value across all positions

Position Object

FieldTypeDescription
market_titlestringTitle of the market
condition_idstringPolymarket condition ID
token_idstringToken asset ID
sidestringPosition side (e.g. “Yes”, “No”)
sharesnumberNumber of shares held
market_slugstringMarket URL slug
current_pricenumberCurrent market price
current_valuenumberCurrent value of the position

Authorizations

Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

walletAddress
string
required

Polymarket wallet address (0x-prefixed, 40 hex chars)

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

Response

Successful Response

wallet_address
string
required

Wallet address

position_count
integer
required

Number of positions

positions
object[]
required

Position list

total_value
number | null

Total portfolio value