Info/Balance

Balance

Get the list of merchant accounts with their balances per currency.

The Balance endpoint returns all merchant accounts in the project with their available balances, USD equivalents, and any locked amounts.

Get balance

Returns the list of merchant accounts. The request takes no body — the signature is computed over an empty string.

Response fields

Each account in result includes:

Field	Type	Description
`uuid`	string	Account UUID
`status`	string	Account status (`active`, `disabled`)
`currency_code`	string	Account currency
`balance`	decimal	Available balance
`balance_usd`	decimal	Available balance in USD
`locked_balance`	decimal	Amount locked due to AML

Response example

JSON

{
  "state": 0,
  "result": [
    {
      "uuid": "abc123-def456-...",
      "status": "active",
      "currency_code": "USDT",
      "balance": "1250.50",
      "balance_usd": "1250.50",
      "locked_balance": "0.00"
    },
    {
      "uuid": "def456-abc789-...",
      "status": "active",
      "currency_code": "BTC",
      "balance": "0.01320000",
      "balance_usd": "1251.20",
      "locked_balance": "0.00000000"
    }
  ]
}

Credentials

Project UUIDAPI key

RequestGET/v1/balance

curl -X GET https://api.2328.io/api/v1/balance \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyShop/1.0 (+https://myshop.example)" \
  -H "project: YOUR_PROJECT_UUID" \
  -H "sign: YOUR_HMAC_SIGNATURE"

Response

Click Try it to see the response here.