# Axiym accounts and balances

Product: Account API
Guides follow API reference 0.1.0 and event reference 0.1.0.
Canonical page: https://docs.sandbox.axiym.io/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, your company 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 with Axiym       |
| 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`.

## 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](/account-api/concepts/currency-conversions).

## Related concepts

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

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