Skip to main content
Alpha — This endpoint is part of the Prediction Markets API, currently in early access. May change without notice.

​
Query Parameters

​
wallet
string
required
The wallet address to get positions for.
​
platforms
string
Comma-separated list of platforms to filter by.
​
status
string
Position status filter: active, resolved, or all.
​
sortBy
string
default:"amountUSD"
Sort order: amountUSD, totalPnlUSD, or createdAt.
​
limit
number
default:"50"
Number of positions to return (1 to 100).
​
offset
number
default:"0"
Pagination offset.

​
Response

​
data
array
Array of wallet positions.
​
wallet
object | null
Wallet metadata (fundingInfo, entity, labels). Null when unavailable.
​
pagination
object
Pagination metadata.
​
hostname
string
Server node identifier.
​
took
number
Request processing time in milliseconds.

​
Usage Example

curl -X GET "https://api.mobula.io/api/2/wallet/pm/positions?wallet=0xYourWalletAddress&status=active"

​
Example Response

{
  "data": [
    {
      "platform": "polymarket",
      "market": {
        "marketId": "0x1234...",
        "question": "Will ETH reach $10,000 by end of 2026?",
        "category": "crypto",
        "status": "active",
        "logo": "https://polymarket.com/images/market.png",
        "endDate": "2026-12-31T23:59:59.000Z"
      },
      "outcomeId": "71321...",
      "label": "Yes",
      "balance": 100,
      "costBasisUSD": 35,
      "avgBuyPriceUSD": 0.35,
      "avgSellPriceUSD": null,
      "priceUSD": 0.42,
      "amountUSD": 42,
      "unrealizedPnlUSD": 7,
      "unrealizedPnlPercent": 20,
      "realizedPnlUSD": 0,
      "totalPnlUSD": 7,
      "totalFeesPaidUSD": 0.12,
      "buys": 2,
      "sells": 0,
      "volumeBuyUSD": 35,
      "volumeSellUSD": 0,
      "firstDate": "2026-02-01T10:00:00.000Z",
      "lastDate": "2026-02-15T14:30:00.000Z",
      "labels": []
    }
  ],
  "wallet": null,
  "pagination": {
    "page": 1,
    "offset": 0,
    "limit": 50,
    "pageEntries": 1
  },
  "hostname": "node-xyz",
  "took": 42
}