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

# Carteiras

> Gerenciando saldos e portfólio

## Visão Geral da Carteira

Sua carteira no VoxFi rastreia o saldo da sua conta, posições e portfólio em todos os eventos e mercados.

## Endpoints da API

### Obter Saldo e Totais

Recupera o saldo da conta e totais do usuário autenticado. Inclui saldo disponível, saldos bloqueados, totais de depósitos e saques, e métricas de P\&L (lucro/prejuízo realizado e não realizado).

#### Exemplo de Saldo

```json theme={null}
{
  "available": 995610,
  "eligible_for_withdraw": 995610,
  "locked_waiting_orders": 1703270,
  "locked_waiting_withdraw": 0,
  "locked_audit": 0,
  "total_balance": 2698880,
  "remaining_rollover": 0,
  "total_deposits": 4002000,
  "total_withdrawals": 0,
  "total_contracts": 1389616,
  "total_realized_pnl": 0,
  "total_unrealized_pnl": 191097,
  "qty_contracts": 26663
}
```

[Documentação detalhada + playground](/playground/user/get-user-balance)

### Obter Portfólio

Recupera o portfólio com posições e P\&L em todos os eventos ou para um evento específico. Se `eventId` for fornecido, retorna portfólio apenas para aquele evento. Caso contrário, retorna portfólio global de todos os eventos.

[Documentação detalhada + playground](/playground/user/get-portfolio)

## Componentes do Saldo

### Saldo Disponível

A quantia que você pode usar para novas negociações. Isso é calculado como:

```
available = total_balance - locked_waiting_orders - locked_waiting_withdraw - locked_audit
```

### Saldos Bloqueados

* **`locked_waiting_orders`**: Fundos reservados para ordens limitadas abertas;
* **`locked_waiting_withdraw`**: Fundos pendentes de saque;
* **`locked_audit`**: Fundos temporariamente bloqueados para fins de auditoria.

### Rastreamento de P\&L

* **P\&L Realizado**: Lucro/prejuízo de posições fechadas e contratos liquidados;
* **P\&L Não Realizado**: Lucro/prejuízo atual de posições abertas com base nos preços de mercado.

## Casos de Uso

* **Monitoramento de Saldo**: Rastrear fundos disponíveis para negociação;
* **Análise de Portfólio**: Analisar posições e performance em todos os eventos;
* **Gerenciamento de Risco**: Monitorar P\&L não realizado e tamanhos de posição;
* **Rastreamento de Liquidação**: Rastrear P\&L realizado de mercados liquidados.