Runtime nativo de IA para estrategias de trading en Phemex
Desarrolla en Cursor, Claude Code o cualquier entorno de desarrollo de IA. Despliega desde GitHub en un runtime gestionado en la nube con control MCP de primer nivel, logs y selección de región.
Sección 01 · De un vistazo
De un vistazo
- Plataforma
- Phemex
- Tipo de plataforma
- Exchange de criptomonedas
- Clase de activo
- Cripto
- Productos compatibles
- Spot, contratos perpetuos inversos y de USDT, futuros con fecha de vencimiento, sub-accounts, además de una testnet pública
- Modelo de ejecución
- Runtime de estrategias en contenedores
- Origen del despliegue
- GitHub
- Lenguajes
- Cualquier lenguaje que se ejecute en un contenedor
- Integraciones habituales
- REST y WebSocket nativos de Phemex, CCXT, Freqtrade, Hummingbot, 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
- Runtime, despliegue, logs, comprobaciones de estado, selección de región, control MCP
- Rol de Phemex
- Cuenta de exchange, acceso a la API, acceso al mercado, entorno de ejecución
- Afiliación
- TradingHost es independiente y no está afiliado a Phemex
Sección 02 · Qué ofrece Phemex
Qué ofrece Phemex
Phemex ofrece spot, perpetuos con margen en USDT, perpetuos inversos y futuros con fecha de vencimiento a través de APIs REST y WebSocket. La autenticación es HMAC-SHA256 con una marca de tiempo de expiración de solicitud explícita, y el limitador de frecuencia se divide en tres grupos independientes (contract, spotOrder, others) para que un bucle de contratos saturado no ralentice las órdenes spot. Una testnet independiente en testnet-api.phemex.com te permite validar el comportamiento con la misma estructura de API sin arriesgar capital real. Phemex US opera como una entidad distinta; la API global no la cubre. Los detalles de los endpoints cambian con el tiempo. La estructura general es estable; los límites de frecuencia exactos, los niveles de comisiones y las listas de símbolos se encuentran en la documentación oficial de Phemex.
Mercados y patrones de estrategia
- Estrategias de contratos perpetuos con margen en USDT
- Contratos perpetuos inversos (con margen en cripto)
- Estrategias de spot en pares de USDT y BTC
- Despliegues multiestrategia aislados mediante sub-accounts
- Despliegues validados en testnet antes del lanzamiento en mainnet
- Arbitraje de tasas de financiación (funding rate) en perpetuos
- Consumo de flujos de operaciones y libro de órdenes por WebSocket
- Ejecución cruzada entre grupos de límites de frecuencia (contract + spot)
Interfaz de la API
- Áreas de producto
- Spot, perpetuos con margen en USDT, perpetuos inversos (con margen en cripto), futuros con fecha de vencimiento y jerarquías de sub-accounts. Una testnet pública en testnet-api.phemex.com funciona con un pool independiente que tiene su propio límite de solicitudes y no permite operar con activos reales. Phemex US opera como una entidad distinta en una infraestructura separada; las cuentas globales de Phemex no son intercambiables con las de Phemex US.
- Métodos de conexión
- REST para colocación de órdenes y consultas de cuenta. WebSocket para datos de mercado en tiempo real, actualizaciones del libro de órdenes, transacciones y eventos de cuenta. Las suscripciones privadas de WebSocket requieren autenticación en la conexión.
- Autenticación
- Clave de API, secreto y una marca de tiempo de expiración de solicitud firmada con HMAC-SHA256. Tres grupos de límites de frecuencia (contract, spotOrder, others), cada uno con su propio presupuesto de solicitudes; superar uno no limita a los demás. Las sub-accounts pueden tener claves con permisos limitados bajo la cuenta principal.
Para más detalles, consulte Phemex
Los endpoints específicos, los pesos de los límites de frecuencia, las listas de símbolos, los niveles de comisiones y el historial de versiones se encuentran en la documentación de Phemex. Considéralos la fuente de verdad oficial.
Sección 03 · Desarrollar con IA
Desarrolle su estrategia para Phemex 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 Phemex
Control directo sobre el comportamiento específico de Phemex, los datos de la cuenta y la lógica de ejecución de órdenes en spot, perpetuos de USDT y perpetuos inversos.
CCXT
Interfaz común para Phemex y otros exchanges de criptomonedas. CCXT expone los mercados spot y de swaps perpetuos de Phemex a través de la clase unificada `phemex`.
Freqtrade o Hummingbot
Despliegues basados en frameworks que utilizan su estructura de estrategia y modelo de configuración. Ambos incluyen a Phemex entre sus exchanges compatibles.
Conector personalizado
Tu propio motor de trading interno o integración propietaria con Phemex, firmando solicitudes con HMAC-SHA256 según el esquema de expiración publicado.
Compatibilidad de frameworks con productos de Phemex
La cobertura varía según el framework. CCXT abarca la mayor parte de la API de Phemex para spot y swaps perpetuos; Freqtrade y Hummingbot cubren spot, y el soporte para perpetuos depende de la versión del conector; el acceso nativo a la API de Phemex cubre todo lo que ofrece el exchange, incluidos los contratos inversos y las jerarquías de sub-accounts.
✓ soporte confirmado según la documentación oficial del framework. "no" indica que no está documentado oficialmente como compatible. "parcial" indica cobertura limitada (ver detalles arriba).
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
Phemex proporciona el exchange y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a Phemex.
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 Phemex.
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
Elige una región (EU o US-East), proporciona las variables de entorno que necesita tu estrategia (la clave API de Phemex, el secreto y el esquema de marca de tiempo de expiración que use tu código) y despliega. TradingHost compila tu contenedor desde el repositorio y ejecuta tu estrategia en una infraestructura gestionada de Kubernetes. No se 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 Phemex
Problemas reales que surgen al ejecutar una estrategia de Phemex en un runtime en la nube basado en contenedores, que no encontrarás en la documentación de Phemex ni en los archivos README de los frameworks. Cada punto a continuación está citado o adaptado de la documentación oficial de Phemex; las pautas de despliegue provienen de la experiencia real ejecutando estas estrategias en TradingHost.
01 · División de límites de frecuencia
Tres grupos de solicitudes independientes: contract, spotOrder, others
El limitador de frecuencia de la API de Phemex se divide en tres grupos independientes en lugar de un único pool global. El grupo `contract` cubre los endpoints de trading de contratos, `spotOrder` cubre la colocación de órdenes spot y `others` abarca todo lo demás. Cada grupo tiene su propio presupuesto de solicitudes; superar uno no limita a los demás. Diseña tu estrategia considerando el presupuesto de cada grupo de forma individual si operas tanto en spot como en perpetuos, en lugar de calcular un límite total combinado.
02 · Expiración de solicitudes
Cada solicitud firmada requiere una marca de tiempo de expiración explícita
El esquema de firma de Phemex requiere una marca de tiempo de expiración explícita en cada solicitud autenticada (en segundos Unix, normalmente `now + 60`). Las solicitudes con una expiración pasada o configurada demasiado en el futuro se rechazan. Un fallo silencioso común: el código del cliente calcula la expiración una sola vez al iniciarse y la reutiliza en las siguientes llamadas, lo que provoca que tras un minuto todas las solicitudes devuelvan un error 401. Calcula la expiración en el momento de la firma, no al inicializar el cliente, y mantén los relojes de los contenedores sincronizados mediante NTP.
03 · Pool de testnet
Testnet se ejecuta en un host independiente con sus propias claves y presupuesto de peticiones
La testnet de Phemex en `testnet-api.phemex.com` emite claves API independientes, mantiene saldos separados y responde a endpoints distintos. Un error de autenticación silencioso muy común es configurar una estrategia de producción con claves de testnet (o subir a producción código validado en testnet sin cambiar el conjunto de claves). Guarda las credenciales de testnet y producción en entradas de Secrets de TradingHost independientes; nunca reutilices una credencial entre entornos. El presupuesto de peticiones de la testnet es considerablemente inferior al de la mainnet; no calcules la capacidad de procesamiento de tu estrategia basándote en las observaciones de testnet.
FuentePhemex testnet docs04 · Separación de EE. UU.
Phemex US es una entidad independiente con su propia infraestructura
Phemex US (`phemex.com/us`) opera como una entidad corporativa distinta de la plataforma global de Phemex y funciona sobre una infraestructura independiente. Una cuenta global de Phemex no da acceso a Phemex US, y una cuenta de Phemex US no puede firmar solicitudes contra los endpoints de la versión global de Phemex. Si tu estrategia se mueve entre jurisdicciones de EE. UU. y fuera de EE. UU., define la selección de la plataforma como un valor de configuración de primer nivel, no como un cambio basado en el tipo de clave. El cumplimiento de las restricciones por jurisdicción se gestiona al crear la cuenta y puede dar lugar al rechazo de solicitudes de API basadas en la dirección IP.
05 · Medidas post-incidente
Vuelve a generar tus claves si las tenías activas durante el incidente de enero de 2025
Phemex informó de un incidente de seguridad en su hot-wallet el 23 de enero de 2025 a las 11:30 UTC. Los depósitos y retiros se suspendieron temporalmente; los fondos en cold-wallets no se vieron afectados. El exchange contrató a empresas de seguridad externas y colaboró con las fuerzas del orden, restableciendo los servicios de forma gradual durante las semanas siguientes. Si tenías una clave API de Phemex activa durante ese periodo y no la has rotado desde entonces, considérala comprometida y vuelve a generarla. El esquema de firma no ha cambiado; se trata de una medida de higiene operativa para rotar cualquier clave anterior a las medidas de seguridad aplicadas tras el incidente.
06 · Ámbito de subcuentas
Las subcuentas tienen sus propias claves; utilízalas para asignar claves específicas por estrategia
Las subcuentas de Phemex actúan como un límite de seguridad de primer nivel: cada sub-account tiene su propio saldo, sus propias posiciones y sus propias claves API. El uso de claves específicas por estrategia vinculadas a una sub-account limita el impacto en caso de filtración de una clave, y te permite limitar el riesgo de cada estrategia al saldo de esa sub-account en lugar de comprometer toda la cuenta. Te recomendamos usar una sub-account por cada estrategia en producción como patrón predeterminado, junto con una clave operativa independiente en la cuenta principal para realizar transferencias entre subcuentas a las que el código de la estrategia no deba tener acceso.
Sección 06 · Diseñado para
Diseñado para
Los runtimes de TradingHost para Phemex son ideales para:
- Desarrolladores que crean estrategias en IDE de IA (Cursor, Claude Code)
- Traders sistemáticos de criptomonedas
- Desarrolladores quant
- Usuarios de CCXT, Freqtrade y Hummingbot
- Equipos que migran de un alojamiento VPS a un despliegue 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 Phemex.
No. El código de tu estrategia se conecta a Phemex y envía instrucciones según tu propia lógica, los permisos de tu cuenta y el método de integración elegido. TradingHost proporciona el entorno de ejecución (runtime) donde se ejecuta ese código.
No. El acceso a la API de Phemex lo proporciona Phemex. Tú eres responsable de tu cuenta de Phemex, los permisos de la API, las credenciales y el cumplimiento de los términos de servicio de Phemex.
No. TradingHost es el entorno de ejecución en la nube donde se ejecuta el código de tu estrategia. No proporcionamos señales, modelos de predicción de IA ni bots preconfigurados. Con TradingHost, tú escribes o generas la estrategia (a menudo con Cursor o Claude Code), la guardas en GitHub como tu propio código y usas TradingHost para ejecutarla en producción. Productos como 3Commas o Cryptohopper son los propietarios de la lógica de la estrategia; TradingHost simplemente ejecuta la tuya.
AWS y DigitalOcean te ofrecen capacidad de cómputo pura. Tú te encargas de las actualizaciones del sistema operativo, la orquestación de contenedores, el envío de logs, la rotación de credenciales, la conmutación por error de región y la monitorización del tiempo de actividad. TradingHost te ofrece un entorno de ejecución gestionado y diseñado específicamente para estrategias de trading: despliegue nativo desde GitHub, control mediante MCP desde IDE de IA, y paneles de logs y estado listos para usar. Si prefieres gestionar la infraestructura tú mismo, AWS es una opción. Si quieres el entorno de ejecución como un servicio gestionado, TradingHost es el camino más rápido.
Sí. TradingHost ejecuta estrategias en Python; elige el entorno de ejecución de framework que coincida con tu pila tecnológica o despliega tu propio repositorio.
Sí. TradingHost es compatible con cualquier lenguaje que pueda ejecutarse dentro de un contenedor.
Sí. CCXT expone los mercados spot y de swaps perpetuos de Phemex a través de la clase unificada `phemex`. Coloca tu estrategia de CCXT en un contenedor, conéctala a GitHub y TradingHost la ejecutará como cualquier otro proyecto de Python o Node. Consulta el entorno de ejecución del framework CCXT para ver todos los detalles de configuración.
Sí, si tu proyecto está diseñado de esa manera. Puedes ejecutar múltiples procesos o servicios de estrategia dentro de un mismo entorno de ejecución, o separarlos en diferentes entornos para mayor aislamiento y claridad operativa. Las subcuentas de Phemex se adaptan de forma natural al modelo multiestrategia: asigna una clave por sub-account y por estrategia. Consulta 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, Freqtrade o Hummingbot para tener un proyecto listo para desplegar. O bien, conecta tu propio repositorio de estrategias de GitHub. Vincular un repositorio de GitHub y crear una estrategia es gratis; los planes de ejecución se detallan en la página de precios.
En tu flujo de trabajo de secretos controlado por GitHub. TradingHost las lee 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 clave API ni de tu clave secreta de Phemex. Consulta la sección de secretos de la plataforma para conocer el modelo de gestión completo.
No. Las estrategias nunca deberían necesitar permisos de retiro. Utiliza permisos limitados (lectura, trading) y mantén la opción de retiro completamente desactivada en la clave de la estrategia. Las subcuentas de Phemex te permiten limitar el impacto por estrategia, de modo que la cuenta principal nunca contenga una clave de estrategia con capacidad de retiro.
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 logs, 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. Consulta la interfaz de control MCP para obtener más información.
Ambos. La interfaz de control 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 tu rama principal activa un nuevo despliegue.
El entorno de ejecución detecta el fallo y muestra los logs y la información de estado correspondientes. Siempre que sea posible, la estrategia afectada se puede reiniciar sin interrumpir otras estrategias que se ejecuten en el mismo contenedor. El código de tu estrategia sigue siendo responsable de la gestión segura de errores, la protección contra órdenes duplicadas y los controles de riesgo. Consulta la sección de observabilidad para conocer los paneles de logs y estado.
El limitador de peticiones de Phemex se divide en tres grupos independientes (contract, spotOrder, others), y superar uno de ellos no limita a los demás. Si tu bucle de contract se está limitando mientras spot sigue funcionando, la restricción está en el presupuesto del grupo contract, no en la cuenta global. Reduce la frecuencia de peticiones de contract, o divide el trabajo de contract y spot en subcuentas independientes, cada una con sus propias claves. Consulta la sección de Notas operativas anterior para ver la guía completa.
TradingHost se ejecuta en las regiones EU y US-East. Elige la región más cercana al motor de emparejamiento del que dependa tu estrategia. Consulta la página de regiones para obtener detalles sobre enrutamiento y proximidad.
No. TradingHost se centra en el entorno de ejecución (runtime) y el despliegue en producción. El backtesting corresponde a su entorno de investigación, framework o AlgoBuilder.