# Monte um painel de saldos

Fonte: https://docs.ruralzap.com.br/receitas/saldos

Consulte carteiras e exiba a posição financeira por moeda.





## Objetivo e pré-requisitos [#objetivo-e-pré-requisitos]

Mostrar os saldos correntes do Space no seu sistema. Você precisa de uma integração habilitada com `balances:read`, uma chave no servidor e as [variáveis configuradas](/comecar).

## 1. Confirme o Space [#1-confirme-o-space]

Consulte [contexto](/referencia/context) e confirme `spaceId` e as capacidades.

## 2. Busque os saldos [#2-busque-os-saldos]

Use o [exemplo executável de saldos](/examples/balances.py) ou execute:

```bash
curl --fail-with-body "$RURALZAP_BASE_URL/api/v1/integration/balances" \
  -H "Authorization: Bearer $RURALZAP_API_KEY"
```

## 3. Monte a apresentação [#3-monte-a-apresentação]

Mapeie cada item de `data` por `id`. Exiba `name`, `currency` e `balance`. Identifique o instante `generatedAt`. Use `totals` para totais separados por moeda.

## Resultado esperado [#resultado-esperado]

Um painel com carteiras ativas e saldos correntes. O total inclui carteiras retornadas mesmo quando `includeInNetWorth` é falso. O campo informa participação no patrimônio do produto, não ausência da carteira na resposta.

## Erros comuns [#erros-comuns]

401 exige revisar chave/ambiente; 403 exige escopo e acesso. Uma resposta sem carteiras é válida. Não apresente dados antigos como consulta atual quando houver erro.

## Próximos passos [#próximos-passos]

[Experimente os dados sintéticos](/demonstracao) e confira a [referência de saldos](/referencia/balances).