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

# Autenticação

Para acessar as APIs da Bullring Finance, você deve autenticar cada requisição usando uma chave de API. Esta chave garante que sua aplicação seja verificada e autorizada a interagir com a plataforma.

***

## Obtenha Sua Chave de API

1. Entre em contato com a [Equipe Bullring](mailto:developer@bullring.finance) para ser integrado
2. Faça login no Dashboard da Bullring
3. Navegue até **Desenvolvedores → Chaves de API**
4. Clique em **Gerar Chave** para **staging** ou **produção**
5. Copie e armazene sua chave com segurança — ela não será exibida novamente

Cada ambiente tem sua própria chave única. Use a **chave de staging** para testes e a **chave de produção** para transações reais.

***

## Header de Autenticação

Todas as requisições para ambos os ambientes **devem** incluir sua chave de API no seguinte header:

```http theme={null}
x-api-key: SUA_CHAVE_DE_API
```

Se sua requisição não incluir uma chave válida, ela será rejeitada com uma resposta `401 Unauthorized`.

***

## Boas Práticas

* 🔒 Nunca exponha sua chave de API em código frontend
* 🔁 Rotacione suas chaves de API periodicamente para maior segurança
* 👀 Monitore o uso no Dashboard da Bullring

***

Precisa de ajuda? Entre em contato com [developer@bullring.finance](mailto:developer@bullring.finance)
