Runtime nativo para IA para estrategias de trading en Bitfinex
Programa en Cursor, Claude Code o cualquier IDE de IA. Despliega desde GitHub en un runtime en la nube gestionado con control MCP de primer nivel, logs y selección de región.
Sección 01 · De un vistazo
De un vistazo
- Plataforma
- Bitfinex
- Tipo de plataforma
- Exchange de criptomonedas (spot, margen, derivados)
- Clase de activo
- Cripto
- Productos compatibles
- Spot, margen (financiado mediante un funding pool peer-to-peer), derivados (contratos perpetuos) en derivatives.bitfinex.com. Los tokens de valores a través de Bitfinex Securities operan como una plataforma independiente.
- Modelo de ejecución
- Runtime de estrategias en contenedores (Kubernetes)
- Origen del despliegue
- GitHub
- Lenguajes
- Cualquier lenguaje que funcione en un contenedor
- Integraciones habituales
- REST v2 nativo de Bitfinex, WebSocket v2, Honeycomb FIX 4.4, CCXT (bitfinex, bitfinex2), Freqtrade (vía CCXT), personalizado
- Integración con flujos de trabajo de IA
- Interfaz de control MCP para Cursor, Claude Code, GitHub Copilot y agentes de CLI
- Rol de TradingHost
- Runtime, despliegue, logs, comprobaciones de estado, selección de región, secretos, control MCP
- Rol de Bitfinex
- Cuenta de exchange, emisión de claves API, acceso al mercado, emparejamiento de órdenes, custodia, liquidación
- Afiliación
- TradingHost es independiente y no está afiliado a Bitfinex ni a iFinex Financial Technologies Limited. Bitfinex no ofrece servicios a clientes con domicilio en EE. UU.
Sección 02 · Qué ofrece Bitfinex
Qué ofrece Bitfinex
Bitfinex ofrece trading de spot, margen y derivados a través de REST v2 y WebSocket v2, además de Honeycomb FIX 4.4 para clientes institucionales. El margen se financia mediante un funding pool peer-to-peer en lugar del propio exchange, lo que convierte al lado del préstamo en una superficie de estrategia por derecho propio. Los contratos perpetuos se negocian en derivatives.bitfinex.com bajo la convención de F0 symbols (por ejemplo, tBTCF0:USTF0) y requieren USDt0 en una cartera de derivados dedicada. Las particularidades de los endpoints cambian con el tiempo; la estructura general es estable, pero los límites de velocidad precisos, los niveles de comisiones y las listas de símbolos se encuentran en la documentación de Bitfinex.
Mercados y patrones de estrategia
- Market making de spot en tBTCUSD y tETHUSD
- Trading de margen financiado a través del funding pool peer-to-peer
- Trading de contratos perpetuos en derivatives.bitfinex.com (F0 symbols)
- Estrategias de tasas de financiación en el lado del préstamo (ofertas de fUSD, fBTC)
- HFT institucional con Honeycomb FIX 4.4
- Aislamiento de estrategias delimitado por sub-accounts
- Colocación de órdenes ocultas y post-only (order flags)
- Lógica de órdenes bracket One-Cancels-Other (OCO)
Interfaz de la API
- Áreas de producto
- Spot, margen (funding pool), derivados (perpetuos mediante F0 symbols, requiere USTF0 en la cartera de derivados), valores (independiente). Paper trading a través de tTESTBTCF0:TESTUSDTF0.
- Métodos de conexión
- REST v2 (público en api-pub.bitfinex.com, autenticado en api.bitfinex.com), WebSocket v2 (wss://api-pub.bitfinex.com/ws/2 y wss://api.bitfinex.com/ws/2), Honeycomb FIX 4.4 para institucionales. Las versiones v1 de REST y WS siguen disponibles, pero se recomienda la v2.
- Autenticación
- Clave API más secreto con un nonce estrictamente creciente y firma HMAC-SHA384. El nonce ceiling es 9007199254740991. Cada cliente concurrente necesita su propia clave para evitar colisiones de nonce. Los permisos se delimitan por clave (información de cuenta, órdenes, margen, financiación, retiros).
Para más detalles, consulte Bitfinex
Los endpoints específicos, los límites de velocidad, las listas de símbolos, los niveles de comisiones y el historial de versiones se encuentran en la documentación de Bitfinex. Considéralos como la fuente de verdad.
- docs.bitfinex.com/docs/introductionIntroducción a la API de Bitfinex
- docs.bitfinex.com/docs/rest-generalGeneralidades de la API REST v2
- docs.bitfinex.com/docs/api-accessAcceso a la API y permisos de claves
- docs.bitfinex.com/docs/requirements-and-limitationsRequisitos y limitaciones (nonce, límites de velocidad)
Sección 03 · Desarrollar con IA
Desarrolle su estrategia para Bitfinex con IA
Elige un método de integración, haz un fork de una plantilla de framework de TradingHost y programa tu 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. El distintivo modelo de margen de Bitfinex (un funding pool peer-to-peer en lugar de un margen financiado por el exchange), junto con la convención de F0 symbols en la plataforma de derivados independiente, definen cómo se adapta cada framework a la plataforma.
API nativa de Bitfinex
Control directo sobre el comportamiento específico de Bitfinex, los datos de la cuenta y la lógica de ejecución de órdenes a través de REST v2 y WebSocket v2.
CCXT
Interfaz común para Bitfinex y otros exchanges de criptomonedas. CCXT expone Bitfinex bajo dos identificadores: `bitfinex` (v1) y `bitfinex2` (v2). El código nuevo debería apuntar a `bitfinex2`.
Freqtrade o Hummingbot
Despliegues basados en frameworks utilizando su estructura de estrategia y modelo de configuración. Freqtrade accede a Bitfinex a través de CCXT; Hummingbot históricamente incluye un conector de spot para Bitfinex.
Conector personalizado
Tu propio motor de trading interno o integración propietaria con Bitfinex, incluyendo Honeycomb FIX 4.4 para clientes institucionales.
Compatibilidad de frameworks con productos de Bitfinex
La cobertura varía según el framework. La combinación nativa de REST v2 y WebSocket v2 cubre toda la superficie de Bitfinex, incluyendo los perpetuos F0 en la plataforma de derivados y el funding pool. CCXT expone Bitfinex a través de dos identificadores (`bitfinex` para v1, `bitfinex2` para v2); se recomienda `bitfinex2` para nuevas estrategias. Freqtrade accede a Bitfinex a través de CCXT para spot, mientras que el margen y los futuros no cuentan con soporte oficial. Hummingbot incluye un conector exclusivo para spot de Bitfinex.
✓ soporte confirmado según la documentación oficial del framework. "parcial" o "limitado" indica que el framework accede a la superficie pero no cubre la totalidad del producto de Bitfinex. "no" indica que no está documentado oficialmente como compatible. Los enlaces de flujos de trabajo apuntan a páginas de /workflows/ actualmente en desarrollo.
TradingHost no impone ningún framework. Simplemente ejecuta su proyecto.
Desarrollo con IA
Las plantillas de inicio anteriores se integran de forma natural con los 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 usted, sin intervenir nunca en la ruta de ejecución de las operaciones.
Sección 04 · Ejecutar en TradingHost
Ejecuta tu código en TradingHost
Bitfinex proporciona el exchange y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a Bitfinex.
En lugar de ejecutar el código de tu estrategia en un portátil, un ordenador de escritorio, 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 Bitfinex.
TradingHost
- Mantiene el entorno de ejecución en línea.
- Muestra los logs y las comprobaciones de estado.
- Selección de región.
- Superficie 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
Apunta TradingHost hacia el repositorio de tu estrategia existente, o haz un fork de un entorno de ejecución de framework de TradingHost (CCXT, Freqtrade o Hummingbot) para obtener una base funcional.
- PASO 03
Desplegar en un contenedor de TradingHost
Elija una región (EU o US-East), introduzca las variables de entorno que requiere su estrategia (clave API de Bitfinex, secreto, etc.) y despliegue. TradingHost compila su contenedor a partir del repositorio y ejecuta su estrategia en una infraestructura gestionada de Kubernetes. Dado que Bitfinex exige una monotonicidad estricta del nonce por clave, ejecute una sola clave API por proceso de trabajo; si utiliza varias estrategias simultáneas, genere una clave para cada una bajo una subcuenta para evitar colisiones en el espacio de nonce compartido. No requiere instalar Docker localmente.
- PASO 04
Monitorear logs y estado de salud
Siga en tiempo real los logs, el estado de salud y el estado del runtime desde el panel de control de TradingHost. Se puede acceder a la misma interfaz mediante MCP desde cualquier AI IDE, de modo que Cursor, Claude Code o un agente de CLI pueden leer el estado del despliegue y gestionar el runtime junto con usted.
- PASO 05
Actualizar y redesplegar
Suba los cambios a su rama principal de GitHub y TradingHost realizará el redespliegue automáticamente.
Sección 05 · Notas operativas
Notas operativas para Bitfinex
Detalles que pueden complicarte la vida al ejecutar una estrategia de Bitfinex en un runtime en la nube basado en contenedores, y que no encontrarás en la documentación de Bitfinex ni en los archivos README de los frameworks. Cada afirmación a continuación es una cita o paráfrasis de la propia documentación de Bitfinex; la guía de despliegue proviene de la experiencia de ejecutar estas estrategias en TradingHost.
01 · Monotonicidad de nonce
Estrictamente creciente por clave, con un límite máximo estricto
Cada solicitud autenticada requiere un nonce estrictamente creciente por clave API; además, el valor tiene un nonce ceiling de 9007199254740991. Los procesos concurrentes que compartan una clave sufrirán colisiones. Solución: una clave API por estrategia o contenedor en ejecución, delimitada mediante sub-accounts.
02 · v1 vs v2
v2 es la vía recomendada de cara al futuro
REST v1 todavía se autentica con las cabeceras X-BFX-APIKEY, X-BFX-PAYLOAD y X-BFX-SIGNATURE y un payload JSON en Base64. v2 es la vía recomendada, con endpoints más rápidos y respuestas unificadas; el código nuevo debería apuntar a v2.
03 · sub-accounts
Una cuenta maestra, múltiples sub-accounts, espacio de nonce separado
Bitfinex admite múltiples sub-accounts bajo una cuenta maestra. Cada sub-account tiene sus propias claves API, monederos y espacio de nonce, lo cual es la forma recomendada de aislar estrategias y evitar conflictos de nonce.
FuenteBitfinex API access04 · funding pool
El margen es peer-to-peer, no financiado por el exchange
El margen en Bitfinex se financia mediante prestamistas peer-to-peer que publican ofertas en fUSD, fBTC, etc. Tanto las estrategias de préstamo como las de endeudamiento operan contra el mismo libro de financiación; el flag No Var Rates (524288) excluye las ofertas de tipo variable del emparejamiento.
FuenteBitfinex flag values05 · División de derivados
Los perpetuos se negocian como F0 symbols en una plataforma independiente
Los perpetuos se negocian como F0 symbols (por ejemplo, tBTCF0:USTF0, tETHF0:USTF0) operados por iFinex Financial Technologies Limited. Requieren USDt0 en un monedero de derivados dedicado; use el endpoint Transfer Between Wallets para transferir fondos. El apalancamiento predeterminado es de 10, configurable de 1 a 100 en la orden.
FuenteBitfinex derivatives06 · Honeycomb FIX
FIX 4.4 es un acceso institucional restringido
FIX es la interfaz institucional; el acceso no es de autoservicio desde la página estándar de la API. Planifique un proceso de incorporación y obtención de credenciales adicional antes de depender de FIX en un despliegue de TradingHost.
07 · Límites de peticiones
Límites de REST por IP y límites de conexión de WebSocket
Los límites de REST rondan entre 10 y 90 peticiones por minuto por IP según el endpoint, con un tiempo de espera de 60 segundos en caso de infracción. Límites de WebSocket: 5 conexiones autenticadas cada 15 segundos, 20 conexiones públicas por minuto, 25 suscripciones a canales por conexión. Las estrategias que se distribuyen en muchos mercados deberían agrupar canales en lugar de abrir múltiples sockets.
Sección 06 · Diseñado para
Diseñado para
Los runtimes de TradingHost para Bitfinex son ideales para:
- Creadores de mercado de spot que buscan una plataforma profunda y consolidada para USD/USDT
- Traders de margen que buscan específicamente el modelo de funding pool peer-to-peer
- Prestamistas del lado de la financiación que ejecutan estrategias de tipos de interés en ofertas de fUSD, fBTC y fETH
- Traders de perpetuos que utilizan tBTCF0:USTF0 y otros pares F0
- Mesas institucionales que necesitan conectividad FIX 4.4 junto con HTTP y WebSocket
Conectar GitHub y crear su primera estrategia es gratis.
Sección 08 · Preguntas frecuentes
Preguntas frecuentes
No. TradingHost es independiente y no está afiliado a Bitfinex ni a iFinex Financial Technologies Limited, el operador de la plataforma de derivados de Bitfinex.
No. El código de su estrategia se conecta a Bitfinex y envía instrucciones según su propia lógica, permisos de cuenta y método de integración. TradingHost proporciona el runtime donde se ejecuta dicho código.
No. El acceso a la API de Bitfinex lo proporciona Bitfinex. Usted es responsable de su cuenta de Bitfinex, los permisos de la API, las credenciales y el cumplimiento de los términos de Bitfinex.
No. TradingHost es el runtime en la nube donde se ejecuta el código de su estrategia. No proporcionamos señales, modelos de predicción de IA ni bots preconfigurados. Con TradingHost, usted escribe o genera la estrategia por su cuenta (a menudo con Cursor o Claude Code), la mantiene en GitHub como su propio código y utiliza TradingHost para ejecutarla en producción. Productos como 3Commas, Cryptohopper y similares son propietarios de la lógica de la estrategia; TradingHost simplemente ejecuta su estrategia.
AWS y DigitalOcean le ofrecen capacidad de cómputo pura. Usted mismo debe encargarse de las actualizaciones del sistema operativo, la orquestación de contenedores, el envío de registros, la rotación de secretos, la conmutación por error de región y la monitorización del tiempo de actividad. TradingHost le ofrece un runtime gestionado diseñado específicamente para estrategias de trading: despliegue nativo de GitHub, control mediante MCP desde entornos de desarrollo de IA, y paneles de registros y estado listos para usar. Si prefiere gestionar la infraestructura usted mismo, AWS es una opción. Si prefiere el runtime como un servicio gestionado, TradingHost es el camino más directo.
Sí. TradingHost ejecuta estrategias en Python; elija el framework runtime que coincida con su pila tecnológica o despliegue su propio repositorio.
Sí. TradingHost admite cualquier lenguaje que pueda ejecutarse dentro de un contenedor.
Sí. CCXT expone Bitfinex bajo dos identificadores: bitfinex apunta a la API v1 y bitfinex2 apunta a v2. Utilice bitfinex2 para nuevas estrategias; v2 es la vía recomendada. Tenga en cuenta que algunos pares listados en Bitfinex utilizan USD cuando el activo subyacente es en realidad USDT, algo que CCXT normaliza durante la conversión. Consulte el framework runtime de CCXT para conocer todos los detalles de configuración.
El margen se financia mediante un libro peer-to-peer, no por el exchange. Los prestamistas publican ofertas de financiación en fUSD, fBTC, etc.; los prestatarios las consumen al abrir posiciones de margen. El lado del préstamo es en sí mismo un área para aplicar estrategias, lo cual es inusual entre las principales plataformas.
Los perpetuos se negocian en derivatives.bitfinex.com bajo F0 symbols (por ejemplo, tBTCF0:USTF0). Requieren USDt0 en un monedero de derivados dedicado, operado por iFinex Financial Technologies Limited. Transfiera fondos a través del endpoint Transfer Between Wallets. El apalancamiento es configurable por orden, por defecto es 10 y llega hasta 100.
No. Bitfinex no presta servicios a clientes domiciliados en EE. UU. Si se encuentra en EE. UU., utilice Coinbase o Kraken en su lugar. TradingHost ejecuta su runtime independientemente de la región, pero la propia plataforma debe aceptar su cuenta.
Sí, si su proyecto está diseñado de esa manera. Puede ejecutar múltiples procesos o servicios de estrategia dentro de un solo runtime, o separarlos en diferentes runtimes para mayor aislamiento y claridad operativa. Cada estrategia en ejecución debe tener su propia clave API (idealmente bajo una sub-account) para evitar colisiones con la estricta monotonicidad del nonce por clave. Consulte la página de runtime de TradingHost para conocer el modelo multiestrategia.
El camino más rápido es hacer un fork de un framework runtime de TradingHost: CCXT o Freqtrade para un proyecto listo para desplegar. O bien, conecte su propio repositorio de estrategias de GitHub. Vincular un repositorio de GitHub y crear una estrategia es gratis; los planes de runtime se detallan en la página de precios.
En su flujo de trabajo de secretos controlado por GitHub. TradingHost las lee en tiempo de ejecución a través de secretos del repositorio de GitHub, secretos de entorno o su propio proceso aprobado de gestión de secretos. TradingHost no necesita la custodia de su clave API ni de su secreto. Consulte la sección de secretos de la plataforma para conocer el modelo completo de gestión.
No. Las estrategias nunca deberían necesitar permisos de retiro. Utilice permisos acotados (información de cuenta, órdenes, margen, financiación) y habilite únicamente las áreas que su estrategia realmente utilice.
Sí. TradingHost admite el control basado en MCP para entornos de desarrollo (IDEs) de IA, incluidos Cursor, Claude Code, GitHub Copilot y agentes de IA basados en CLI. Las herramientas de IA pueden inspeccionar despliegues, revisar registros, reiniciar estrategias y gestionar flujos de trabajo en tiempo de ejecución. MCP es un entorno de control y observabilidad, no la ruta de ejecución de operaciones. Consulte la sección sobre el entorno de control de MCP para obtener más detalles.
Ambos. El entorno de control de MCP funciona igual de bien desde agentes basados en CLI (Claude Code CLI, clientes MCP personalizados, llamadas MCP programadas) que desde el propio IDE. El ciclo de despliegue nativo de GitHub también funciona sin herramientas de IA: un simple git push a su rama principal activa un nuevo despliegue.
El entorno de ejecución detecta el fallo y muestra los registros y la información de estado pertinentes. Siempre que sea compatible, la estrategia afectada se puede reiniciar sin interrumpir otras estrategias que se ejecuten en el mismo contenedor. El código de su estrategia sigue siendo responsable de la gestión segura de errores, la protección contra órdenes duplicadas y los controles de riesgo. Consulte la sección de observabilidad para conocer el entorno de registros y estado.
Bitfinex requiere un nonce estrictamente creciente por clave API, con un límite máximo de 9007199254740991. Si dos procesos comparten la misma clave, entrarán en conflicto y uno de ellos será rechazado. Para solucionarlo, asigne a cada estrategia en ejecución su propia clave API, idealmente en su propia sub-account. Consulte la sección de Notas operativas anterior para obtener la guía completa.
TradingHost está disponible en las regiones de EU y US-East. Elija la región más cercana al motor de emparejamiento del que dependa su estrategia. Consulte la página de regiones para obtener más información sobre enrutamiento y proximidad.
No. TradingHost se centra en el entorno de ejecución y el despliegue en producción. El backtesting corresponde a su entorno de investigación, framework o AlgoBuilder.