# 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

<TwoCol>

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:

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `uuid` | string | UUID da conta |
| `status` | string | Status da conta (`active`, `disabled`) |
| `currency_code` | string | Moeda da conta |
| `balance` | decimal | Saldo disponível |
| `balance_usd` | decimal | Saldo disponível em USD |
| `locked_balance` | decimal | Valor 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"
    }
  ]
}
```

<TwoColAside>

<Credentials />

<TryIt endpoint="GET /v1/balance" />

</TwoColAside>

</TwoCol>