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

# Autenticação

> Como gerar e utilizar sua API Key para autenticar requisições na plataforma Liquiditi.

## Como funciona

A API da Liquiditi exige uma **API Key** em todas as requisições. Envie-a no header `x-api-key`.

Para formatos de dados, paginação e erros, consulte [Definições](/api-reference/definicoes). Para a lista de endpoints, use [Introdução — API](/api-reference/introduction).

## Gerando sua API Key

<Steps>
  <Step title="Acesse o painel">
    Faça login em [app.liquiditi.com.br](https://app.liquiditi.com.br).
  </Step>

  <Step title="Abra as chaves da API">
    No menu principal, acesse **Configurações** e depois **Chaves da API**.
  </Step>

  <Step title="Crie uma nova chave">
    Clique em **Gerar nova Chave de API**. A chave aparece **uma única vez**. Copie e guarde em local seguro.
  </Step>
</Steps>

<Warning>
  Se você perder a chave, gere outra. Chaves antigas podem ser revogadas quando não forem mais necessárias.
</Warning>

## Utilizando a API Key

Inclua o header em toda requisição:

| Header      | Valor            |
| ----------- | ---------------- |
| `x-api-key` | Sua Chave de API |

### Exemplo de requisição

```bash theme={null}
curl -X GET https://api.liquiditi.com.br/v1/asks \
  -H "x-api-key: SUA_API_KEY"
```

## Boas práticas de segurança

* Não publique a API Key em repositórios públicos nem em código executado no navegador.
* Use variáveis de ambiente ou um cofre de segredos no seu ambiente de deploy.
* Se suspeitar de vazamento, gere uma nova chave no painel e descontinue a anterior.
* Revogue chaves que não estão mais em uso.