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

# Visão Geral de Contas Poupança

> Contas poupança custodiais denominadas em USD

## O que são Contas Poupança?

Contas poupança na KillB são contas custodiais denominadas em USD que permitem aos usuários obter rendimento em seus depósitos. A KillB gerencia a custódia enquanto os usuários mantêm propriedade total.

<Info>
  Contas poupança são seguradas pela FDIC através de bancos parceiros e fornecem uma forma segura de manter valor em USD.
</Info>

## Recursos Principais

<CardGroup cols={2}>
  <Card title="Denominado em USD" icon="dollar-sign">
    Mantenha valor em Dólares Americanos, protegido da volatilidade da moeda local
  </Card>

  <Card title="Múltiplos Métodos de Depósito" icon="arrows-down-to-line">
    Financie via ACH, Wire ou depósitos cripto
  </Card>

  <Card title="Saques Fáceis" icon="money-bill-transfer">
    Saque para contas bancárias ou carteiras cripto a qualquer momento
  </Card>

  <Card title="Histórico de Transações" icon="clock-rotate-left">
    Rastreie todos os depósitos e saques
  </Card>
</CardGroup>

## Criando uma Conta Poupança

```bash theme={null}
POST /api/v2/savings
```

```json theme={null}
{
  "userId": "user-id",
  "acceptedTermsAndConditions": true
}
```

<CodeGroup>
  ```javascript Node.js theme={null}
  const createSavingsAccount = async (userId) => {
    const response = await fetch(
      'https://sandbox.killb.app/api/v2/savings',
      {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${token}`,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({
          userId: userId,
          acceptedTermsAndConditions: true
        })
      }
    );
    
    return await response.json();
  };
  ```

  ```python Python theme={null}
  def create_savings_account(user_id, api_key, access_token):
      response = requests.post(
          'https://sandbox.killb.app/api/v2/savings',
          headers={
              'Authorization': f'Bearer {access_token}',
              'Content-Type': 'application/json'
          },
          json={
              'userId': user_id,
              'acceptedTermsAndConditions': True
          }
      )
      return response.json()
  ```
</CodeGroup>

## Verificando Saldo

```bash theme={null}
GET /api/v2/savings/{savingsAccountId}/balance
```

```javascript theme={null}
const getBalance = async (savingsAccountId) => {
  const response = await fetch(
    `https://sandbox.killb.app/api/v2/savings/${savingsAccountId}/balance`,
    {
      headers: {
        'Authorization': `Bearer ${token}`
      }
    }
  );
  
  const balance = await response.json();
  console.log(`Saldo: $${balance.amount} ${balance.currency}`);
  return balance;
};
```

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Criar Conta" icon="plus" href="/pt/guides/savings/create-account">
    Configure contas poupança
  </Card>

  <Card title="Depósitos" icon="arrow-down" href="/pt/guides/savings/deposits">
    Financie contas poupança
  </Card>

  <Card title="Saques" icon="arrow-up" href="/pt/guides/savings/withdrawals">
    Saque da poupança
  </Card>

  <Card title="Referência da API" icon="code" href="/api-reference/endpoint/savings-create">
    Documentação da API de Poupança
  </Card>
</CardGroup>
