Overview
Account
Fills & Settlement
Positions & P&L
curl "https://api.pmx.trade/v2/clob/positions?pubkey=7xKXabc123..."
{
"positions": [
{
"id": "d4e5f6a7-...",
"marketId": "550e8400-...",
"ownerPubkey": "7xKXabc123...",
"outcome": "yes",
"netQuantity": "50000000",
"avgEntryPrice": 5500,
"totalCost": "27500000",
"totalProceeds": "0",
"totalFees": "550000",
"realizedPnl": "0",
"unrealizedPnl": "2500000",
"currentPrice": 6000,
"marketSlug": "btc-100k-2025",
"marketTitle": "Will BTC hit $100K?",
"marketStatus": "active",
"updatedAt": "2025-01-15T12:05:00.000Z"
}
]
}
Positions & P&L
List Positions
Get positions and P&L for a wallet, optionally filtered by market.
GET
/
v2
/
clob
/
positions
curl "https://api.pmx.trade/v2/clob/positions?pubkey=7xKXabc123..."
{
"positions": [
{
"id": "d4e5f6a7-...",
"marketId": "550e8400-...",
"ownerPubkey": "7xKXabc123...",
"outcome": "yes",
"netQuantity": "50000000",
"avgEntryPrice": 5500,
"totalCost": "27500000",
"totalProceeds": "0",
"totalFees": "550000",
"realizedPnl": "0",
"unrealizedPnl": "2500000",
"currentPrice": 6000,
"marketSlug": "btc-100k-2025",
"marketTitle": "Will BTC hit $100K?",
"marketStatus": "active",
"updatedAt": "2025-01-15T12:05:00.000Z"
}
]
}
Returns all positions for the specified wallet with cost basis, realized P&L, and on-the-fly unrealized P&L computed from current orderbook prices. Only positions with non-zero holdings or realized P&L are returned.
Query parameters
The Solana wallet public key (base58-encoded).
Filter by market UUID. If omitted, returns positions across all markets.
Response
Show Position object
Show Position object
Position UUID.
Market UUID.
Wallet address.
yes or no.Current token holdings (raw units). Positive = long position.
Weighted average cost basis in bps. Divide by 100 for cents.
Cumulative USDC spent acquiring this position (raw units).
Cumulative USDC received from partial sells (raw units).
Cumulative fees paid (raw units).
Realized P&L from closed portions of the position (raw units). Positive = profit.
Unrealized P&L based on current orderbook mid-price (raw units), or
null if no price available.Current orderbook mid-price in bps, or
null if no liquidity.Human-readable market slug, or
null.Market title, or
null.Market status (
active, paused, resolved), or null.ISO 8601 timestamp of last position update.
curl "https://api.pmx.trade/v2/clob/positions?pubkey=7xKXabc123..."
{
"positions": [
{
"id": "d4e5f6a7-...",
"marketId": "550e8400-...",
"ownerPubkey": "7xKXabc123...",
"outcome": "yes",
"netQuantity": "50000000",
"avgEntryPrice": 5500,
"totalCost": "27500000",
"totalProceeds": "0",
"totalFees": "550000",
"realizedPnl": "0",
"unrealizedPnl": "2500000",
"currentPrice": 6000,
"marketSlug": "btc-100k-2025",
"marketTitle": "Will BTC hit $100K?",
"marketStatus": "active",
"updatedAt": "2025-01-15T12:05:00.000Z"
}
]
}
Unrealized P&L is computed as
(netQuantity × currentPrice / 10000) - totalCost. It uses the orderbook mid-price (average of best bid and best ask). If only one side has liquidity, that price is used. Returns null if no orders exist.Realized P&L accumulates each time you sell tokens. On each sell, the engine computes proceeds - proportionalCostBasis - fees using weighted average cost.⌘I