list_my_settlements - SeeSaw Developer

The authenticated user’s settled predictions — what paid out, what’s waiting to be claimed, and realized P&L. REST equivalent: GET /open/v1/me/settlements

Parameters

Name	Type	Default	Notes
`status`	`pending` \| `claimed` \| `expired`	all
`cursor` / `limit`		— / 20

Returns

Captured live:

{
  "data": [
    {
      "topic": {
        "id": "3eaa2cd0-29fb-41f5-a04c-f480650c5cac",
        "title": "2026世界盃洲際附加賽，哪洲隊伍晉級最多？",
        "url": "https://seesaw.fun/topic/3eaa2cd0-29fb-41f5-a04c-f480650c5cac"
      },
      "option": {
        "id": "23cb4263-684f-4fc8-b5b6-22c7ce363a73",
        "name": "CONCACAF 晉級 1 隊"
      },
      "shares": "8255.9380",
      "payout": "8255.9380",
      "profit_loss_percent": "145.9800",
      "status": "claimed",
      "created_at": "2026-03-27T13:05:24.660607Z",
      "settled_at": "2026-04-03T13:21:39.876455Z",
      "claimed_at": "2026-04-03T13:25:24.325477Z",
      "expired_at": null
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "summary": {
    "pending_count": 0,
    "claimable_payout": "0.0000"
  }
}

Field notes:

The top-level summary always reports how many settlements are still pending and the total claimable_payout.
status lifecycle: pending (won, not yet claimed) → claimed, or expired (claim window passed).
Settlement records carry payout and realized P&L only — cost basis and current prices live on list_my_positions.

Example prompts

“Do I have any winnings to claim?”
“What’s my realized P&L this season — biggest win and biggest miss?”

list_my_positions · get_my_profile