> For the complete documentation index, see [llms.txt](https://docs.nexus.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexus.xyz/exchange/pt-br/overview/exchange-testnet.md).

# Testnet da Exchange

Negocie na plataforma da testnet: autentique-se, gere uma chave, resgate USDX sintético e envie uma ordem.

A Nexus Exchange está no ar na testnet em [nexus.xyz/trade](https://nexus.xyz/trade).

Você pode se autenticar pela API, enviar ordens e negociar os mercados de futuros perpétuos ativos.

O frontend mostra o estado ao vivo da exchange em modo somente leitura. Toda a negociação passa pelas APIs REST e WebSocket.

A seção [Referência da API](https://docs.nexus.xyz/api-reference) desta documentação traz a documentação completa da API.

### Primeiros passos

#### 1. Autentique-se

Entre com sua carteira Ethereum usando uma assinatura pessoal EIP-191:

```bash
POST /auth/login
```

Assine a mensagem `"Sign in to Nexus Exchange"` para receber um token de sessão (TTL de 24 horas). Seu primeiro login cria sua conta.

#### 2. Crie uma chave de API

```bash
POST /keys
```

A chamada retorna um par de chaves HMAC (`key_id` + `secret`). O segredo é exibido uma única vez, então guarde-o imediatamente.

Gerencie as chaves com `GET /keys` (listar) e `DELETE /keys/{key_id}` (revogar).

#### 3. Abasteça sua conta

Credite sua conta da testnet com USDX sintético do faucet:

```bash
POST /account/credit
```

Você precisa de saldo em USDX antes de poder enviar ordens. Consulte seu saldo a qualquer momento com `GET /account`.

**Cada chave de API pode resgatar até 500 USDX de teste por dia.**

#### 4. Envie uma ordem

Autentique todas as requisições de negociação com três cabeçalhos: `X-API-Key`, `X-Timestamp`, `X-Signature`.

```bash
POST /orders
```

```json
{
  "market_id": "BTC-USDX-PERP",
  "side": "Buy",
  "order_type": "Limit",
  "price": "67000",
  "quantity": "0.01",
  "time_in_force": "GTC"
}
```

Consulte a seção [Referência da API](https://docs.nexus.xyz/api-reference) para ver exemplos completos de autenticação e todos os endpoints disponíveis.

### Mercados

Três perpétuos de cripto estão no ar, todos denominados em USDX:

| Mercado         | Ativo subjacente |
| --------------- | ---------------- |
| `BTC-USDX-PERP` | Bitcoin          |
| `ETH-USDX-PERP` | Ether            |
| `SOL-USDX-PERP` | Solana           |

O conjunto muda conforme mercados são listados e delistados. Consulte `GET /markets` para ver o que está no ar agora, ou `GET /markets/summary` para ver o conjunto com suas estatísticas. Consulte o [Diretório de ativos](/exchange/pt-br/asset-directory/asset-directory.md) para ver as classes que virão.

### Telemetria da plataforma

A telemetria agregada da plataforma está disponível pela API. Estes endpoints são **públicos** e não exigem chave de API:

| Endpoint                          | O que retorna                                                         |
| --------------------------------- | --------------------------------------------------------------------- |
| `GET /stats`                      | Snapshot da plataforma, incluindo contagens móveis de traders únicos  |
| `GET /stats/history`              | Amostras de throughput ao longo do tempo                              |
| `GET /stats/volume`               | Valor nocional negociado acumulado, total da plataforma e por mercado |
| `GET /stats/open-interest`        | Contratos em aberto, com long e short reportados separadamente        |
| `GET /stats/balance-distribution` | Contas por faixa de saldo                                             |

Cada um deles é documentado como **sem dados por conta, por construção**, e é por isso que são públicos. Consulte [Estatísticas da plataforma](https://docs.nexus.xyz/api-reference/guides/statistics) para ver os formatos de resposta e as armadilhas de sinal e de unidade. Em particular, os contratos em aberto reportam os dois lados separadamente, e `gross_oi_two_sided_quote` é o dobro do valor de um lado.

Não há hoje um painel público de análise no frontend de produção. Use os endpoints acima.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexus.xyz/exchange/pt-br/overview/exchange-testnet.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.