# logion credits

5 commands in this group.

- [`logion credits balance`](#logion-credits-balance)
- [`logion credits ledger`](#logion-credits-ledger)
- [`logion credits top-up`](#logion-credits-top-up)
- [`logion credits top-ups get`](#logion-credits-top-ups-get)
- [`logion credits top-ups wait`](#logion-credits-top-ups-wait)

## logion credits balance

```bash
logion credits balance [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |

## logion credits ledger

```bash
logion credits ledger [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |

## logion credits top-up

```bash
logion credits top-up [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding] --amount AMOUNT_CENTS [--currency CURRENCY] [--yes] [--wait] [--wait-timeout WAIT_TIMEOUT]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |
| `--amount` | int | — | Amount in USD cents for the credit top-up. |
| `--currency` | <lambda> | `usd` | Charge currency (ISO 4217, case-insensitive). Default: usd. When not usd, the charge is converted at the current exchange rate; credits are always granted in USD. |
| `--yes` | flag | — | Confirm creating a Stripe Checkout session for this top-up. |
| `--wait` | flag | — | Poll until the top-up reaches a terminal state. |
| `--wait-timeout` | int | `300` | Max seconds to poll (capped at 600). |

**Calls**

- [`create_credit_top_up`](/docs/api/credits#create-credit-top-up)
- [`get_credit_top_up`](/docs/api/credits#get-credit-top-up)

## logion credits top-ups get

```bash
logion credits top-ups get [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding] TOP_UP_ID
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |
| `TOP_UP_ID` | string | — |  |

**Calls**

- [`get_credit_top_up`](/docs/api/credits#get-credit-top-up)

## logion credits top-ups wait

```bash
logion credits top-ups wait [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding] TOP_UP_ID [--wait-timeout WAIT_TIMEOUT] [--interval INTERVAL]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |
| `TOP_UP_ID` | string | — |  |
| `--wait-timeout` | int | `300` | Max seconds to poll (capped at 600). |
| `--interval` | int | `5` | Seconds between polls. |

**Calls**

- [`get_credit_top_up`](/docs/api/credits#get-credit-top-up)