Sign in
Informações/Saldo

Saldo

Obtenha a lista de contas do comerciante com seus saldos por moeda.

O endpoint de saldo retorna todas as contas de comerciante do projeto com seus saldos disponíveis, equivalentes em USD e quaisquer valores bloqueados.

Obter saldo

Retorna a lista de contas do comerciante. A requisição não recebe corpo — a assinatura é calculada sobre uma string vazia.

Campos da resposta

Cada conta em result inclui:

CampoTipoDescrição
uuidstringUUID da conta
statusstringStatus da conta (active, disabled)
currency_codestringMoeda da conta
balancedecimalSaldo disponível
balance_usddecimalSaldo disponível em USD
locked_balancedecimalValor bloqueado por AML

Exemplo de resposta

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
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.