# BotRadix Documentation

> BotRadix is a trading platform with an on-chain perpetual futures exchange (BotRadix DEX) on Base (chain ID 8453), automated trading bots (Quant and Grid) that run on connected exchanges or on the BotRadix DEX, the BAQ token, and a developer API. These docs explain how every part works, its fees, limits and risks.

- Platform: https://botradix.com · DEX terminal: https://app.botradix.com · Docs: https://docs.botradix.com
- Network: Base mainnet, chain ID 8453; settlement in USDC; BAQ and USDC accepted as DEX collateral
- Every page is also available as Markdown by adding .md to its path (for example /dex-overview.md)
- Spanish versions live under /es/ (for example /es/dex-overview/)
- BAQ: BotRadix utility token on Base. Deposited on the DEX it adds extra cross-margin equity: a credit of up to 5% of its value, capped at 20% of eligible USDC and by what remains of the 70% usable BAQ reserve. Under the code in force, BAQ is not sold to cover losses (it keeps its price risk). The 5%, 20% and 70% values can be adjusted by the administrator within the limits of the code in force (at most 20%, 50% and 90%) and apply live; sealing is planned by component and inactive. The BAQ reserve is funded by 10% of DEX opening fees and isolated liquidation penalties; backed loss payments can reduce available credit, so activity does not guarantee reserve growth
- Oracle: prices come from PairForge, a market-data and oracle provider; on Base they are signed by 3 reporters operated by BotRadix with a 2-of-3 quorum today; the oracle hub contract supports up to 16 reporters with a strict-majority quorum by configuration (no contract code change), and a wider, distributed reporter network is planned as the ecosystem grows
- DEX contracts v2.2, live since 11 October 2026: 150 perpetual markets, gross profit cap of 20 times size for new exposure (earlier exposure keeps its cap), auto-deleveraging (winning positions can be reduced or closed early without a closing fee when the vault is at risk; anything liquidity cannot cover is deferred) and backed take profit, leverage up to 100x by position-size tier, opening fee 0.06% taker / 0.03% maker plus a 0.03% BotRadix service fee (signed consent required), no closing fee, funding capped at 0.03% per 8 hours by the current operational policy (contract maximum ±1%), minimum position 18 USDC; fees and other parameters adjustable within the limits of the code in force; contracts open and unsealed with 0-hour mandatory notice
- Stage and transparency: BotRadix is live on Base mainnet in a deliberate consolidation phase. The contracts stay upgradeable by a single BotRadix administrator key so issues can be fixed and features added quickly: router changes go through an on-chain advance-notice gate (0 hours today) and the cross-margin contract and other logic can be changed at any time without mandatory advance notice; sealing is planned by component once the system has proven stable; absolute custody protection is not guaranteed. Check source verification for each address on BaseScan; no third-party audit has been published yet. Fees, limits and risks are documented openly
- New BotRadix account registrations are temporarily closed; the DEX is open to any wallet

## Documentation (English)

### Get started
- [BotRadix documentation](https://docs.botradix.com/index.md): What BotRadix is, what you can do with it and where to find each answer.
- [Quickstart](https://docs.botradix.com/quickstart.md): From zero to your first DEX trade or your first bot, step by step.
- [Mobile app (Android)](https://docs.botradix.com/mobile.md): Install the official Android app, verify it and use the DEX and bots from your phone.
- [Key concepts](https://docs.botradix.com/concepts.md): Wallets, collateral, margin, leverage, PnL, funding and liquidation in plain language.

### BotRadix DEX
- [How the DEX works](https://docs.botradix.com/dex-overview.md): Perpetual futures on Base: who you trade against, how prices are set and where your collateral is held.
- [Collateral, deposits and withdrawals](https://docs.botradix.com/collateral.md): USDC and BAQ as collateral, cross and isolated margin, and the checks behind every withdrawal.
- [Orders and positions](https://docs.botradix.com/orders.md): Market and limit orders, take profit and stop loss, partial closes, inversion and size limits.
- [Leverage and margin](https://docs.botradix.com/margin.md): Leverage tiers, initial and maintenance margin, health factor and the per-position profit cap.
- [Liquidation](https://docs.botradix.com/liquidation.md): When a position is liquidated, how the liquidation price is calculated and how to avoid it.
- [Funding](https://docs.botradix.com/funding.md): The continuous payment that balances long and short exposure: formula, cap, direction and examples.
- [Fees](https://docs.botradix.com/fees.md): Every cost of trading on the DEX, in one table, with examples.
- [Prices and oracle](https://docs.botradix.com/oracle.md): PairForge reporters, quorum, price freshness and synthetic cross pairs.
- [Markets](https://docs.botradix.com/markets.md): The 150 markets by category, their parameters and how new markets are listed.
- [Signatures and trading sessions](https://docs.botradix.com/sessions.md): What your wallet signs, your trading key, trading sessions and how to revoke them.

### Bots and automation
- [Quant bot](https://docs.botradix.com/quant.md): How the Quant bot enters, adds with DCA, takes profit and records results.
- [Grid bot](https://docs.botradix.com/grid.md): Range trading on the BotRadix DEX, Hyperliquid and Uniswap: levels, profits and risks.
- [Connecting exchanges](https://docs.botradix.com/exchanges.md): Supported venues, the API permissions to grant and how your keys are protected.
- [History, PnL and exports](https://docs.botradix.com/history.md): How results are recorded and reported, and how to export them.

### BAQ token
- [BAQ](https://docs.botradix.com/baq.md): The BAQ token on Base: contract, decimals, uses in BotRadix and public data.

### Developers
- [API overview and authentication](https://docs.botradix.com/api.md): Base URL, API keys, scopes, wallet-signed developer sessions and key management.
- [API reference](https://docs.botradix.com/api-reference.md): Every v1 endpoint with method, scope and purpose.
- [Trading through the API](https://docs.botradix.com/api-orders.md): Prepare, sign or execute actions, idempotency and a complete example.
- [Real-time data and webhooks](https://docs.botradix.com/api-realtime.md): Signed webhooks, how to verify them, and the status of the streaming endpoint.
- [Errors, limits and versioning](https://docs.botradix.com/api-errors.md): Error format, rate limits, headers and the versioning policy.

### Security and transparency
- [Security](https://docs.botradix.com/security.md): How accounts, keys and funds are protected, and what you should do on your side.
- [Smart contracts](https://docs.botradix.com/contracts.md): Public contract addresses, upgradeability and administrative controls.
- [Security and contracts](https://docs.botradix.com/security-contracts.md): Official addresses, administrative powers, the prior-notice gate, pausers, staged sealing and review scope.
- [Exit without the website](https://docs.botradix.com/exit.md): How BotradixSalida handles exit requests, self-execution after 24 hours, withdrawals and order cancellation, with their limits.
- [How to read BotRadix proxies](https://docs.botradix.com/proxies.md): Follow router facets, module routes, CrossMargin and business controls without assuming EIP-1967.
- [Reproducible compilation](https://docs.botradix.com/reproducible-build.md): The solc 0.8.37 recipe, exact input hash and checks for relating sources, artifacts and deployed code.
- [Risks](https://docs.botradix.com/risks.md): The risks of leveraged trading, automation and smart contracts, stated plainly.

### Help
- [FAQ](https://docs.botradix.com/faq.md): Short answers to the questions users ask most.
- [Glossary](https://docs.botradix.com/glossary.md): Definitions of the terms used across BotRadix.
- [Support and legal](https://docs.botradix.com/support.md): How to get help, and where to find the terms and privacy policy.
- [Changelog](https://docs.botradix.com/changelog.md): Notable changes to the platform, the DEX and these docs.

## Documentación (Español)

### Empezar
- [Documentación de BotRadix](https://docs.botradix.com/es/index.md): Qué es BotRadix, qué puedes hacer con él y dónde encontrar cada respuesta.
- [Primeros pasos](https://docs.botradix.com/es/quickstart.md): De cero a tu primera operación en el DEX o tu primer bot, paso a paso.
- [App móvil (Android)](https://docs.botradix.com/es/mobile.md): Instala la app oficial de Android, verifícala y usa el DEX y los bots desde el móvil.
- [Conceptos clave](https://docs.botradix.com/es/concepts.md): Wallets, colateral, margen, apalancamiento, PnL, funding y liquidación explicados con claridad.

### BotRadix DEX
- [Cómo funciona el DEX](https://docs.botradix.com/es/dex-overview.md): Futuros perpetuos en Base: contra quién operas, cómo se fijan los precios y dónde está tu colateral.
- [Colateral, depósitos y retiros](https://docs.botradix.com/es/collateral.md): USDC y BAQ como colateral, margen cruzado y aislado, y las comprobaciones de cada retiro.
- [Órdenes y posiciones](https://docs.botradix.com/es/orders.md): Órdenes a mercado y limitadas, take profit y stop loss, cierres parciales, inversión y límites de tamaño.
- [Apalancamiento y margen](https://docs.botradix.com/es/margin.md): Tramos de apalancamiento, margen inicial y de mantenimiento, factor de salud y beneficio máximo por posición.
- [Liquidación](https://docs.botradix.com/es/liquidation.md): Cuándo se liquida una posición, cómo se calcula el precio de liquidación y cómo evitarla.
- [Funding](https://docs.botradix.com/es/funding.md): El pago continuo que equilibra la exposición long y short: fórmula, tope, sentido y ejemplos.
- [Comisiones](https://docs.botradix.com/es/fees.md): Todos los costes de operar en el DEX, en una tabla, con ejemplos.
- [Precios y oráculo](https://docs.botradix.com/es/oracle.md): Reporters de PairForge, quórum, antigüedad de los precios y pares sintéticos cruzados.
- [Mercados](https://docs.botradix.com/es/markets.md): Los 150 mercados por categoría, sus parámetros y cómo se listan mercados nuevos.
- [Firmas y sesiones de trading](https://docs.botradix.com/es/sessions.md): Qué firma tu wallet, tu clave de trading, las sesiones de trading y cómo revocarlas.

### Bots y automatización
- [Bot Quant](https://docs.botradix.com/es/quant.md): Cómo entra, añade con DCA, toma beneficios y registra resultados el bot Quant.
- [Bot Grid](https://docs.botradix.com/es/grid.md): Trading en rango en el BotRadix DEX, Hyperliquid y Uniswap: niveles, beneficios y riesgos.
- [Conectar exchanges](https://docs.botradix.com/es/exchanges.md): Exchanges compatibles, los permisos que debes conceder y cómo se protegen tus claves.
- [Historial, PnL y exportaciones](https://docs.botradix.com/es/history.md): Cómo se registran y se muestran los resultados, y cómo exportarlos.

### Token BAQ
- [BAQ](https://docs.botradix.com/es/baq.md): El token BAQ en Base: contrato, decimales, usos en BotRadix y datos públicos.

### Desarrolladores
- [API: visión general y autenticación](https://docs.botradix.com/es/api.md): URL base, claves de API, scopes, sesiones de desarrollador firmadas y gestión de claves.
- [Referencia de la API](https://docs.botradix.com/es/api-reference.md): Todos los endpoints v1 con método, scope y propósito.
- [Operar con la API](https://docs.botradix.com/es/api-orders.md): Preparar, firmar o ejecutar acciones, idempotencia y un ejemplo completo.
- [Tiempo real y webhooks](https://docs.botradix.com/es/api-realtime.md): Webhooks firmados, cómo verificarlos y el estado del endpoint de streaming.
- [Errores, límites y versionado](https://docs.botradix.com/es/api-errors.md): Formato de errores, límites de uso, cabeceras y política de versionado.

### Seguridad y transparencia
- [Seguridad](https://docs.botradix.com/es/security.md): Cómo se protegen cuentas, claves y fondos, y qué debes hacer por tu parte.
- [Contratos inteligentes](https://docs.botradix.com/es/contracts.md): Direcciones públicas de los contratos, actualizaciones y controles de administración.
- [Seguridad y contratos](https://docs.botradix.com/es/security-contracts.md): Direcciones oficiales, poderes de administración, puerta de aviso, pausadores, sellado por partes y alcance de las revisiones.
- [Salir sin la web](https://docs.botradix.com/es/exit.md): Cómo funciona BotradixSalida: petición, ejecución propia a las 24 horas, retiros y cancelación de órdenes, con sus límites.
- [Cómo leer los proxies de BotRadix](https://docs.botradix.com/es/proxies.md): Seguir facetas, rutas modulares, CrossMargin y controles de negocio sin asumir EIP-1967.
- [Compilación reproducible](https://docs.botradix.com/es/reproducible-build.md): Receta con solc 0.8.37, hash de la entrada exacta y comprobaciones de fuentes, artefactos y código desplegado.
- [Riesgos](https://docs.botradix.com/es/risks.md): Los riesgos del trading apalancado, la automatización y los contratos inteligentes, sin rodeos.

### Ayuda
- [Preguntas frecuentes](https://docs.botradix.com/es/faq.md): Respuestas breves a las preguntas más habituales.
- [Glosario](https://docs.botradix.com/es/glossary.md): Definiciones de los términos que usa BotRadix.
- [Soporte y legal](https://docs.botradix.com/es/support.md): Cómo obtener ayuda y dónde están los términos y la política de privacidad.
- [Novedades](https://docs.botradix.com/es/changelog.md): Cambios relevantes en la plataforma, el DEX y esta documentación.

## Optional

- [Full documentation, English](https://docs.botradix.com/llms-full.txt): every page in one Markdown file
- [Documentación completa, español](https://docs.botradix.com/es/llms-full.txt): todas las páginas en un archivo
- [Sitemap](https://docs.botradix.com/sitemap.xml)