Entorno de ejecución nativo de IA para estrategias de trading en bitFlyer
Desarrolla 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 de primer nivel, registros y selección de región.
Sección 01 · De un vistazo
De un vistazo
- Plataforma
- bitFlyer
- Tipo de plataforma
- Exchange de criptomonedas (con licencia en JP, US y EU)
- Clase de activo
- Cripto (spot, JP Crypto CFD)
- Productos compatibles
- Trading spot en pares de BTC, ETH y JPY. Solo para JP: producto Crypto CFD FX_BTC_JPY (anteriormente Lightning FX). La disponibilidad de productos varía según la jurisdicción; las cuentas de US y EU ven un subconjunto de la lista de product_code de JP.
- Modelo de ejecución
- Entorno de ejecución de estrategias en contenedores
- Origen del despliegue
- GitHub
- Lenguajes
- Cualquier lenguaje que se ejecute en un contenedor
- Integraciones habituales
- API nativa de bitFlyer Lightning (REST y WebSocket), CCXT, 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, registros, comprobaciones de estado, selección de región, control MCP
- Rol de bitFlyer
- Cuenta de exchange, acceso a la API, acceso al mercado, plataforma de ejecución
- Afiliación
- TradingHost es independiente y no está afiliado a bitFlyer.
Sección 02 · Qué ofrece bitFlyer
Qué ofrece bitFlyer
bitFlyer ofrece trading spot en BTC, ETH y otros pares en tres jurisdicciones (JP, US, EU), además de un producto Crypto CFD exclusivo para JP (FX_BTC_JPY). Todas las jurisdicciones comparten el mismo endpoint de la Lightning API en api.bitflyer.com, pero ven diferentes mapas de product_code y disponibilidad de productos. Las estrategias se autentican mediante solicitudes con tres encabezados firmados con HMAC-SHA256. Los detalles de los endpoints cambian con el tiempo. La estructura general es duradera; los límites de frecuencia precisos, los niveles de comisiones y las listas de productos se encuentran en la documentación de bitFlyer.
Mercados y patrones de estrategia
- Estrategias spot cotizadas en JPY (BTC_JPY, ETH_JPY)
- Estrategias spot cotizadas en USD (cuentas de US)
- Estrategias spot cotizadas en EUR (cuentas de EU)
- Estrategias de JP Crypto CFD a través de FX_BTC_JPY
- Trading de tasas de financiación (funding rate) en JP Crypto CFD
- Arbitraje de precios entre jurisdicciones con el mismo marco de cuenta
- Suscripciones a datos de mercado en tiempo real mediante WebSocket
- Despliegues multiestrategia aislados mediante subcuentas
Interfaz de la API
- Áreas de producto
- Trading spot en BTC, ETH y otros pares listados. Solo para JP: Crypto CFD (FX_BTC_JPY, anteriormente Lightning FX), liquidado en JPY. La disponibilidad de productos está restringida por jurisdicción; el mismo endpoint de la Lightning API sirve a las tres jurisdicciones, pero el mapa de product_code difiere según la cuenta.
- Métodos de conexión
- REST en https://api.bitflyer.com/v1/ para colocación de órdenes, datos de mercado y consultas de cuenta. WebSocket a través de JSON-RPC 2.0 en el endpoint lightning.bitflyer.com para datos de mercado en tiempo real y canales privados. Los canales públicos de WebSocket no requieren autenticación; los privados sí.
- Autenticación
- Clave API y secreto por estrategia. Las solicitudes REST privadas llevan los encabezados ACCESS-KEY, ACCESS-TIMESTAMP y ACCESS-SIGN. La firma es un HMAC-SHA256 sobre timestamp + método HTTP + ruta + cuerpo, con salida en formato hexadecimal. Los permisos están acotados por clave (lectura, trading, retiros). Las estrategias nunca deberían necesitar permisos de retiro.
Para más detalles, consulte bitFlyer
Los endpoints específicos, los límites de frecuencia, las listas de product_code, los niveles de comisiones y el historial de versiones se encuentran en la documentación de bitFlyer. Considéralos como la fuente de verdad.
Sección 03 · Desarrollar con IA
Desarrolle su estrategia para bitFlyer con IA
Elija un método de integración, haga un fork de una plantilla 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 bitFlyer Lightning
Control directo sobre el comportamiento específico de bitFlyer, los mapas de product_code y la lógica de ejecución de órdenes.
Hummingbot
Despliegues basados en frameworks utilizando la estructura de estrategia y el modelo de configuración de Hummingbot.
Conector personalizado
Tu propio motor de trading interno o integración propietaria con bitFlyer.
Compatibilidad de frameworks con productos de bitFlyer
La cobertura de frameworks para bitFlyer es menor que para las plataformas de primer nivel (Tier-1). CCXT expone el mercado spot de bitFlyer a través de la clase unificada bitflyer; el producto JP Crypto CFD no es una primitiva nativa en CCXT. Hummingbot y Freqtrade no incluyen a bitFlyer entre sus exchanges soportados oficialmente. El acceso nativo a la Lightning API de bitFlyer permite llegar a todo lo que bitFlyer ofrece en cada jurisdicción.
✓ compatibilidad confirmada según la documentación oficial del framework. "no" indica que no está documentado oficialmente como compatible.
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
bitFlyer proporciona el exchange y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a bitFlyer.
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 bitFlyer.
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
Vincula TradingHost a tu repositorio de estrategia existente o haz un fork de un entorno de ejecución de framework de TradingHost (CCXT) para obtener una base funcional.
- PASO 03
Desplegar en un contenedor de TradingHost
Elija una región (EU o US-East), configure las variables de entorno que requiera su estrategia (clave API y secreto de bitFlyer, el product_code específico de la jurisdicción, etc.) y realice el despliegue. TradingHost compila su contenedor desde el repositorio y ejecuta su estrategia en infraestructura gestionada de Kubernetes. No es necesario 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 bitFlyer
Problemas con los que te toparás al ejecutar una estrategia de bitFlyer en un entorno en la nube basado en contenedores, que no aparecen en la documentación de bitFlyer ni en los archivos README de los frameworks. Cada afirmación a continuación está citada o parafraseada de la propia documentación de bitFlyer; la guía del lado del despliegue proviene de la experiencia de ejecutar estas estrategias en TradingHost.
01 · Endpoint compartido
Las jurisdicciones JP, US y EU comparten api.bitflyer.com pero ven diferentes mapas de product_code
Las tres jurisdicciones de bitFlyer (JP, US, EU) utilizan el mismo endpoint de la Lightning API en https://api.bitflyer.com/v1/. El parámetro product_code es el elemento diferenciador: una cuenta de JP ve la lista completa, incluyendo FX_BTC_JPY (Crypto CFD); una cuenta de US ve un subconjunto con licencia para EE. UU.; una cuenta de EU ve un subconjunto con licencia para la UE. Las estrategias que definen de forma estática (hard-code) un product_code exclusivo de JP para una cuenta que no es de JP devolverán errores de producto no disponible al enviar órdenes. Define la lista de product_code como configuración según la jurisdicción de la cuenta, no como una constante en el código.
02 · Cambio de nombre de Crypto CFD
FX_BTC_JPY es el código de producto actual; el antiguo "FX BTC/JPY" de Lightning FX se discontinuó en marzo de 2024
bitFlyer cambió el nombre de su producto de trading de margen Lightning FX a Crypto CFD a partir de marzo de 2024 y estandarizó el código de producto en FX_BTC_JPY. El endpoint heredado de Lightning FX quedó obsoleto; las firmas y las cabeceras mantuvieron la compatibilidad con versiones anteriores durante el período de transición, pero las integraciones que aún apuntan a la ruta de código antigua devuelven errores de producto no disponible hoy en día. Las estrategias anteriores a 2024 deben migrar al product_code FX_BTC_JPY bajo el esquema de Crypto CFD.
03 · Límites de frecuencia de tres niveles
Privado: 500 req / 5 min por IP; colocación de órdenes limitada por minuto por debajo de 0.1 BTC; 300 operaciones de orden/cancelación por cada 5 min
bitFlyer aplica varios límites de frecuencia distintos: 500 solicitudes privadas por cada 5 minutos por IP más clave, 100 colocaciones de órdenes por minuto para órdenes inferiores a 0.1 BTC y 300 operaciones de orden/cancelación por cada 5 minutos. Las estrategias que alcanzan el límite de órdenes pequeñas suelen alcanzar también el límite de la ventana de 5 minutos poco después. Ajuste el ritmo de colocación según el límite más bajo y utilice WebSocket para las actualizaciones de estado en lugar de realizar consultas REST de forma agresiva. La documentación de bitFlyer indica que los límites "may be changed depending on system load" sin garantía de aviso previo.
04 · Autenticación de tres cabeceras
Se requieren ACCESS-KEY, ACCESS-TIMESTAMP y ACCESS-SIGN
Las solicitudes REST privadas de bitFlyer contienen tres cabeceras: ACCESS-KEY (su clave API), ACCESS-TIMESTAMP (marca de tiempo Unix) y ACCESS-SIGN (HMAC-SHA256 de la marca de tiempo + método HTTP + ruta + cuerpo, firmado con su secreto, salida hexadecimal). Las estrategias que omiten cualquiera de las tres devuelven respuestas de error de firma. El cuerpo canónico debe coincidir exactamente con lo que se envía, incluidos los espacios en blanco; serialice el JSON con un orden de claves estable antes de firmar.
05 · Protocolo WebSocket
JSON-RPC 2.0 sobre lightning.bitflyer.com; los canales privados requieren autenticación por mensaje, no a nivel de conexión
El WebSocket de bitFlyer Lightning es JSON-RPC 2.0 sobre el endpoint lightning.bitflyer.com. Los canales públicos (ejecuciones, libro de órdenes, ticker) no requieren autenticación. Los canales privados (órdenes secundarias, órdenes principales, ejecuciones en su cuenta) requieren un mensaje de autenticación después de conectarse que contenga ACCESS-KEY, ACCESS-TIMESTAMP y ACCESS-SIGN como parte de los parámetros de JSON-RPC. Las estrategias que se autentican solo en el protocolo de enlace HTTPS y no en el cuerpo de JSON-RPC verán cómo las suscripciones privadas se caen silenciosamente.
06 · Alcance de claves
Una clave con alcance limitado por estrategia, nunca una clave maestra compartida entre estrategias
Las claves API de bitFlyer tienen un alcance por permiso (lectura, trading, retiros). Las estrategias nunca deberían necesitar permisos de retiro; aísle las claves con capacidad de retiro en una credencial separada y gestionada manualmente fuera del entorno de ejecución del contenedor. Las claves por estrategia con solo los alcances que esa estrategia necesita limitan el radio de impacto si una clave se filtra. La lista blanca de IP está disponible; fíjela donde el rango de salida del entorno de ejecución sea estable para su región.
Sección 06 · Diseñado para
Diseñado para
Los runtimes de TradingHost para bitFlyer son ideales para:
- Desarrolladores que crean estrategias en IDE de IA (Cursor, Claude Code)
- Traders sistemáticos de criptomonedas
- Desarrolladores cuantitativos (quants)
- Titulares de cuentas de bitFlyer en JP, US y EU
- Usuarios de CCXT
- Equipos que migran de hosting VPS a despliegues en contenedores
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 bitFlyer.
No. El código de su estrategia se conecta a bitFlyer y envía instrucciones de acuerdo con su propia lógica, permisos de cuenta y método de integración. TradingHost proporciona el entorno de ejecución donde se ejecuta ese código.
No. El acceso a la API de bitFlyer lo proporciona bitFlyer. Usted es responsable de su cuenta de bitFlyer, permisos de API, credenciales y del cumplimiento de los términos de bitFlyer.
No. TradingHost es el entorno de ejecución en la nube donde se ejecuta el código de su estrategia. No proporcionamos señales, modelos de predicción de IA ni bots preconstruidos. Con TradingHost, usted escribe o genera la estrategia por sí mismo (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 ejecuta su estrategia.
AWS y DigitalOcean le ofrecen computación 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 supervisión del tiempo de actividad. TradingHost le ofrece un entorno de ejecución gestionado y diseñado específicamente para estrategias de trading: despliegue nativo de GitHub, control basado en MCP desde IDE de IA, y paneles de registros y estado listos para usar. Si prefiere operar la infraestructura usted mismo, AWS es una opción. Si desea el entorno de ejecución como un servicio gestionado, TradingHost es el camino más rápido.
Sí. TradingHost ejecuta estrategias en Python; elija el entorno de ejecución de framework que coincida con su pila tecnológica o despliegue su propio repositorio.
Sí. TradingHost es compatible con cualquier lenguaje que pueda ejecutarse dentro de un contenedor.
Sí. CCXT expone bitFlyer a través de la clase unificada `bitflyer`, cubriendo el mercado spot en las jurisdicciones de JP, US y EU. El producto JP Crypto CFD (FX_BTC_JPY) no es una primitiva nativa de CCXT; para el producto de margen, apunte a la API nativa de bitFlyer Lightning. Consulte el entorno de ejecución del framework CCXT para conocer todos los detalles de la configuración.
No. El producto JP Crypto CFD (FX_BTC_JPY, anteriormente Lightning FX) tiene licencia de bitFlyer Japón y solo está disponible para usuarios con licencia de JP. Las cuentas de bitFlyer de US y EU ven un mapa de product_code diferente y no pueden operar FX_BTC_JPY a través de la API, independientemente de la lógica de la estrategia. Las estrategias que necesiten este producto deben ejecutarse en una cuenta de bitFlyer con licencia de JP, y la salida del entorno de ejecución debe ser coherente con la jurisdicción de esa cuenta.
Sí, si su proyecto está diseñado de esa manera. Puede ejecutar múltiples procesos o servicios de estrategia dentro de un solo entorno de ejecución, o separarlos en diferentes entornos de ejecución para mayor aislamiento y claridad operativa. Consulte la página del entorno de ejecución de TradingHost para conocer el modelo multiestrategia.
El camino más rápido es hacer un fork de un entorno de ejecución de framework de TradingHost: CCXT para un proyecto spot listo para desplegar. O conecte su propio repositorio de estrategia de GitHub si apunta a la API nativa de Lightning para JP Crypto CFD. Vincular un repositorio de GitHub y crear una estrategia es gratis; los planes de entorno de ejecución se detallan en la página de precios.
En su flujo de trabajo de secretos controlado por GitHub. TradingHost los 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 los secretos de la plataforma para conocer el modelo de gestión completo.
No. Las estrategias nunca deberían necesitar permisos de retiro. Utilice permisos con alcance limitado (lectura, trading) y listas blancas de IP cuando corresponda.
Sí. TradingHost admite el control basado en MCP para IDE 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 del entorno de ejecución. MCP es una interfaz de control y observabilidad, no la ruta de ejecución de operaciones. Consulte la interfaz de control de MCP para obtener una visión completa.
Ambos. La interfaz de control de MCP funciona igual de bien desde agentes basados en CLI (Claude Code CLI, clientes MCP personalizados, llamadas MCP mediante scripts) que desde el interior de un IDE. El ciclo de despliegue nativo de GitHub también funciona sin ninguna herramienta de IA: un simple git push a su rama principal activa un nuevo despliegue.
El runtime detecta el fallo y expone los logs y la información de estado pertinentes. Siempre que sea posible, la estrategia afectada se puede reiniciar sin interrumpir las demás estrategias que se ejecutan 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 la interfaz de logs y estado.
El mapa de product_code de bitFlyer está restringido por jurisdicción. El mismo endpoint de la Lightning API atiende a usuarios de JP, US y EU, pero cada jurisdicción ve un subconjunto diferente de productos disponibles. Una cuenta de US o EU que intente acceder a FX_BTC_JPY (el producto Crypto CFD exclusivo de JP) recibirá errores de product-not-available, independientemente de los permisos de la clave API. Las estrategias que antes de 2024 apuntaban a "Lightning FX" también deben migrar a FX_BTC_JPY debido al cambio de nombre en marzo de 2024. Defina la lista de product_code en la configuración según la jurisdicción de la cuenta. Consulte la sección de Notas operativas anterior para obtener la guía completa.
TradingHost se ejecuta en las regiones 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 detalles sobre enrutamiento y proximidad.
No. TradingHost se centra en el runtime en producción y el despliegue. El backtesting corresponde a su entorno de investigación, framework o AlgoBuilder.