> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seesaw.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# list_my_coin_ledger

> The key owner's coin ledger

Every movement of the key owner's coin balance, newest first, plus any payments
received but not yet credited.

**Scope**: `read` · **Annotations**: `readOnlyHint`
**REST equivalent**: `GET /open/v1/me/coin-ledger`

## Parameters

| Name     | Type                   | Required | Default | Notes                                      |
| -------- | ---------------------- | -------- | ------- | ------------------------------------------ |
| `flow`   | `all` \| `in` \| `out` |          | `all`   | `in` = coins received, `out` = coins spent |
| `cursor` | string                 |          | —       |                                            |
| `limit`  | integer ≤ 100          |          | 20      |                                            |

## Returns

Two row kinds:

| `kind`       | Meaning                                                 | Fields                                                                                 |
| ------------ | ------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `ledger`     | A balance movement                                      | `type`, `direction`, `amount` (always positive), `balance_after`, `reference_id`       |
| `uncredited` | A payment received but not credited — balance unchanged | `currency`, `provider`, `reason`; `amount` is in the gateway's currency, **not coins** |

Common `type` values: `topic_bet` (a position), `opinion_back` (backing an
opinion), `coin_recharge`. `reference_id` points at the order or backing that
caused the movement.

Captured live:

```json theme={null}
{
  "data": [
    {
      "kind": "ledger",
      "id": "045c8008-3311-459b-b756-0be1259cb25d",
      "type": "opinion_back",
      "direction": "out",
      "amount": "1.0000",
      "balance_after": "4899.0000",
      "reference_id": "efbb3e35-8c86-4cae-b034-2cca7994d0ce",
      "created_at": "2026-09-08T23:35:42.823274Z"
    },
    {
      "kind": "ledger",
      "id": "42aa0c58-680e-4e4d-8a47-7d967d77ce88",
      "type": "topic_bet",
      "direction": "out",
      "amount": "100.0000",
      "balance_after": "4900.0000",
      "reference_id": "87dffbea-78e8-4124-9ee0-b269d9c76265",
      "created_at": "2026-09-08T23:34:20.441809Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}
```

## Example prompts

* "Where did my coins go this week?"
* "Show me my coin top-ups."

## Related

[`get_my_profile`](/mcp/tools/get-my-profile) ·
[`list_my_positions`](/mcp/tools/list-my-positions)