> 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/api-reference/es-419/guides/statistics.md).

# Estadísticas de la plataforma

**Esta página cubre lo que las páginas generadas de la Referencia no pueden cubrir.** Cada una de las tres operaciones tiene su propia página generada a partir del contrato. Esta página cubre lo que comparten: por qué son públicas, qué significan las cifras y tres lugares donde una lectura plausible es incorrecta.

Telemetría agregada de la plataforma: volumen operado acumulado, interés abierto y la distribución de los saldos de las cuentas. **Tres operaciones, todas públicas.** Declaran `security: []`, así que no se necesita clave de API.

Estas son las cifras de toda la plataforma. El estado por cuenta está en las páginas de Account de la barra lateral de la Referencia y en las páginas de Positions.

## Agregadas por diseño

Cada esquema de esta página está documentado como que **no contiene ningún dato por cuenta**: *"Solo agregados — no lleva ningún id de cuenta, dirección ni volumen por cuenta, por diseño."* Esa es la redacción del propio contrato, y es la razón por la que estos endpoints son públicos mientras que todo lo de Account no lo es.

Si estás construyendo un panel público, una página de datos de mercado o un agente que necesita contexto de la plataforma, **estos son los endpoints que debes usar.** No derives agregados de la plataforma repartiendo solicitudes entre lecturas por cuenta.

## En esta página

| Operación                                                                                                        | Ruta                              | Qué devuelve                                                     |
| ---------------------------------------------------------------------------------------------------------------- | --------------------------------- | ---------------------------------------------------------------- |
| [Volumen acumulado (en inglés)](https://docs.nexus.xyz/api-reference/statistics/fetch-cumulative-volume)         | `GET /stats/volume`               | Nocional operado acumulado, total de la plataforma y por mercado |
| [Interés abierto (en inglés)](https://docs.nexus.xyz/api-reference/statistics/fetch-open-interest)               | `GET /stats/open-interest`        | Interés abierto, con Long y Short informados por separado        |
| [Distribución de saldos (en inglés)](https://docs.nexus.xyz/api-reference/statistics/fetch-balance-distribution) | `GET /stats/balance-distribution` | Cuentas por rango de saldo                                       |

**Hay dos operaciones `/stats` más documentadas en otro lugar.** `GET /stats` (instantánea de la plataforma) y `GET /stats/history` (muestras de throughput) tienen la etiqueta `Markets` en el contrato y se cubren en [`GET /stats`](https://docs.nexus.xyz/api-reference/markets/fetch-stats). Las cinco son públicas.

Ninguna de las tres operaciones de aquí tiene una gemela `/api/v1`. Solo son rutas del gateway.

## Los datos de testnet son ilustrativos, y el contrato lo dice en la propia respuesta

Las tres respuestas llevan dos campos que deberías mostrar en lugar de descartar:

| Campo     | Significado                                                                                                       |
| --------- | ----------------------------------------------------------------------------------------------------------------- |
| `testnet` | booleano, **siempre `true`** hoy. Los datos son ilustrativos.                                                     |
| `note`    | un aviso legible por humanos, que incluye la advertencia sobre un solo lado frente al bruto en el interés abierto |

Las cifras **se reinician cuando se reinicia el servicio**, porque son proyecciones locales del indexador, no un libro contable histórico. `coverage_start_ms` en la respuesta de volumen te indica hasta dónde llega un total.

## Los decimales son cadenas

Cada cifra nocional es un decimal sin pérdida serializado como cadena (el esquema [`Decimal`](https://docs.nexus.xyz/api-reference/guides/schemas#decimal)). **Analízala con un tipo decimal, nunca con un float.** `account_count` y `count` son enteros JSON, y las marcas de tiempo son milisegundos de época Unix ([`TimestampMs`](https://docs.nexus.xyz/api-reference/guides/schemas#timestampms)).

## Los dos lados nunca se suman de antemano, y los nombres son deliberados

Lee esto antes de rotular cualquier número de este endpoint.

* **`long_oi_quote` (o `short_oi_quote`) es la cifra que hay que rotular.** En un libro emparejado, las dos son iguales por diseño. Una diferencia persistente significa que la proyección se desincronizó del motor.
* **`gross_oi_two_sided_quote` es `long + short`,** el doble de la cifra de un solo lado. Se llama `gross` y `two_sided` para que nadie pueda hacerla pasar por el total de un solo lado.
* **Las cifras de la plataforma son solo en la moneda de cotización.** No hay un total en unidades base para toda la plataforma, a propósito. Las unidades base no se suman entre mercados, así que el contrato no publica un número sin una unidad coherente.

## Relacionado

* [`GET /stats`](https://docs.nexus.xyz/api-reference/markets/fetch-stats): `GET /stats` y `GET /stats/history`, más resúmenes por mercado y parámetros de riesgo.
* Las páginas de Tickers de la barra lateral de la Referencia: estadísticas de precio y volumen móviles de 24 horas por mercado.
* [Esquemas (en inglés)](https://docs.nexus.xyz/api-reference/guides/schemas): referencia de los esquemas de componentes.

## Preguntas abiertas

Vacíos del contrato, señalados en lugar de rellenados:

* **No se declaran esquemas para los tipos de los límites de los subobjetos.** `BalanceBucket.min` y `max` tienen descripciones pero ningún tipo declarado en el contrato. Esta página los documenta como cadenas decimales, basándose en "in USDX collateral" y en la convención decimal de toda la página.
* **`testnet` está tipado como booleano pero documentado como "siempre `true`".** No hay un comportamiento definido para un despliegue en el que sería `false`, y ninguna operación expone con qué despliegue estás hablando.
* **La retención no está definida.** Las tres se describen como que se reinician con el servicio, pero el contrato no da ninguna ventana de retención, tamaño de búfer ni cadencia de checkpoints. Así que el contrato no te dice hasta dónde puede llegar `coverage_start_ms`.
* **Los valores de `quote_error` no están enumerados.** La prosa describe tres causas (ningún precio de marca replicado, precio de marca desactualizado, desbordamiento) pero no especifica las cadenas, así que no puedes ramificar tu lógica según ellas de forma segura.


---

# 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/api-reference/es-419/guides/statistics.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.