Entorno de ejecución nativo de IA para estrategias de trading en OANDA
Desarrolla estrategias OANDA v20 en Cursor, Claude Code o cualquier IDE de IA. Despliega desde GitHub en un entorno de ejecución en la nube gestionado con control MCP nativo, logs y selección de región.
Sección 01 · De un vistazo
De un vistazo
- Bróker
- OANDA
- Tipo de bróker
- Bróker de Forex y CFD
- Clase de activo
- Forex, índices, materias primas, metales, bonos
- Productos compatibles
- Más de 70 pares de divisas spot FX, CFD sobre índices principales, oro y plata (XAU/USD, XAG/USD), energías (WTI, Brent), CFD sobre bonos
- Modelo de runtime
- Entorno de ejecución de estrategias en contenedores
- Origen del despliegue
- GitHub
- Lenguajes
- Cualquier lenguaje que se ejecute en un contenedor
- Integraciones comunes
- REST y streaming de OANDA v20, FIX 4.4, NautilusTrader, Backtrader, SDK nativos de Python y Java, conectores personalizados
- Integración con flujos de trabajo de IA
- Superficie de control MCP para Cursor, Claude Code, GitHub Copilot y agentes de CLI
- Rol de TradingHost
- Entorno de ejecución, despliegue, logs, comprobaciones de estado, selección de región, control MCP
- Rol de OANDA
- Cuenta de bróker, acceso a la API, acceso al mercado, centro de ejecución
- Reguladores
- OANDA Corporation (CFTC RFED, NFA ID 0325821, EE. UU.), OANDA Australia Pty Limited (ASIC AFSL 412981), OANDA Europe Markets Ltd (CySEC, Malta), OANDA Global Markets Ltd (BVI FSC), OANDA (Canada) Corp (CIRO)
- Límites de apalancamiento minorista
- EE. UU. (OANDA Corporation, NFA Rule 2-43b): 50:1 en FX principal, 20:1 en FX no principal. Australia (ASIC) y Europa (CySEC, alineado con ESMA): 30:1 en FX principal, 20:1 en FX no principal y oro, 10:1 en materias primas (excepto oro) e índices no principales, 5:1 en acciones, 2:1 en CFD sobre criptomonedas. La entidad offshore (BVI FSC) puede permitir un apalancamiento mayor según la entidad de registro correspondiente.
- Afiliación
- TradingHost es independiente y no está afiliado a OANDA Corporation ni a ninguna entidad del OANDA Group
Sección 02 · Qué ofrece OANDA
Qué ofrece OANDA
OANDA ofrece spot forex en más de 70 pares de divisas, CFD sobre índices y materias primas, metales preciosos y CFD sobre bonos a través de la API REST v20, streaming v20 mediante HTTP long-poll y una sesión FIX 4.4. Las estrategias se autentican con un token portador (bearer token) por cuenta. Los entornos de simulación (fxPractice) y real (fxTrade) son independientes, con hosts y tokens distintos. Los detalles de los endpoints se encuentran en la documentación de OANDA y pueden cambiar con el tiempo.
Mercados y patrones de estrategia
- Estrategias REST de OANDA v20 en más de 70 pares de divisas FX
- Estrategias de carry trade en EUR/USD y USD/JPY
- Rupturas de CFD sobre índices principales (SPX500, US30, NAS100, UK100)
- Estrategias de metales preciosos en XAU/USD y XAG/USD
- Estrategias de CFD sobre petróleo WTI y Brent
- Estrategias de momentum basadas en streaming de precios (HTTP long-poll)
- Despliegues validados en fxPractice y promovidos a fxTrade
- Estrategias minoristas para EE. UU. que cumplen con la regla FIFO de la NFA Rule 2-43b
Superficie de la API
- Superficies de productos
- Más de 70 pares de divisas spot FX (principales, menores, exóticas), CFD sobre índices principales (SPX500, US30, NAS100, UK100, GER40, JP225), metales preciosos (XAU/USD, XAG/USD), energías (WTI, Brent) y CFD sobre bonos. El entorno fxPractice replica la misma oferta de productos en un host de simulación para que las estrategias puedan validarse contra los mismos endpoints v20 sin arriesgar capital real.
- Métodos de conexión
- REST de OANDA v20 para colocación de órdenes, cuentas, operaciones y posiciones. Streaming v20 para precios y transacciones mediante HTTP fragmentado (chunked) con long-poll (una única conexión TCP abierta en lugar de WebSocket). FIX 4.4 para flujos minoristas profesionales e institucionales. Los SDK nativos de Python y Java encapsulan REST y streaming de v20.
- Autenticación
- Token portador: cabecera HTTP "Authorization: Bearer <token>" en cada solicitud autenticada. Un token por cuenta de OANDA, generado en Manage API Access dentro del portal de usuario. Los tokens de simulación (fxPractice) y real (fxTrade) están limitados a su entorno correspondiente y no son intercambiables.
Para más detalles, consulte OANDA
Los endpoints específicos, límites de tasa (rate limits), listas de pares de divisas, identificadores de instrumentos e historial de versiones se encuentran en la documentación de OANDA. Considéralos la fuente de información definitiva.
- developer.oanda.comPortal de desarrolladores de OANDA (v20)
- developer.oanda.com/rest-live-v20/introductionReferencia de la API REST v20
- developer.oanda.com/rest-live-v20/development-guideGuía de desarrollo v20 (hosts, tokens, entornos)
- help.oanda.com (v20 troubleshooting guide)Referencia oficial de códigos de error y comportamiento
- github.com/oanda/v20-pythonSDK nativo de Python para REST y streaming de v20
Sección 03 · Desarrollar con IA
Desarrolle su estrategia para OANDA con IA
Elija un método de integración, haga un fork de una plantilla de inicio de TradingHost y desarrolle su estrategia en un IDE de IA. Cursor, Claude Code, GitHub Copilot y los agentes de IA basados en CLI funcionan con el mismo flujo de despliegue nativo de GitHub.
API nativa de OANDA v20
Control directo sobre el comportamiento específico de OANDA, el estado de la cuenta, el streaming de precios y la ejecución de órdenes.
NautilusTrader
Framework de Python de alto rendimiento con un adaptador documentado para OANDA y un modelo de actores basado en eventos.
Backtrader
Framework estable de Python cuya clase de bróker `OandaV20Store` convierte a OANDA v20 en un entorno de ejecución de primer nivel.
FIX 4.4 o conector personalizado
Sesión FIX 4.4 de OANDA, o tu propia integración en Python o Java sobre REST y streaming de v20.
Compatibilidad de frameworks con productos de OANDA
La cobertura se adapta a la oferta de productos de OANDA. Las entidades minoristas de OANDA no ofrecen CFD sobre acciones ni sobre criptomonedas, por lo que esas columnas se marcan honestamente como "no" en lugar de dejarse en blanco.
✓ soporte confirmado según la documentación oficial del framework y la oferta de productos de OANDA. "no" indica que OANDA no ofrece esa clase de producto, no que sea una limitación del framework. Los enlaces de flujos de trabajo apuntan a páginas de /workflows/ actualmente en desarrollo.
TradingHost no impone ningún framework. Ejecuta tu proyecto.
Desarrollo con IA
Las plantillas de inicio de frameworks anteriores se integran de forma natural con los entornos de desarrollo (IDE) de IA. La interfaz de control MCP de TradingHost completa el ciclo: las herramientas de IA pueden inspeccionar despliegues, revisar registros y gestionar el entorno de ejecución junto a ti, sin intervenir nunca en la ruta de ejecución de las operaciones.
Sección 04 · Ejecución en TradingHost
Ejecuta tu código en TradingHost
OANDA proporciona la cuenta de broker y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a OANDA.
En lugar de ejecutar el código de tu estrategia en un portátil, un ordenador de sobremesa, un VPS genérico o un servidor configurado manualmente, realizas el despliegue desde GitHub en un entorno de ejecución de contenedores gestionado por TradingHost.
Tú
- Tu repositorio contiene tu código.
- Tu despliegue define cómo se ejecuta.
- Tu estrategia se conecta a OANDA.
TradingHost
- Mantiene el entorno de ejecución online.
- Muestra los registros y los controles de estado.
- Selección de región.
- Interfaz de despliegue controlada.
Flujo de despliegue
- PASO 01
Conecta GitHub
Autoriza a TradingHost para acceder a tu cuenta de GitHub.
- PASO 02
Vincula un repositorio o empieza desde un framework
Vincula TradingHost a tu repositorio de estrategias actual, o haz un fork de un entorno de ejecución de TradingHost (NautilusTrader o Backtrader para OANDA, o la plantilla de inicio de OANDA v20) para obtener una base funcional.
- PASO 03
Despliega en un contenedor de TradingHost
Selecciona una región (EU para las entidades europeas de OANDA, US-East para OANDA Corporation en EE. UU.), proporciona las variables de entorno que requiere tu estrategia (token portador v20, ID de cuenta, host fxPractice o fxTrade) y despliega. TradingHost compila tu contenedor desde el repositorio y ejecuta tu estrategia en una infraestructura administrada de Kubernetes. Sin necesidad de instalar Docker localmente.
- PASO 04
Monitoriza los registros y el estado
Sigue en directo los registros, el estado y el comportamiento del entorno de ejecución desde el panel de control de TradingHost. Puedes acceder a esta misma interfaz a través de MCP desde cualquier AI IDE, lo que permite a Cursor, Claude Code o a un agente de CLI leer el estado del despliegue y gestionar el entorno de ejecución junto a ti.
- PASO 05
Actualiza y vuelve a desplegar
Sube los cambios a tu rama principal de GitHub y TradingHost realizará el redespliegue de forma automática.
Sección 05 · Notas operativas
Notas operativas para OANDA
Problemas reales que surgen al ejecutar una estrategia de OANDA en un entorno en la nube basado en contenedores, lejos de las páginas de marketing de OANDA o de los archivos README de los frameworks. Cada afirmación a continuación se basa en la propia documentación de OANDA o en el reglamento del regulador correspondiente; las pautas de despliegue provienen de la ejecución real de estas estrategias en TradingHost.
01 · Separación de hosts
fxTrade (real) y fxPractice (demo) son hosts independientes con tokens distintos
El host REST real es api-fxtrade.oanda.com, y el de práctica es api-fxpractice.oanda.com. Los tokens se generan en Manage API Access dentro del entorno correspondiente y no son intercambiables: un token de fxTrade no servirá para autenticarse en fxPractice y viceversa. Los ID de cuenta también varían según el entorno (los ID de fxPractice suelen empezar por `101-`). Guarda los tokens de práctica y reales en entradas independientes de TradingHost Secrets; no los reutilices nunca entre entornos ni definas la dirección del host de forma estática en el código que vayas a desplegar.
02 · Autenticación
Token Bearer en la cabecera Authorization, un token por cuenta de OANDA
Cada solicitud autenticada a v20 incluye `Authorization: Bearer <token>`. El token se genera en el portal de usuario de OANDA, en la sección Manage API Access, y está vinculado al usuario para el que se creó; la selección de la cuenta se realiza a través de la ruta (`/v3/accounts/<accountID>/...`), no mediante una cabecera independiente. Rota el token si se filtra y guárdalo en los GitHub Secrets de tu repositorio, nunca en el código subido al repositorio ni en archivos de entorno.
FuenteOANDA v20 authentication03 · Streaming
Streaming de precios y transacciones mediante HTTP chunked de larga duración, no WebSocket
Los endpoints de streaming de OANDA (`/v3/accounts/<accountID>/pricing/stream`, `/v3/accounts/<accountID>/transactions/stream`) mantienen una única conexión TCP abierta y emiten fragmentos (chunks) JSON separados por saltos de línea. No hay una capa de tramas WebSocket. La lógica de reconexión del contenedor debe gestionar de forma explícita las caídas de conexión, los fragmentos incompletos y los tiempos de espera por inactividad. El stream emite periódicamente un objeto heartbeat para que el cliente detecte conexiones caídas; actúa ante la falta de heartbeats en lugar de esperar al tiempo de espera del sistema operativo.
04 · NFA Rule 2-43b
OANDA Corporation (US) aplica la ejecución de órdenes FIFO y prohíbe las coberturas por instrumento
Bajo la norma NFA Rule 2-43b, los clientes minoristas de OANDA Corporation (US) no pueden mantener posiciones largas y cortas simultáneas en el mismo instrumento, y deben cerrar las posiciones opuestas en el orden en que se abrieron (first-in, first-out). Una estrategia que envíe una orden de cobertura en el mismo par compensará la posición existente en lugar de abrir una posición independiente. Esta regla no se aplica a las entidades de OANDA fuera de US (Australia, Europe, BVI). En el caso de estrategias que se despliegan en distintas entidades, el mismo código puede generar una atribución de P&L diferente entre cuentas de US y de fuera de US.
05 · Límites de peticiones
Límites de peticiones por token; respeta la cabecera retry-after ante un error 429
OANDA aplica límites de frecuencia de peticiones por token en v20. Si se superan, se devuelve un error HTTP 429 con un cuerpo que indica la limitación (throttling). Los contenedores expuestos a condiciones de mercado de alta volatilidad (apertura de sesión, publicación de noticias) pueden superar el límite si cada iteración del bucle consulta los endpoints de cuenta o de precios. Prioriza el endpoint de streaming de precios frente al sondeo (polling), agrupa las peticiones relacionadas y aplica un retroceso exponencial (exponential backoff) ante un error 429. Los límites específicos de peticiones por segundo se detallan en la documentación de OANDA y pueden cambiar; consulta siempre su documentación oficial.
FuenteOANDA v20 best practices06 · ID de cuenta
El ID de cuenta está integrado en la ruta de la mayoría de los endpoints de v20
Las operaciones, posiciones, transacciones, precios y la mayoría de los endpoints de cuenta tienen la estructura `/v3/accounts/<accountID>/<resource>`. El token bearer autentica al usuario; la ruta selecciona la cuenta. Un usuario que tenga tanto una subcuenta como una cuenta principal dispondrá de dos accountID distintos, y la estrategia deberá elegir el correcto. El endpoint `/v3/accounts` enumera todos los accountID a los que el token tiene acceso, y `/v3/accounts/<accountID>/summary` confirma la divisa, la entidad de apalancamiento y el saldo antes de que la estrategia empiece a enviar órdenes.
07 · Reporte regulatorio
El reporte bajo EMIR, MiFID II y Dodd-Frank es responsabilidad de OANDA, no de TradingHost
OANDA Europe Markets Ltd reporta bajo EMIR y MiFID II. OANDA Corporation reporta bajo las normas de reporte de datos de swaps del Dodd-Frank Title VII como CFTC RFED. OANDA Australia reporta bajo las normas de reporte de operaciones de derivados de ASIC. TradingHost no realiza reportes regulatorios de operaciones en tu nombre ni es un servicio de reporte. El código de la estrategia que ejecutas en TradingHost es tu propia actividad algorítmica; la obligación de reportar recae sobre el bróker registrado, que es la entidad de OANDA que mantiene la cuenta.
Sección 06 · Diseñado para
Diseñado para
Los entornos de ejecución de TradingHost para OANDA son ideales para:
- Desarrolladores que crean estrategias en IDE de IA (Cursor, Claude Code)
- Desarrolladores de estrategias cuantitativas de FX
- Traders de carry trade y momentum de índices
- Usuarios de NautilusTrader y Backtrader
- Equipos que migran de MetaTrader y hosting VPS a despliegues en contenedores
Conectar GitHub y crear tu primera estrategia es gratis.
Sección 08 · Preguntas frecuentes
Preguntas frecuentes
No. TradingHost es independiente y no está afiliado a OANDA Corporation ni a ninguna entidad del grupo OANDA.
No. TradingHost no es un bróker ni una empresa de inversión registrada. TradingHost es un entorno de ejecución (runtime) en la nube que ejecuta el código de tu estrategia. La relación con el bróker, la cuenta, el apalancamiento, la ejecución y las protecciones regulatorias corresponden en su totalidad a OANDA. Debes registrarte directamente en la entidad de OANDA correspondiente a tu jurisdicción.
No. El código de tu estrategia se conecta a OANDA y envía instrucciones según tu propia lógica, los permisos de tu cuenta y el método de integración. TradingHost proporciona el entorno de ejecución donde se ejecuta dicho código.
No. El acceso a la API v20 de OANDA lo proporciona OANDA. Tú eres responsable de tu cuenta de OANDA, de los permisos de acceso a la API, de la rotación de los tokens bearer y del cumplimiento de los términos de servicio de OANDA.
Sí. TradingHost ejecuta estrategias en Python; elige un entorno de ejecución compatible con tu framework (NautilusTrader, Backtrader o la plantilla de inicio de OANDA v20) o despliega tu propio repositorio. El SDK nativo v20-python de OANDA está soportado.
Sí. TradingHost admite cualquier lenguaje que pueda ejecutarse dentro de un contenedor. Los endpoints REST y de streaming de la API v20 de OANDA se basan en HTTP, por lo que cualquier lenguaje con un cliente HTTP puede realizar llamadas a ellos.
Sí, siempre que tu proyecto esté diseñado de esa forma. Puedes ejecutar múltiples procesos o servicios de estrategia dentro de un único entorno de ejecución, o separarlos en diferentes entornos para mayor aislamiento y claridad operativa. Consulta la página de entornos de ejecución de TradingHost para conocer el modelo multiestrategia.
TradingHost ejecuta cargas de trabajo en contenedores en la nube, no terminales de escritorio de MetaTrader 4 o MetaTrader 5. Si tu estrategia de OANDA es un Expert Advisor de MT4 o MT5 compilado en MQL, dicho EA se ejecuta dentro del terminal de MetaTrader y, tradicionalmente, requiere un VPS con Windows para permanecer activo. Para usar TradingHost, debes portar la lógica a un cliente REST o de streaming de v20; ese es el formato compatible con TradingHost.
La vía más rápida es hacer un fork de un entorno de ejecución de TradingHost: tanto NautilusTrader como Backtrader ofrecen soporte nativo de primer nivel para OANDA. También puedes conectar tu propio repositorio de estrategias de GitHub. Vincular un repositorio de GitHub y crear una estrategia es gratis; los planes de los entornos de ejecución se detallan en la página de precios.
Sí. El apalancamiento lo define la entidad de OANDA que mantiene tu cuenta, no TradingHost. OANDA Corporation (US) limita el apalancamiento minorista a 50:1 en pares de divisas principales (major FX) y a 20:1 en pares secundarios (non-major FX) según la norma NFA Rule 2-43b. OANDA Australia (ASIC) y OANDA Europe Markets (CySEC) limitan las divisas principales a 30:1, las secundarias y el oro a 20:1, con límites inferiores para otros instrumentos. OANDA Global Markets (BVI) permite un apalancamiento mayor según las normas de la BVI FSC. Los límites de apalancamiento dependen del regulador de la entidad donde tengas la cuenta; la interfaz de la API es la misma.
En tu flujo de trabajo de secretos gestionado por GitHub. TradingHost lee el token en tiempo de ejecución a través de los secretos del repositorio de GitHub, secretos de entorno o tu propio proceso aprobado de gestión de secretos. TradingHost no necesita la custodia de tu token.
No. Los tokens de OANDA v20 otorgan acceso a la negociación, al estado de la cuenta y a los precios, pero no a retiros ni depósitos de fondos. Los depósitos y retiros se realizan a través del portal de usuario de OANDA, no mediante la API. Mantén las operaciones con permisos de retiro totalmente fuera de la interfaz de v20.
Sí. TradingHost admite el control basado en MCP para IDEs de IA, incluidos Cursor, Claude Code, GitHub Copilot y agentes de IA basados en CLI. Las herramientas de IA pueden inspeccionar despliegues, revisar logs, reiniciar estrategias y gestionar flujos de trabajo del runtime. MCP es una interfaz de control y observabilidad, no la ruta de ejecución de operaciones.
No. El reporte de operaciones bajo EMIR y MiFID II es responsabilidad del bróker. OANDA Europe Markets Ltd reporta bajo EMIR y MiFID II como empresa de servicios de inversión regulada. OANDA Corporation reporta bajo las normas de reporte de datos de swaps de la Dodd-Frank Title VII como CFTC RFED. OANDA Australia reporta bajo las normas de reporte de operaciones con derivados de ASIC. TradingHost ejecuta su código; el bróker de registro se encarga del reporte regulatorio.
TradingHost se ejecuta en las regiones EU y US-East. La región EU es la opción natural para el tráfico de OANDA Europe Markets y OANDA Australia; US-East es la opción idónea para el tráfico de OANDA Corporation (EE. UU.).
No. TradingHost se centra en el despliegue y el entorno de ejecución en producción. El backtesting corresponde a su entorno de investigación, framework (el backtester de NautilusTrader, el motor de Backtrader, vectorbt) o a AlgoBuilder.