Skip to main content
GET
/
v1
/
polymarket
/
wallet
/
positions
/
{wallet_address}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/wallet/positions/0x1234...?sort_by=value&limit=50"

{
  "wallet_address": "0x1234567890abcdef...",
  "positions": [
    {
      "market": {
        "condition_id": "0x1a2b3c4d...",
        "market_slug": "will-donald-trump-win-the-2024-us-presidential-election",
        "title": "Will Donald Trump win the 2024 Presidential Election?",
        "side": "YES",
        "token_id": "21742633...",
        "status": "open"
      },
      "position": {
        "shares": 1500.0,
        "avg_entry_price": 0.42,
        "total_cost_usd": 630.0
      },
      "current": {
        "price": 0.62,
        "value_usd": 930.0
      },
      "pnl": {
        "unrealized_usd": 300.0,
        "unrealized_pct": 47.62,
        "realized_usd": 0.0
      }
    }
  ],
  "summary": {
    "total_positions": 15,
    "total_value_usd": 12500.00,
    "total_cost_usd": 10000.00,
    "total_unrealized_pnl_usd": 2500.00,
    "total_realized_pnl_usd": 1200.00
  },
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 15,
    "has_more": false
  }
}

​
Overview

Fetch all current positions for a wallet address, including cost basis, current value, and P&L calculations. Supports filtering by market, share size, and status.
​
wallet_address
string
required
Wallet address to fetch positions for
​
include_closed
boolean
default:"true"
Include zero-balance (closed) positions
​
min_shares
number
default:"0"
Minimum number of shares to include
​
condition_id
string
Filter to a specific market by condition ID
​
sort_by
string
default:"value"
Sort by: value, unrealized_pnl, realized_pnl, or cost
​
order
string
default:"desc"
Sort order: asc or desc
​
limit
integer
default:"100"
Maximum positions to return (1-500)
​
offset
integer
default:"0"
Positions to skip for pagination
​
wallet_address
string
The queried wallet address
​
positions
array
​
summary
object
​
pagination
object
Standard pagination object
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/wallet/positions/0x1234...?sort_by=value&limit=50"

{
  "wallet_address": "0x1234567890abcdef...",
  "positions": [
    {
      "market": {
        "condition_id": "0x1a2b3c4d...",
        "market_slug": "will-donald-trump-win-the-2024-us-presidential-election",
        "title": "Will Donald Trump win the 2024 Presidential Election?",
        "side": "YES",
        "token_id": "21742633...",
        "status": "open"
      },
      "position": {
        "shares": 1500.0,
        "avg_entry_price": 0.42,
        "total_cost_usd": 630.0
      },
      "current": {
        "price": 0.62,
        "value_usd": 930.0
      },
      "pnl": {
        "unrealized_usd": 300.0,
        "unrealized_pct": 47.62,
        "realized_usd": 0.0
      }
    }
  ],
  "summary": {
    "total_positions": 15,
    "total_value_usd": 12500.00,
    "total_cost_usd": 10000.00,
    "total_unrealized_pnl_usd": 2500.00,
    "total_realized_pnl_usd": 1200.00
  },
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 15,
    "has_more": false
  }
}

​
Position Status

StatusDescriptionCurrent Price
openMarket still tradingLive market price
resolved_winUser’s side won1.00
resolved_lossUser’s side lost0.00

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get your free key at dashboard.predexon.com

Path Parameters

​
wallet_address
string
required

Wallet address to fetch positions for

Query Parameters

​
include_closed
boolean
default:true

Include zero-balance (closed) positions

​
min_shares
number
default:0

Minimum number of shares to include

Required range: x >= 0
​
condition_id
string | null

Filter to a specific market by condition ID

​
sort_by
enum<string>
default:value

Field to sort by

Available options:
value,
unrealized_pnl,
realized_pnl,
cost
​
order
enum<string>
default:desc

Sort order: asc or desc

Available options:
asc,
desc
​
limit
integer
default:100

Maximum number of positions to return

Required range: 1 <= x <= 500
​
offset
integer
default:0

Number of positions to skip for pagination

Required range: x >= 0

Response

Successful Response

Wallet positions endpoint response.

​
wallet_address
string
required
​
positions
Position · object[]
required
​
summary
PositionsSummary · object
required

Summary of all positions.

​
pagination
Pagination · object
required

Offset-based pagination model.