Positions

​

Reading positions

GET /api/me/positions
X-Api-Key: ps_live_<keyId>_<secret>  # integrators — needs `portfolio:read`

[
  {
    "marketId": "UAE-CUP-FINAL-20260425",
    "outcome": "0",
    "quantity": "250",
    "avgCost": "0.5140",
    "currentPrice": "0.5140",
    "realizedPnl": "0",
    "unrealizedPnl": "0"
  }
]

​

Field semantics

• quantity — net long position in outcome-share units (decimal string at the same 6-decimal scale as USDC face value). E.g. "250" = 250 full outcome shares; "250.500000" = 250.5 shares. When a market resolves YES, every YES share redeems for 1 USDC, so this number is also your maximum payout if the outcome wins. Sum of BUY quantity minus SELL quantity over trades.
• avgCost — weighted average cost basis over retained quantity (decimal USDC).
• currentPrice — present MVP value: same as avgCost.
• realizedPnl / unrealizedPnl — 0 in the MVP.

​

Split / Merge

​

Split — USDC → full outcome set

POST /api/vault/split-signature
{
  "marketId": "UAE-CUP-FINAL-20260425",
  "amount": "100",
  "signature": "0x...",
  "salt": "0x...",
  "deadline": 1713800000
}

​

Merge — full outcome set → USDC