> ## 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.

# Introdução

> Visão geral da API Pública VoxFi

## URL Base

Todas as requisições à API devem ser feitas para:

```
https://data-api-dev.voxfi.com.br/v1
```

## Autenticação

Todos os endpoints requerem autenticação usando o cabeçalho `X-Api-Key`:

```bash theme={null}
X-Api-Key: sua-chave-de-api-aqui
```

<Info>
  Saiba mais sobre autenticação e gerenciamento de chaves de API no [guia de Autenticação](/pt/authentication).
</Info>

## Limites de Taxa

A API implementa limitação de taxa para garantir uso justo. Informações sobre limites de taxa são retornadas nos cabeçalhos de resposta quando os limites são aproximados.

## Formato de Resposta

Todas as respostas são retornadas em formato JSON. Respostas bem-sucedidas retornam códigos de status HTTP na faixa 200, enquanto erros retornam códigos de status HTTP apropriados com detalhes do erro no corpo da resposta.

## Conceitos Principais

A API VoxFi é organizada em torno destes conceitos principais:

* **[Eventos](/pt/api/events)** - Eventos de mercado de previsão nos quais os usuários podem negociar;
* **[Mercados](/pt/api/markets)** - Mercados individuais dentro de um evento (um evento pode ter um ou vários mercados);
* **[Ordens](/pt/api/orders)** - Ordens de negociação (ordens limitadas e a mercado);
* **[Carteiras](/pt/api/wallets)** - Saldos e gerenciamento de portfólio do usuário.

## Começando

1. Obtenha sua chave de API em [Perfil → Segurança](https://staging.voxfi.com.br/profile);
2. Leia o [guia de Início Rápido](/pt/quickstart) para fazer sua primeira requisição;
3. Explore os endpoints da API organizados por conceito abaixo.