# Precios y oráculo

> Reporters de PairForge, quórum, antigüedad de los precios y pares sintéticos cruzados.

Source: https://docs.botradix.com/es/oracle/

Todos los precios que usa el BotRadix DEX proceden de **PairForge**, proveedor de datos de mercado y oráculo. El mismo precio sirve para ejecutar órdenes, valorar posiciones y decidir liquidaciones.

## Cómo se produce un precio

1. **Recogida.** Los reporters leen precios de varias fuentes: Hyperliquid, Binance, Bybit, OKX, Gate y KuCoin, con referencias en dólares de Coinbase, Kraken, Bitstamp, Gemini y Binance.US.
2. **Firma.** Hoy hay tres reporters. Un precio solo es válido en la cadena cuando lo han firmado al menos **dos de los tres** (un quórum de 2 de 3). Es configuración: PairForge admite entre tres y dieciséis reporters con mayoría estricta.
3. **Publicación.** Los precios firmados se publican en el contrato hub de PairForge en Base, junto con la tasa de funding de cada mercado.
4. **Uso.** Los contratos del DEX leen el precio del hub en el momento de cada acción y comprueban su antigüedad y su confianza.

Los reporters los opera BotRadix.

## Antigüedad y confianza

| Regla | Límite |
|---|---|
| Antigüedad máxima de un precio para usarse en la cadena | 10 segundos |
| Valorar, cerrar y liquidar (salidas) | Al menos dos lecturas coincidentes, de 10 segundos o menos |
| Abrir o aumentar riesgo | Un precio observado en el instante de la acción comprometida o después, de 10 segundos o menos, con una confianza dentro del límite del grupo del mercado |
| Pares sintéticos | Las dos patas observadas con como mucho 5 segundos de diferencia |
| Comprobación previa en el terminal | Datos de mercado de 8 segundos o menos y a menos de un 1,5 % del precio de referencia (valores por defecto del terminal). La salida propia tras 24 horas y los mercados congelados tienen sus excepciones; consulta [Cómo salir sin BotRadix](https://docs.botradix.com/es/exit/) |

Los precios se publican cuando hacen falta: cada acción del terminal, del keeper y de los bots publica primero los precios actuales, en el mismo flujo.

## Pares sintéticos cruzados

Mercados como ETH/BTC, GOLD/BTC o AVAX/DOT se valoran como el cociente de sus dos patas, cada una medida en dólares:

```text
precio(A/B) = precio(A en USD) / precio(B en USD)
```

Se operan como una única posición, liquidada en USDC.

## Sesiones de mercado

Un mercado puede cerrarse administrativamente (`SESSION_CLOSED`), por ejemplo si sus fuentes de datos dejan de ser fiables. Mientras esté cerrado, se suspenden las aperturas, cierres y liquidaciones ordinarios que necesitan un precio de sesión abierta; no es un horario de negociación fijo. Pueden conservarse órdenes limitadas pendientes, cuya primera ejecución paga taker. Los procedimientos de desafío, congelación y emergencia tienen reglas propias, y cerrar la sesión no detiene por sí solo el funding válido.

Si un mercado con posiciones deja de recibir precios, cualquiera puede abrir un desafío en la cadena; si en 3 días no llega ninguna observación nueva, el mercado se congela a su último precio observado y sus posiciones se pueden cerrar a ese precio. Para la emergencia pública hay que abrir otro desafío mientras haya posiciones y esperar 72 horas: una observación de USDC o de un mercado con posiciones desde la apertura del desafío (incluso con la sesión cerrada) impide confirmarla. El administrador puede declarar la emergencia sin esa espera. Consulta [Cómo salir sin BotRadix](https://docs.botradix.com/es/exit/).

## Seguridad y escalabilidad

### Hoy

- **Validación independiente en cada firma.** Antes de firmar, cada reporter comprueba la propuesta con sus propias observaciones de mercado. Si el precio no coincide dentro de su margen de confianza, no firma, y nunca firma dos versiones distintas del mismo turno.
- **Comprobaciones en la cadena.** El hub de PairForge verifica las firmas, el quórum y la antigüedad de cada precio antes de aceptarlo.
- **Rotación y revocación.** BotRadix puede sustituir el conjunto completo de reporters en una sola operación, comprobada en la cadena, y revocar al instante un reporter comprometido. Mientras los contratos estén abiertos, estos cambios se aplican al momento; con un futuro sellado con aviso, añadir reporters esperaría el aviso y solo revocarlos seguiría siendo inmediato. Consulta [Seguridad y contratos](https://docs.botradix.com/es/security-contracts/#fondos-permisos-y-riesgos).

### Capacidad de crecimiento

El contrato hub del oráculo en Base admite hasta **16 reporters**, con un quórum que debe ser siempre **mayoría estricta** (más de la mitad). Ampliar la red de los 3 reporters actuales a 5, 7 o 9 es una operación de configuración del administrador: no requiere cambiar el código de los contratos.

| Reporters | Firmas necesarias por precio | Reporters que pueden fallar sin interrumpir los precios |
|---|---|---|
| 3 (hoy) | 2 | 1 |
| 5 | 3 | 2 |
| 7 | 4 | 3 |
| 9 | 5 | 4 |
| 16 (máximo) | 9 | 7 |

### Hoja de ruta

Previsto según crezca el uso del ecosistema; todavía no está aplicado:

1. **Infraestructura separada.** Repartir los reporters entre servidores, proveedores y regiones distintos, cada uno con su propia conexión a la red y su propia combinación de fuentes de mercado.
2. **Más reporters.** Ampliar la red a 5 reporters con quórum de 3 y, después, a 7 o más.
3. **Referencias independientes.** Contrastar los precios de los activos principales con oráculos públicos de terceros (por ejemplo, Chainlink o Pyth) antes de firmarlos.
4. **Volatilidad extrema.** Filtros contra saltos de precio no confirmados por varias fuentes y pruebas de estrés periódicas con episodios históricos del mercado.
5. **Operadores independientes.** A largo plazo, abrir la red de reporters a operadores ajenos a BotRadix.

Cada fase se anunciará en [Novedades](https://docs.botradix.com/es/changelog/) cuando se aplique.

## Qué significa para ti

- Las órdenes se ejecutan al precio del oráculo, no a un precio de libro; tu deslizamiento máximo te protege de los movimientos adversos entre la preparación y la ejecución.
- Si no pueden publicarse precios actuales (por ejemplo, durante una incidencia de datos o de red), las acciones que los necesitan esperan hasta que vuelva a haber precios, incluidos los cierres y los retiros con posiciones cruzadas abiertas.
- Consulta [Riesgos](https://docs.botradix.com/es/risks/#riesgo-de-oraculo-y-de-datos).