# Axiym accounts and balances

Product: Client Account API
Guides follow API reference 0.3.0 and event reference 0.2.0.
Canonical page: https://docs.sandbox.axiym.io/client-account-api/concepts/accounts-and-balances

An **Axiym account** holds funds with Axiym in one currency and is connected
to one payment rail.

For example, a client might have:

| Account            | Currency | Payment rail       | Purpose                                                                                     |
| ------------------ | -------- | ------------------ | ------------------------------------------------------------------------------------------- |
| USD Axiym account  | USD      | Bank rail          | Hold USD received by Axiym, sell USD in permitted conversions, and fund USD withdrawals.    |
| USDT Axiym account | USDT     | Blockchain network | Hold USDT received by Axiym, sell USDT in permitted conversions, and fund USDT withdrawals. |

Each Axiym account has a unique `accountId`. Its deposit instructions and
statements describe funding and activity for that account.

## Axiym accounts and external accounts

These resources serve different roles and their identifiers are not
interchangeable.

|                    | Axiym account                                  | External account                                                  |
| ------------------ | ---------------------------------------------- | ----------------------------------------------------------------- |
| Where it exists    | With Axiym                                     | At an external bank or on a blockchain network                    |
| What it represents | A balance held with Axiym                      | A bank account or wallet whitelisted in the client’s address book |
| Identifier         | `accountId`                                    | `destinationId`                                                   |
| In a deposit       | Receives the resulting account credit          | Must be the origin of the incoming payment                        |
| In a withdrawal    | Supplies the balance through `sourceAccountId` | Receives the outgoing payment through `destinationId`             |

Deposit instructions tell you where to send funds to credit an Axiym account.
The external account sending the funds must be whitelisted and `ACTIVE` in
the selected client’s address book.

## What an account tells you

An account contains:

| Field          | Meaning                                                           |
| -------------- | ----------------------------------------------------------------- |
| `accountId`    | The stable identifier for the balance held with Axiym.            |
| `currency`     | The currency held by the account.                                 |
| `paymentRails` | The bank rail or blockchain network on which the account settles. |
| `balance`      | The amount currently available in the account's currency.         |
| `status`       | Whether the account is active, suspended, or closed.              |

## How balances change

Posted ledger movements include:

* a completed deposit credits an account;
* a posted withdrawal debit reduces an account's balance;
* a completed conversion debits its `sellAccount` and credits its `buyAccount`;
  or
* an operational adjustment posts directly to the ledger.

Use `balance` for the amount currently available and the account statement
for posted movements. Reserved funds can make the available balance differ
from the statement balance.

## Account statements

An account statement provides opening and closing balances, totals for credits
and debits, and the individual ledger entries for a period.

The totals reconcile as follows:

```text
opening balance + total credited - total debited = closing balance
```

Each entry has a direction (`CREDIT` or `DEBIT`), a positive amount, and the
balance after the movement. When the entry relates to a deposit, conversion,
or withdrawal, it also contains the type and identifier of that resource.

This lets you move from a balance difference to the business operation that
caused it.

## Account status

| Status      | Meaning                                            |
| ----------- | -------------------------------------------------- |
| `ACTIVE`    | The account is available for permitted operations. |
| `SUSPENDED` | Use of the account is temporarily restricted.      |
| `CLOSED`    | The account has been permanently retired.          |

Do not assume that having an account grants access to every currency
conversion. The available directions are defined separately by
[conversion pairs](/client-account-api/concepts/currency-conversions).

## Related concepts

* [Address book and external accounts](/client-account-api/concepts/address-book)
  explains how external bank accounts and wallets are whitelisted for deposits
  and withdrawals.
* [Depositing funds](/client-account-api/concepts/depositing-funds) explains how to
  retrieve payment details and identify incoming deposits.
* [Currency conversions](/client-account-api/concepts/currency-conversions) explains
  how value moves between two Axiym accounts.
* [Withdrawing funds](/client-account-api/concepts/withdrawing-funds)
  explains how value leaves an account.

For amount formats and precision handling, see
[Data formats and constants](/client-account-api/integration-guide/fundamentals/data-formats-and-constants).
For implementation steps, see [Reconcile activity](/client-account-api/integration-guide/reconcile-activity).