curl "https://api.pmx.trade/v2/positions/7xKXabc123.../1"
{
"success": true,
"data": {
"marketId": 1,
"marketTitle": "BTC above $95k by Mar 1",
"marketDescription": "Will BTC close above $95,000?",
"marketStatus": "active",
"marketType": "amm",
"yesTicker": "YES",
"noTicker": "NO",
"resolutionTime": 1735689600,
"creator": "7xKX...abc",
"winningSide": null,
"isResolved": false,
"isBroken": false,
"yesBalance": 146500000,
"noBalance": 0,
"yesBalanceHuman": 146.5,
"noBalanceHuman": 0,
"hasWinningTokens": false,
"redeemableValueUsdc": 0,
"needsRedemption": false,
"creatorFeesAccrued": 0,
"creatorFeesAccruedHuman": 0,
"imageUrls": { "market": null, "yes": null, "no": null }
}
}
Get Position
Get a wallet’s token balances and position details for a specific market.
GET
/
v2
/
positions
/
{wallet}
/
{marketId}
curl "https://api.pmx.trade/v2/positions/7xKXabc123.../1"
{
"success": true,
"data": {
"marketId": 1,
"marketTitle": "BTC above $95k by Mar 1",
"marketDescription": "Will BTC close above $95,000?",
"marketStatus": "active",
"marketType": "amm",
"yesTicker": "YES",
"noTicker": "NO",
"resolutionTime": 1735689600,
"creator": "7xKX...abc",
"winningSide": null,
"isResolved": false,
"isBroken": false,
"yesBalance": 146500000,
"noBalance": 0,
"yesBalanceHuman": 146.5,
"noBalanceHuman": 0,
"hasWinningTokens": false,
"redeemableValueUsdc": 0,
"needsRedemption": false,
"creatorFeesAccrued": 0,
"creatorFeesAccruedHuman": 0,
"imageUrls": { "market": null, "yes": null, "no": null }
}
}
Returns the wallet’s YES/NO token balances and position metadata for one market.
Path parameters
Solana wallet address.
The market ID.
Response
Show Position object
Show Position object
Market ID
Market title
Market description
active, resolved, or cancelledpool or ammFirst outcome ticker
Second outcome ticker
Unix timestamp for resolution
Market creator wallet address
Winning side if resolved (
YES or NO). Null if unresolved.Whether the market has resolved
true if the market’s mints were never initializedYES token balance (raw units)
NO token balance (raw units)
YES token balance (human units, raw / 1e6)
NO token balance (human units, raw / 1e6)
true if the wallet holds tokens on the winning side of a resolved marketEstimated USDC redeemable (human units). Non-zero only when
hasWinningTokens is true.true if there are winning tokens that haven’t been redeemed yetCreator fees accrued (raw units). Only non-zero for the market creator.
Creator fees accrued (human units)
Market image URLs
{ market, yes, no } if set via metadatacurl "https://api.pmx.trade/v2/positions/7xKXabc123.../1"
{
"success": true,
"data": {
"marketId": 1,
"marketTitle": "BTC above $95k by Mar 1",
"marketDescription": "Will BTC close above $95,000?",
"marketStatus": "active",
"marketType": "amm",
"yesTicker": "YES",
"noTicker": "NO",
"resolutionTime": 1735689600,
"creator": "7xKX...abc",
"winningSide": null,
"isResolved": false,
"isBroken": false,
"yesBalance": 146500000,
"noBalance": 0,
"yesBalanceHuman": 146.5,
"noBalanceHuman": 0,
"hasWinningTokens": false,
"redeemableValueUsdc": 0,
"needsRedemption": false,
"creatorFeesAccrued": 0,
"creatorFeesAccruedHuman": 0,
"imageUrls": { "market": null, "yes": null, "no": null }
}
}
Use
hasWinningTokens and needsRedemption to drive redemption UX — if needsRedemption is true, prompt the user to call /redeem.⌘I