Client Account
Client Account APIs allow you to prefund a balance on the Movmint ledger, check your available and pending balances, and review the transaction history for each balance account.
Overview
A Client Balance is a prefunded account held on the Movmint ledger on your behalf. Each balance account is denominated in a single asset (e.g. USDC, EURC) and identified by a client_account_id.
Client balances are the foundation for the CLIENT_BALANCE source and target types in the Quote & Capture flow. Funding your balance in advance removes the need for real-time payment settlement during an FX transaction, enabling faster, straight-through processing.
Balance States
Every Client Balance account tracks three balance fields:
| Field | Description |
|---|---|
available_balance | Funds usable immediately as source_type=CLIENT_BALANCE on a Quote/Capture request. |
pending_balance | Deposits that have been detected on-chain but have not yet passed TRM compliance checks or reached full confirmation. |
total_balance | Sum of available_balance and pending_balance. |
Funds move from pending_balance to available_balance once on-chain settlement is confirmed and TRM screening clears.
Guides
- Funding Your Client Balance — Request an ephemeral deposit address and send assets to fund your account.
- Checking Your Client Balance — Retrieve current balances across all assets or for a specific asset.
- Viewing Transactions — Inspect the full transaction history for a specific balance account, including funding deposits and FX debits/credits.
Updated 29 days ago