Skip to main content
When a market resolves, Predexon redeems winning shares on each venue and credits the user’s USDC balance. Each resolution is recorded as an immutable entry in the user’s resolutions history — usable for accounting, tax reporting, and on-chain verification.
GET /v1/accounts/{accountId}/resolutions?limit=50&cursor=...
Query paramTypeDescription
predexonIdstringFilter to a single canonical outcome.
result"won" | "lost"Filter by outcome.
fromtimestampISO 8601 lower bound on resolvedAt (inclusive).
totimestampISO 8601 upper bound (inclusive).
limitintMax 200. Default 50.
cursorstringOpaque pagination token.
Response
{
  "resolutions": [
    {
      "resolutionId": "res_7e1d...",
      "predexonId": "px-abc123def456",
      "title": "Will Trump win the 2028 election?",
      "outcome": "Yes",
      "result": "won",
      "size": "100",
      "averagePrice": "0.495",
      "payoutPerShare": "1.00",
      "payoutAmount": "100.00",
      "realizedPnl": "50.50",
      "resolvedAt": "2028-11-05T03:14:00Z",
      "metadata": {
        "venues": [
          { "venue": "polymarket", "size": "50", "txHash": "0xredeem1..." },
          { "venue": "limitless", "size": "50", "txHash": "0xredeem2..." }
        ]
      }
    }
  ],
  "nextCursor": null
}
outcome is the side the user held. result is whether that side won. payoutAmount (= size × payoutPerShare) is what the user received in USDC, credited to their Ledger balance. realizedPnl is payoutAmount − (size × averagePrice) — positive for winners, negative for losers. For losing positions, result: "lost", payoutPerShare: "0.00", payoutAmount: "0.00", and realizedPnl equals the negative of the cost basis. metadata.venues records the on-chain redemption transactions per venue, so the resolution can be independently verified against each venue’s chain. Results are ordered by resolvedAt descending (newest first). nextCursor is null on the last page.