Axiym 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
sellAccountand credits itsbuyAccount; 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:
opening balance + total credited - total debited = closing balanceEach 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.
Related concepts
- Address book and external accounts explains how external bank accounts and wallets are whitelisted for deposits and withdrawals.
- Depositing funds explains how to retrieve payment details and identify incoming deposits.
- Currency conversions explains how value moves between two Axiym accounts.
- Withdrawing funds explains how value leaves an account.
For amount formats and precision handling, see Data formats and constants. For implementation steps, see Reconcile activity.