Fx swap

Get FX Wallet Balances

Fetch available and ledger balances for business wallets used in FX operations.

GET
/api/v1/fx/wallet/balances

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Response Body

application/json

curl -X GET "https://example.com/api/v1/fx/wallet/balances"
{
  "requestId": "196261bf-1f24-43f8-8e3d-39f4d59553a0",
  "requestTimestamp": "2026-04-21 14:22:16",
  "message": "FX wallet balances fetched successfully.",
  "statusCode": 200,
  "data": [
    {
      "currency": "NGN",
      "ledgerBalance": {
        "value": 1250000,
        "currency": "NGN",
        "formatted": "NGN 1,250,000.00"
      },
      "availableBalance": {
        "value": 1185000,
        "currency": "NGN",
        "formatted": "NGN 1,185,000.00"
      },
      "businessState": "live"
    }
  ]
}
Empty
Empty

How is this guide?