Compatible con cuentas MetaTrader 5® de XBTFX

XBTFX Trading API

Opera de forma programática, gestiona posiciones, monitoriza el estado de tu cuenta y transmite datos de mercado en tiempo real sobre cuentas XBTFX MetaTrader 5® compatibles a través de REST y WebSocket. Construye estrategias automatizadas, conecta agentes IA e integra tu cuenta en flujos personalizados. Empieza con la documentación, los ejemplos, las AI skills o el servidor XBTFX MCP. Pensado para desarrolladores y usuarios con experiencia en programación o asistentes IA de código.

  • Cuentas Pro
  • Acceso programático completo
  • Modos hedging y netting
  • Listo para agentes IA (MCP)
terminal
# Send a trade to your XBTFX account
curl -X POST https://interface.xbtfx.com/v1/trade \
  -H "Authorization: Bearer xbtfx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "EURUSD",
    "side":   "buy",
    "volume": 0.10,
    "sl":     1.08200,
    "tp":     1.09000
  }'

# Response
{
  "status":  "filled",
  "retcode": 10009,
  "deal":    184729,
  "price":   1.08650,
  "volume":  0.10
}
Protocolo
REST
Streaming
WebSocket
Weight / min
600
Formato de respuesta
JSON

Automatiza tu trading con la XBTFX API

La XBTFX Trading API te permite enviar instrucciones a tu cuenta XBTFX MetaTrader 5® compatible. Abre posiciones, modifica stops, consulta balances y transmite cotizaciones en vivo mediante llamadas REST y WebSocket estándar.

Estrategias automatizadas

Construye bots de trading y estrategias algorítmicas que envíen operaciones a tu cuenta automáticamente. Ejecuta lógica basada en señales, reequilibrio de cartera o gestión de riesgo personalizada.

Integración de agentes IA

Conecta asistentes IA a tu cuenta a través del XBTFX Skills Hub o el servidor MCP. Da órdenes de trading en lenguaje natural mediante Claude Code, Cursor, Windsurf u otros clientes compatibles.

Integraciones a medida

Construye dashboards, conéctate a fuentes externas, redirige señales desde otras plataformas o integra los datos de tu cuenta en tus propios sistemas de reporting y analítica.

Endpoints API para trading, posiciones y datos de mercado

Abre y cierra posiciones, define stop loss y take profit, consulta balances de cuenta, recupera el historial de operaciones y transmite cotizaciones en vivo de forex y cripto vía WebSocket.

Documentación API

POSTEnviar operaciones

Envía órdenes de mercado a tu cuenta con stop loss y take profit. Soporta los modos de margen hedging y netting.

/v1/trade

POSTCerrar y modificar

Cierra posiciones de forma total o parcial. Actualiza SL/TP en posiciones abiertas. Cierra todo, cierra por símbolo o nettea posiciones opuestas.

/v1/close · /v1/modify · /v1/close-all

GETPosiciones y órdenes

Recupera todas las posiciones abiertas y órdenes pendientes en tiempo real. Filtra por símbolo. Respuestas servidas desde caché con actualizaciones push en vivo.

/v1/positions · /v1/orders

GETCuenta y balance

Balance, equity, margen, margen libre, PnL flotante y apalancamiento en tiempo real. Una sola llamada para una vista completa.

/v1/account

GETSímbolos y especificaciones

Lista completa de símbolos con bid/ask en vivo, spread, tamaño de contrato, volumen mín/máx/paso, dígitos y requisitos de margen.

/v1/symbols · /v1/symbols/:symbol

WSStreaming WebSocket

Cotizaciones en streaming en tiempo real con profundidad de mercado de 5 niveles. Suscríbete a los símbolos disponibles en tu cuenta.

wss://ws.xbtfx.com/v1/ws

Envía tu primera operación API en minutos

Unas pocas líneas de código en el lenguaje que prefieras. HTTP estándar — funciona cualquier lenguaje capaz de hacer una petición POST.

# Send a buy order to your XBTFX account
curl -X POST https://interface.xbtfx.com/v1/trade \
  -H "Authorization: Bearer $XBTFX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"EURUSD","side":"buy","volume":0.10,"sl":1.082,"tp":1.09}'

# Retrieve open positions
curl https://interface.xbtfx.com/v1/positions \
  -H "Authorization: Bearer $XBTFX_API_KEY"

interface.xbtfx.comShell

AI-Ready

Ejecuta operaciones con lenguaje natural

La XBTFX Trading API está pensada para ser consumida por agentes IA y modelos de lenguaje grandes — JSON limpio, errores legibles, endpoints predecibles. Conecta vía el XBTFX Skills Hub o el servidor MCP y tu cliente IA podrá enviar operaciones mediante órdenes conversacionales.

  • Órdenes conversacionales — comprar, vender, cerrar, condicionar a datos.
  • Razonamiento basado en herramientas — cada acción devuelve una respuesta estructurada.
  • Portable entre clientes — Claude, Cursor, Windsurf, Codex.

¿Menos técnico? Mira nuestra página AI Agent Trading.

Ejemplo de conversación

XBTFX Trading Agentonline · executing trades

Today · 13:25 GMT

If today's NFP prints above 200k, close all my open EURUSD and GBPUSD trades.

13:25 ✓✓

Got it. Watching the BLS release at 13:30 GMT. I'll close 4 positions if NFP > 200k.

13:25

tool · xbtfx_get_positions4 open · EURUSD ×2, GBPUSD ×2 · floating +$184.20

13:26

13:30 · NFP released: 247k (forecast 195k)

tool · xbtfx_close_all (filter: EURUSD, GBPUSD)Closed 4 positions in 38 ms · realized +$212.80

13:30

Ejemplo ilustrativo. Los flujos condicionales dependen del agente y de los feeds de datos de mercado configurados.

Casos de uso

Qué hacen los agentes IA con la API

Cuatro patrones habituales que vemos en flujos automatizados y dirigidos por IA en cuentas XBTFX.

Trading basado en eventos

La IA monitoriza noticias y datos económicos en tiempo real, enviando operaciones a tu cuenta cuando se detectan eventos que mueven el mercado.

Gestión inteligente de riesgo

La IA sigue tu margen, PnL flotante y exposición, ajustando stops, reduciendo tamaños o cerrando operaciones para proteger el capital.

Reequilibrio de cartera

Define asignaciones objetivo y deja que la IA las mantenga, enviando operaciones de ajuste cuando la desviación supera tu umbral.

Análisis autónomo

Pídele a tu IA que analice tu historial, calcule el porcentaje de aciertos por símbolo e identifique tus setups más rentables.

Pensado para tu cuenta XBTFX existente

Usa tu cuenta MetaTrader 5 Pro actual, tu moneda base existente y tu modo de margen actual. La API se conecta a la misma cuenta con la que ya operas.

Especificaciones técnicas

Endpoints listos para producción

Modos hedging y netting
Ambos modos de margen MT5 son compatibles. El modo queda vinculado a tu API key.
Claves de idempotencia
Envía la misma clave en menos de 120 segundos y devolvemos la respuesta cacheada. Reintentos seguros, sin órdenes duplicadas.
Rate limits por peso
600 weight / min por clave. Lecturas y operaciones cuestan 1, las operaciones masivas 10. Las cabeceras exponen tu presupuesto restante en cada respuesta.
Límites de streaming
Hasta 1.000 suscripciones de símbolos por conexión WebSocket y hasta 10 conexiones por API key. Las cotizaciones llegan en cuanto cambian los precios.

Compatibilidad de cuenta

Funciona con tu cuenta Pro

Cuentas Pro
Spreads brutos más una comisión. La API trata todas las cuentas Pro de la misma forma: mismos endpoints, mismo JSON, mismo flujo de autenticación.
Cuentas PAMM, MAM y Copy Master
Las cuentas de gestor pueden controlarse de forma programática a través de la API para asignaciones, reequilibrios y ejecución. Contacta con onboarding para el aprovisionamiento de credenciales.
Liquidación multidivisa
Todas las monedas base que XBTFX MT5 admite en cuentas Pro: USD, EUR, USDT, BTC, ETH, XRP, SOL, LTC, ZEC, XAU. Balance, equity, margen y PnL se devuelven en la moneda de la cuenta, sin lógica de conversión por tu parte.
Hedging o netting
Cualquiera que sea el modo de margen configurado en tu cuenta MT5 es el que usa la API. Sin necesidad de reconfigurar.

Recursos para desarrolladores

Ejemplos de código, archivos AI skill y documentación API completa — todo lo que necesitas para empezar a construir.

Documentación API

Referencia completa de endpoints con ejemplos de petición/respuesta, guía de autenticación e integración WebSocket.

Ejemplos de API

Código de ejemplo en Python, JavaScript, curl y más. Copia y ejecuta.

AI Skills Hub

Archivos de skills para flujos de trading, cuenta, datos de mercado y WebSocket en frameworks de agentes compatibles.

MCP Server

Para Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf y otros clientes compatibles con MCP.

Empieza en tres pasos

El mismo esquema, dos puntos de partida — elige el que coincida con el estado de tu cuenta.

  1. Genera una API key

    Inicia sesión en portal.xbtfx.com con tus credenciales XBTFX, selecciona tu cuenta de trading y genera una clave.

    Abrir Console
  2. Instala una skill o MCP

    Instala una skill desde el Skills Hub o conecta el servidor MCP a Claude Code, Cursor, Windsurf u otros clientes compatibles. Las claves quedan en local.

    Documentación MCP
  3. Empieza a operar

    Verifica con GET /v1/auth/status, luego envía órdenes en lenguaje natural o llama directamente a los endpoints REST/WebSocket.

    Leer documentación

Preguntas frecuentes

¿Qué es la XBTFX Trading API?
La XBTFX Trading API ofrece acceso REST y WebSocket para trading programático, monitorización de cuentas, recuperación de datos de mercado y streaming sobre cuentas XBTFX MetaTrader 5® compatibles. Está construida por XBTFX — interactúas con endpoints HTTP limpios y respuestas JSON para enviar operaciones y recuperar datos de tu cuenta.
¿Puedo usar la API con una cuenta Standard?
No. La XBTFX Trading API solo funciona con cuentas Pro en MetaTrader 5. Con una cuenta Standard, usa la API abierta de Mega1: funciona con cuentas Standard en Mega1, con claves que se crean en la terminal de Mega1.
¿Qué lenguajes de programación puedo usar?
Cualquier lenguaje capaz de hacer peticiones HTTP. Python, JavaScript, Go, Rust, C#, Java, Ruby, PHP — si puede enviar una petición POST con un cuerpo JSON, puede enviar operaciones a tu cuenta XBTFX vía la API.
¿Puedo construir estrategias de trading automatizado?
Sí. La XBTFX Trading API está diseñada para trading algorítmico y automatizado. Puedes construir bots basados en señales, reequilibradores de cartera, sistemas de gestión de riesgo o cualquier lógica personalizada que envíe operaciones a tu cuenta.
¿Hay un feed WebSocket de precios en tiempo real?
Sí. La XBTFX Trading API ofrece un endpoint WebSocket para transmitir cotizaciones en tiempo real de los símbolos disponibles en tu cuenta. Las cotizaciones incluyen profundidad de mercado de 5 niveles cuando está disponible. Hasta 1.000 suscripciones de símbolos por conexión y hasta 10 conexiones simultáneas.
¿Cuál es la diferencia entre los modos hedging y netting?
Son los modos de margen que determinan cómo se comportan las posiciones. Hedging permite múltiples posiciones independientes por símbolo, incluidas opuestas de compra y venta. Netting agrega todo en una única posición por símbolo. Tu API key hereda el modo de tu cuenta.
¿Cuáles son los rate limits?
600 weight por minuto y por API key. La mayoría de peticiones cuestan 1 weight — hasta 600 llamadas por minuto. Operaciones masivas como close-all cuestan 10 weight. Cada respuesta incluye cabeceras con el presupuesto restante.
¿Puedo operar CFDs cripto a través de la API?
Sí. Cualquier símbolo disponible en tu cuenta XBTFX es accesible vía API — incluidos los CFDs sobre criptomonedas. También puedes usar la API con cuentas denominadas en BTC, ETH, USDT o XRP.
¿La API es gratuita?
Sí. La XBTFX Trading API se incluye en cada cuenta Pro sin coste adicional. Sin tarifas API, sin suscripciones ni cargos por llamada más allá de tus comisiones y spreads habituales.
¿Cómo obtengo una API key?
Primero, abre una cuenta Pro de XBTFX en portal.xbtfx.com si no tienes una. Después inicia sesión en el API Console en portal.xbtfx.com con tus credenciales XBTFX, selecciona tu cuenta Pro y genera una clave. Verifica que funciona enviando GET /v1/auth/status antes de operar.
¿Qué debo hacer antes de enviar operaciones?
Verifica primero el estado de tu API key y de tu cuenta enviando GET /v1/auth/status. Esto confirma que tu clave es válida, muestra tus permisos y modo de margen, y asegura que tu cuenta está lista antes de enviar peticiones de trading.
¿Necesito experiencia de programación?
Usar la API REST directamente requiere conocimientos básicos de programación. Sin embargo, con las rutas de integración IA no necesitas escribir código — conecta el servidor XBTFX MCP a Claude Code o Cursor, o instala una skill desde el Skills Hub, y da órdenes en lenguaje natural. Se recomienda familiaridad con asistentes IA de código.
¿Puedo usar IA para operar mi cuenta?
Sí. Usa el XBTFX Skills Hub para frameworks de agentes que soporten archivos de skill, o conecta el servidor XBTFX MCP a clientes compatibles con MCP como Claude Code, Claude Desktop, OpenAI Codex, Cursor o Windsurf. Ambas rutas te permiten dar órdenes de trading en lenguaje natural a través de la XBTFX Trading API.
¿Es seguro dar acceso a mi cuenta a un agente IA?
Las API keys suelen guardarse localmente en el agente de tu máquina y no se suben a servidores de terceros. El agente envía las llamadas API directamente a los servidores de XBTFX usando tu clave. Puedes revocar la clave al instante desde el Console en cualquier momento.

Empieza a construir hoy.
La API es gratuita.

Abre tu cuenta XBTFX, genera una API key en el portal y envía tu primera operación.

Soporte en vivo

Chatea con nuestro equipo de soporte, incluso los fines de semana.

Sitio de soporte

Guías y respuestas sobre tu cuenta, la financiación y las plataformas.

Ir al soporte

Blog

Noticias de la empresa, novedades del mercado y análisis de trading.

Leer el blog

Advertencia de riesgo: Operar con productos CFD conlleva un alto nivel de riesgo y puede no ser adecuado para todos los inversores.