# AureEX API — contrato completo (llms-full)

Fonte humana: https://api.aure-ex.com/docs
OpenAPI: https://api.aure-ex.com/openapi.yaml
Índice curto: https://api.aure-ex.com/llms.txt

## Autenticação

Todas as rotas privadas exigem:

```
X-Api-Key: <api-key>
X-Api-Secret: <api-secret>
Content-Type: application/json
```

Base URL produção: https://api.aure-ex.com/v1
Base URL sandbox: https://api-sandbox.aure-ex.com/v1
Dashboard sandbox: https://app-sandbox.aure-ex.com
Doc sandbox: https://api.aure-ex.com/docs/sandbox

## Envelope

Sucesso:
```json
{ "success": true, "data": { } }
```

Erro:
```json
{
  "success": false,
  "error": {
    "code": "AUTH_FAILED",
    "message": "Falha na autenticação: chave API ou secret inválido.",
    "details": null
  }
}
```

## Recursos crypto

### Empresa
- GET /v1/company — dados da empresa autenticada
- GET /v1/company/balance — saldo disponível

### Depósitos USDT
- POST /v1/deposits — gera endereço / intenção de depósito (`method: "usdt"`)
- GET /v1/deposits/:id — consulta por ID

Body mínimo (exemplo):
```json
{
  "method": "usdt",
  "reference": "order-123",
  "network": "tron"
}
```

Split opcional no depósito: ver https://api.aure-ex.com/docs/split-pagamentos

### Saques USDT
- POST /v1/withdrawals — solicita saque para carteira externa
- GET /v1/withdrawals/:id — consulta

### Conversões (origem USDT)
- POST /v1/conversions/quote — cotação
- POST /v1/conversions — executa conversão
- GET /v1/conversions — lista
- GET /v1/conversions/:id — detalhe

### Webhooks
- GET/POST /v1/webhooks
- GET/PUT/DELETE /v1/webhooks/:id

Valide a assinatura HMAC antes de processar eventos de depósito, saque ou conversão.

## Fora de escopo deste contrato

PIX (Pix In/Out), estorno Pix, MED/chargebacks e carteiras fiat pertencem à API AurePay
(`https://api.aurepay.com.br`), não a este host.

## SDKs oficiais

- Node: @aure-ex/sdk
- PHP: aure-ex/sdk
- Python: aure-ex
- .NET: AureEx
- Java: com.aure-ex:aureex
- Ruby: aure_ex

Facade típica:
```js
const aureEx = new AureEx({ apiKey, apiSecret })
await aureEx.deposits.create({ method: 'usdt', reference: 'order-123', network: 'tron' })
await aureEx.webhooks.list()
await aureEx.company.balance()
```

Mapa e install: https://api.aure-ex.com/docs/sdks

## Boas práticas para agentes

1. Preferir este arquivo (llms-full) para integrar; llms.txt só para descoberta.
2. Usar espelhos /docs/*.md e citar source_url do frontmatter.
3. Não inventar rotas admin, proxy de adquirente ou jobs internos.
4. Não misturar contratos AurePay (PIX) com AureEX (USDT) no mesmo fluxo.