> 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/es-419/overview/exchange-testnet.md).

# Testnet del Exchange

Opera en la plataforma de testnet: autentícate, genera una clave, reclama USDX sintético y envía una orden.

Nexus Exchange está en vivo en testnet en [nexus.xyz/trade](https://nexus.xyz/trade).

Puedes autenticarte a través de la API, enviar órdenes y operar los mercados de futuros perpetuos en vivo.

El frontend muestra el estado en vivo del exchange en modo de solo lectura. Todo el trading pasa por las API REST y WebSocket.

La sección [Referencia de la API](https://docs.nexus.xyz/api-reference) de esta documentación tiene la documentación completa de la API.

### Primeros pasos

#### 1. Autentícate

Inicia sesión con tu billetera de Ethereum usando una firma personal EIP-191:

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

Firma el mensaje `"Sign in to Nexus Exchange"` para recibir un token de sesión (TTL de 24 horas). Tu primer inicio de sesión crea tu cuenta.

#### 2. Crea una clave de API

```bash
POST /keys
```

La llamada devuelve un par de claves HMAC (`key_id` + `secret`). El secreto se muestra una sola vez, así que guárdalo de inmediato.

Administra las claves con `GET /keys` (listar) y `DELETE /keys/{key_id}` (revocar).

#### 3. Fondea tu cuenta

Acredita tu cuenta de testnet con USDX sintético del faucet:

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

Necesitas un saldo de USDX antes de poder enviar órdenes. Consulta tu saldo en cualquier momento con `GET /account`.

**Cada clave de API puede reclamar hasta 500 USDX de prueba por día.**

#### 4. Envía una orden

Autentica todas las solicitudes de trading con tres encabezados: `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"
}
```

Consulta la sección [Referencia de la API](https://docs.nexus.xyz/api-reference) para ver ejemplos completos de autenticación y todos los endpoints disponibles.

### Mercados

Hay tres perpetuos de cripto en vivo, todos denominados en USDX:

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

El conjunto cambia a medida que se listan y deslistan mercados. Consulta `GET /markets` para ver lo que está en vivo ahora, o `GET /markets/summary` para ver el conjunto con sus estadísticas. Consulta el [Directorio de activos](/exchange/es-419/asset-directory/asset-directory.md) para ver las clases que vienen después.

### Telemetría de la plataforma

La telemetría agregada de la plataforma está disponible por la API. Estos endpoints son **públicos** y no necesitan clave de API:

| Endpoint                          | Qué devuelve                                                                  |
| --------------------------------- | ----------------------------------------------------------------------------- |
| `GET /stats`                      | Instantánea de la plataforma, incluidos los conteos móviles de traders únicos |
| `GET /stats/history`              | Muestras de throughput a lo largo del tiempo                                  |
| `GET /stats/volume`               | Nocional operado acumulado, total de la plataforma y por mercado              |
| `GET /stats/open-interest`        | Interés abierto, con Long y Short informados por separado                     |
| `GET /stats/balance-distribution` | Cuentas por rango de saldo                                                    |

Según su documentación, ninguno de estos **contiene datos por cuenta, por diseño**, y por eso son públicos. Consulta [Estadísticas de la plataforma](https://docs.nexus.xyz/api-reference/guides/statistics) para ver las formas de las respuestas y las trampas de signo y de unidad. En particular, el interés abierto informa los dos lados por separado, y `gross_oi_two_sided_quote` es el doble de la cifra de un solo lado.

Hoy no hay un panel público de analítica en el frontend de producción. Usa los endpoints de arriba.


---

# 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/es-419/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.