> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avanttifinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Saldo

> Consulte o saldo disponível e a receber da sua conta

## Visão geral

Este endpoint retorna o saldo atual da sua conta, incluindo valores disponíveis para saque/transferência e valores a liberar (a receber de transações em processamento).

## Endpoint

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.avanttifinance.com/v1/account/balance \
    --header "Authorization: Bearer SEU_TOKEN_DE_ACESSO"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.avanttifinance.com/v1/account/balance",
    {
      method: "GET",
      headers: {
        Authorization: \`Bearer \${accessToken}\`,
      },
    }
  );

  const balance = await response.json();
  console.log(balance);
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.avanttifinance.com/v1/account/balance"
  headers = {"Authorization": f"Bearer {access_token}"}

  response = requests.get(url, headers=headers)
  print(response.json())
  ```
</CodeGroup>

## Resposta

<ResponseField name="available" type="integer">
  Saldo disponível para transferência (Pix Out), em centavos.
</ResponseField>

<ResponseField name="pending" type="integer">
  Valor a liberar, referente a transações ainda em processamento ou liquidação, em centavos.
</ResponseField>

<ResponseField name="currency" type="string">
  Moeda do saldo. Sempre `BRL`.
</ResponseField>

<ResponseField name="updated_at" type="string">
  Data e hora da última atualização do saldo, no formato ISO 8601.
</ResponseField>

### Exemplo de resposta

```json theme={null}
{
  "available": 1284500,
  "pending": 32000,
  "currency": "BRL",
  "updated_at": "2026-06-11T08:00:00Z"
}
```

<Tip>
  O valor `pending` é normalmente liberado em até 1-2 dias úteis, dependendo do método de pagamento utilizado pelo cliente.
</Tip>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Extrato" icon="list-filter" href="/extrato">
    Veja o histórico detalhado de movimentações da sua conta.
  </Card>

  <Card title="Pix Out" icon="send" href="/pages/pix-out/overview">
    Transfira o saldo disponível para uma chave Pix.
  </Card>
</CardGroup>