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

XBTFX Trading API

Compatible con cuentas MetaTrader 5® de XBTFX

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 Edge y ECN
Acceso programático completo
Modos hedging y netting
Listo para agentes IA (MCP)
Crear cuenta API Console Documentación
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 { "ticket": 184729, "status": "filled", "price": 1.08650, "retcode": 10009 }
Protocolo icon
REST
Protocolo
Streaming icon
WebSocket
Streaming
Weight / min icon
600
Weight / min
Formato de respuesta icon
JSON
Formato de respuesta

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.

POST Enviar 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
POST Cerrar 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
GET Posiciones 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
GET Cuenta y balance
Balance, equity, margen, margen libre, PnL flotante y apalancamiento en tiempo real. Una sola llamada para una vista completa.
/v1/account
GET Sí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
WS Streaming 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.

XBTFX Trading API · examples
# 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"
import requests API_KEY = "xbtfx_live_your_key_here" BASE = "https://interface.xbtfx.com" HEADERS = {"Authorization": f"Bearer {API_KEY}"} # Send a trade to your account r = requests.post(f"{BASE}/v1/trade", json={ "symbol": "EURUSD", "side": "buy", "volume": 0.10 }, headers=HEADERS) print(r.json()) # {"status": "filled", "retcode": 10009}
const ws = new WebSocket("wss://ws.xbtfx.com/v1/ws"); ws.onopen = () => { ws.send(JSON.stringify({ type: "auth", api_key: "xbtfx_live_..." })); ws.send(JSON.stringify({ type: "subscribe", symbols: ["EURUSD", "BTCUSD"] })); }; ws.onmessage = (e) => { const q = JSON.parse(e.data); console.log(q.symbol, q.bid, q.ask); };
main 0 errors Shell UTF-8 LF interface.xbtfx.com
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.
Documentación API MCP Server

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

Ejemplo de conversación →
XBTFX Trading Agent
online · 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 Edge o ECN 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.

FIX 4.4 institucional

Acceso FIX 4.4 a través de la infraestructura xPro para prime brokers, hedge funds y firmas HFT. Contactar con ventas.
Compatibilidad de cuenta

Edge o ECN — la misma cuenta

Cuentas Edge y ECN

Spreads más ajustados con comisión por lote. La API trata cualquier cuenta Edge / ECN de manera idéntica — 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 soportadas por XBTFX MT5 para Edge y ECN: USD, EUR, USDT, BTC, ETH, XRP, SOL, LTC, ZEC, XAU. Balance, equity, margen y PnL se devuelven en la moneda nativa de la cuenta — sin lógica de conversión por tu lado.

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.
docs.xbtfx.com

Ejemplos de API

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

AI Skills Hub

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

MCP Server

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

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 console.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

Frequently
Asked Questions

  • ¿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.

  • ¿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 de trading 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, crea una cuenta de trading XBTFX en my.xbtfx.com si no tienes una. Después inicia sesión en el API Console en console.xbtfx.com con tus credenciales XBTFX, selecciona tu cuenta y genera una clave. Verifica que funciona enviando GET /v1/auth/status antes de operar.

  • ¿Puedo usar la API con una cuenta demo?

    Sí. Las API keys funcionan tanto con cuentas reales como demo. Esto te permite probar tu integración y validar tu código antes de pasar a real — con la misma API y los mismos endpoints.

  • ¿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. Recomendamos empezar con una cuenta demo para probar tu setup antes de pasar a real.

Empieza a construir hoy con

Chat

24/7 Chat Support

Need help with the API? Our team is available around the clock.

Chat Now →
FAQ

API Documentation

Full endpoint reference, authentication guide, and examples.

View Docs →
Blog

GitHub Repos

API examples, AI skills, and sample code ready to use.

View on GitHub →

Esta página es propiedad y está operada por las empresas XBTFX, incluyendo:

XBTFX LLC, constituida en Antigua y Barbuda con número de registro ILLC001 y domicilio social en Hodges Bay, P.O. Box 1348, St. John's, Antigua.

XBTFX (SC) Ltd. constituida en Seychelles con número de registro 8434947-1 y domicilio comercial en Office 1, Block 2, 1st Floor, Sai-fu Building, Zone 20, Providence, Mahe, Seychelles, con Licencia N.º SD169.
El procesamiento de pagos lo realiza CLEARAY LTD, una sociedad de responsabilidad limitada debidamente constituida bajo la Ley de Sociedades, Cap. 113 de la República de Chipre, con número de registro HE 462275 y domicilio social en Archiepiskopou Makariou ΙΙΙ, 160, 1st Floor, 3026, Limassol, Chipre. XBTFX es un proveedor de contratos por diferencia (CFDs) sobre múltiples activos, ofreciendo servicios apalancados. Tenga en cuenta que el valor de sus inversiones está sujeto a la volatilidad del mercado y puede subir o bajar. En consecuencia, su capital invertido está en riesgo. Los criptoactivos, en particular no regulados y altamente volátiles, no cuentan con protección al consumidor. Además, cualquier beneficio derivado de sus inversiones puede estar sujeto a impuestos. XBTFX no presta sus servicios a personas residentes en determinadas jurisdicciones, incluyendo, entre otras, EE. UU., Quebec (Canadá), Bélgica, Bielorrusia, Rusia, Irán, Corea del Norte, Sudán, Yemen, o cualquier otra región donde los servicios prestados por XBTFX infringirían las leyes o regulaciones locales aplicables. Esta lista no es exhaustiva y puede actualizarse según se considere necesario. XBTFX no se dirige activamente a clientes de la UE/EAA. Recomendamos encarecidamente a los posibles clientes que comprendan a fondo la regulación cambiaria aplicable en sus respectivos países antes de utilizar los servicios de XBTFX. Aviso de Inversión de Alto Riesgo: Los Contratos por Diferencia (CFDs) son instrumentos financieros sofisticados que conllevan un riesgo sustancial debido a su naturaleza apalancada. Una pérdida monetaria rápida es una consecuencia probable de operar con estos instrumentos. Es imprescindible que evalúe cuidadosamente su comprensión del funcionamiento de los CFDs y determine la idoneidad de la operativa con CFDs en su situación particular. Se le recomienda encarecidamente no invertir fondos que no pueda permitirse perder. Los productos apalancados pueden no ser adecuados para todas las personas y podrían provocar la pérdida total de su capital. Por favor, lea nuestro ‘Aviso de Divulgación de Riesgos’. Operar con XBTFX siguiendo y/o copiando o replicando las operaciones de otros traders implica un alto nivel de riesgo, incluso al seguir, copiar o replicar a los traders de mejor desempeño. Estos riesgos incluyen el riesgo de seguir/copiar las decisiones de operación de traders posiblemente inexpertos o no profesionales, o de traders cuyo propósito final, intención o situación financiera puedan diferir de los suyos. El rendimiento pasado no es un indicador de rendimiento futuro. El contenido en la plataforma de social trading de XBTFX es generado por miembros de su comunidad y no constituye asesoramiento ni recomendaciones por parte de XBTFX o en su nombre. Aviso de Protección Antifraude: XBTFX solo presta servicios de intermediación a sus clientes. Además, XBTFX opera únicamente a través de la URL xbtfx.com y los clientes deben asegurarse de acceder a nuestros servicios solo a través de esa URL. XBTFX nunca le pedirá su contraseña ni se pondrá en contacto con usted por SMS/teléfono para solicitarla. El contenido aquí incluido se proporciona únicamente con fines informativos y de marketing. No constituye, ni debe interpretarse como, asesoramiento financiero, de inversión u otro asesoramiento profesional o recomendación. Tampoco representa una oferta o solicitud para comprar, vender o realizar cualquier instrumento o transacción financiera. Los clientes deben buscar la opinión de asesores financieros autorizados para asegurarse de que tienen el apetito de riesgo, la experiencia y los conocimientos pertinentes antes de operar. Esta página ha sido traducida para su comodidad. La versión en inglés de todos los términos, acuerdos, documentos legales y condiciones de operación prevalecerá en caso de cualquier inconsistencia.
2026 XBTFX LLC. All Rights Reserved.