Runtime natif IA pour stratégies de trading Phemex
Développez vos stratégies dans Cursor, Claude Code ou n'importe quel IDE IA. Déployez depuis GitHub dans un runtime cloud géré avec contrôle MCP de premier ordre, logs et sélection de la région.
Section 01 · En un coup d’œil
En un coup d’œil
- Plateforme
- Phemex
- Type de plateforme
- Plateforme d'échange crypto
- Classe d’actifs
- Crypto
- Produits pris en charge
- Spot, contrats perpétuels en USDT et inverses, futures datés, sous-comptes, ainsi qu'un testnet public
- Modèle d’exécution
- Runtime de stratégie conteneurisé
- Source de déploiement
- GitHub
- Langages
- Tout langage s'exécutant dans un conteneur
- Intégrations courantes
- REST et WebSocket natifs Phemex, CCXT, Freqtrade, Hummingbot, connecteurs personnalisés
- Intégration du workflow d’IA
- Interface de contrôle MCP pour Cursor, Claude Code, GitHub Copilot et agents CLI
- Rôle de TradingHost
- Runtime, déploiement, logs, suivis de santé, sélection de la région, contrôle MCP
- Rôle de Phemex
- Compte d'échange, accès API, accès au marché, lieu d'exécution
- Affiliation
- TradingHost est indépendant et n'est pas affilié à Phemex
Section 02 · Ce que propose Phemex
Ce que propose Phemex
Phemex propose du spot, des contrats perpétuels margés en USDT, des perpétuels inverses et des futures datés via des API REST et WebSocket. L'authentification s'effectue par HMAC-SHA256 avec un horodatage d'expiration de requête explicite, et le limiteur de débit est divisé en trois groupes indépendants (contract, spotOrder, others) afin qu'une boucle contract intensive ne bloque pas les ordres spot. Un testnet distinct sur testnet-api.phemex.com vous permet de valider vos stratégies avec la même structure d'API sans capital réel. Phemex US fonctionne comme une entité distincte ; l'API mondiale ne le couvre pas. Les spécificités des endpoints évoluent avec le temps. La structure globale reste stable ; les limites de débit précises, les paliers de frais et les listes de symboles figurent dans la documentation de Phemex.
Marchés et types de stratégies
- Stratégies sur contrats perpétuels margés en USDT
- Contrats perpétuels inverses (margés en pièces)
- Stratégies spot sur paires USDT et BTC
- Déploiements multi-stratégies isolés par sous-comptes
- Déploiements validés sur testnet avant le passage en production
- Arbitrage de taux de financement (funding rate carry) sur contrats perpétuels
- Consommation des flux de carnet d'ordres et de transactions via WebSocket
- Exécution croisée entre groupes de limites de débit (contract + spot)
Interface API
- Produits couverts
- Spot, perpétuels margés en USDT, perpétuels inverses (margés en pièces), futures datés et hiérarchies de sous-comptes. Un testnet public sur testnet-api.phemex.com fonctionne sur un pool distinct avec son propre budget de requêtes et ne permet pas de négocier des actifs réels. Phemex US opère en tant qu'entité distincte sur une infrastructure séparée ; les comptes Phemex mondiaux ne sont pas interchangeables avec les comptes Phemex US.
- Méthodes de connexion
- REST pour le placement d'ordres et les requêtes de compte. WebSocket pour les données de marché en temps réel, les mises à jour du carnet d'ordres, les transactions et les événements de compte. Les abonnements WebSocket privés nécessitent une authentification lors de la connexion.
- Authentification
- Clé API, secret et horodatage d'expiration de requête signé avec HMAC-SHA256. Trois groupes de limites de débit (contract, spotOrder, others) disposent chacun de leur propre budget de requêtes ; dépasser l'un ne restreint pas les autres. Les sous-comptes peuvent détenir des clés avec des permissions restreintes par rapport au compte parent.
Pour plus de détails, reportez-vous à Phemex
Les endpoints spécifiques, les poids des limites de débit, les listes de symboles, les paliers de frais et l'historique des versions figurent dans la documentation de Phemex. Considérez-les comme la source de vérité.
Section 03 · Développer avec l’IA
Développez votre stratégie Phemex avec l’IA
Choisissez une méthode d’intégration, dupliquez (fork) un starter de framework TradingHost et concevez votre stratégie dans un AI IDE. Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande fonctionnent tous avec le même cycle de déploiement natif sur GitHub.
API Phemex native
Contrôle direct du comportement spécifique à Phemex, des données de compte et de la logique d'exécution des ordres sur le spot, les perps USDT et les perps inverses.
CCXT
Interface commune entre Phemex et d'autres plateformes d'échange crypto. CCXT expose les marchés spot et de swaps perpétuels de Phemex via la classe unifiée `phemex`.
Freqtrade ou Hummingbot
Déploiements basés sur des frameworks utilisant leur structure de stratégie et leur modèle de configuration. Les deux listent Phemex parmi les plateformes d'échange prises en charge.
Connecteur personnalisé
Votre propre moteur de trading interne ou intégration propriétaire Phemex, signant les requêtes avec HMAC-SHA256 selon le protocole d'expiration publié.
Compatibilité des frameworks avec les produits Phemex
La couverture varie selon le framework. CCXT couvre la plus large surface de Phemex pour le spot et les swaps perpétuels ; Freqtrade et Hummingbot couvrent le spot, le support des perpétuels dépendant de la version du connecteur ; l'accès natif à l'API Phemex couvre tout ce que propose Phemex, y compris les contrats inverses et les hiérarchies de sous-comptes.
✓ support confirmé selon la documentation officielle du framework. "no" indique qu'il n'est pas officiellement documenté comme supporté. "partial" indique une couverture limitée, voir le texte ci-dessus pour plus de détails.
TradingHost n’impose aucun framework. Il exécute votre projet.
Développer avec l’IA
Les starters de framework ci-dessus s’associent naturellement avec les AI IDE. L’interface de contrôle MCP de TradingHost ferme la boucle : les outils d’IA peuvent inspecter les déploiements, consulter les journaux et gérer l’environnement d’exécution à vos côtés, sans jamais interférer avec le flux d’exécution des ordres.
Section 04 · Exécuter sur TradingHost
Exécutez votre code sur TradingHost
Phemex fournit la plateforme d’échange et l’accès API. TradingHost fournit l’environnement de production où s’exécute votre stratégie connectée à Phemex.
Au lieu d’exécuter le code de votre stratégie sur un ordinateur portable, un ordinateur de bureau, un VPS générique ou un serveur configuré manuellement, vous le déployez depuis GitHub dans un environnement d’exécution de conteneurs géré par TradingHost.
Vous
- Votre dépôt contient votre code.
- Votre déploiement définit son mode d’exécution.
- Votre stratégie se connecte à Phemex.
TradingHost
- Maintient l’environnement d’exécution en ligne.
- Affiche les logs et les contrôles d’état.
- Sélection de la région.
- Surface de déploiement contrôlée.
Flux de déploiement
- ÉTAPE 01
Connecter GitHub
Autorisez TradingHost à accéder à votre compte GitHub.
- ÉTAPE 02
Associez un dépôt ou démarrez depuis un framework
Dirigez TradingHost vers le dépôt de votre stratégie existante, ou forkez un environnement de framework TradingHost (CCXT, Freqtrade ou Hummingbot) pour obtenir une base de travail fonctionnelle.
- ÉTAPE 03
Déployer dans un conteneur TradingHost
Choisissez une région (EU ou US-East), renseignez les variables d'environnement requises par votre stratégie (clé API Phemex, secret et le schéma d'expiration d'horodatage utilisé par votre code), puis déployez. TradingHost construit votre conteneur à partir du dépôt et exécute votre stratégie sur une infrastructure Kubernetes managée. Aucune installation locale de Docker n'est requise.
- ÉTAPE 04
Suivre les logs et l’état de santé
Suivez en direct les logs, l’état de santé et l’état d’exécution depuis le tableau de bord TradingHost. Cette même interface est accessible via MCP depuis n’importe quel AI IDE, permettant à Cursor, Claude Code ou un agent en ligne de commande de lire l’état du déploiement et de gérer le runtime à vos côtés.
- ÉTAPE 05
Mettre à jour et redéployer
Poussez vos modifications sur votre branche principale GitHub et TradingHost relance automatiquement le déploiement.
Section 05 · Notes opérationnelles
Notes opérationnelles pour Phemex
Les pièges qui vous guettent lorsque vous exécutez réellement une stratégie Phemex dans un runtime cloud conteneurisé, absents de la documentation de Phemex et des fichiers README des frameworks. Chaque affirmation ci-dessous est citée ou paraphrasée de la propre documentation de Phemex ; les conseils liés au déploiement proviennent de l'exécution de ces stratégies sur TradingHost.
01 · Division des limites de débit
Trois groupes de requêtes indépendants : contract, spotOrder, others
Le limiteur de débit de l'API de Phemex est divisé en trois groupes indépendants plutôt qu'en un seul pool global. Le groupe `contract` couvre les endpoints de trading de contrats, `spotOrder` couvre le placement d'ordres spot, et `others` couvre tout le reste. Chaque groupe dispose de son propre budget de requêtes ; dépasser l'un ne restreint pas les autres. Concevez vos stratégies combinant spot et perps en fonction du budget de chaque groupe, et non d'un plafond global unique.
02 · Expiration des requêtes
Chaque requête signée nécessite un horodatage d'expiration explicite
Le protocole de signature de Phemex exige un horodatage d'expiration explicite sur chaque requête authentifiée (en secondes Unix, généralement `now + 60`). Les requêtes dont l'expiration est déjà dépassée ou fixée trop loin dans le futur sont rejetées. Une erreur silencieuse courante : le code client calcule l'expiration une seule fois au démarrage et la réutilise pour tous les appels, ce qui provoque des erreurs 401 sur chaque requête après une minute. Calculez l'expiration au moment de la signature, et non lors de l'initialisation, et assurez-vous que les horloges des conteneurs sont synchronisées via NTP.
03 · Pool de testnet
Le testnet fonctionne sur un hôte distinct avec ses propres clés et son propre quota de requêtes
Le testnet de Phemex sur `testnet-api.phemex.com` émet des clés API distinctes, détient des soldes séparés et dessert des endpoints spécifiques. Une erreur d'authentification silencieuse fréquente consiste à configurer une stratégie de production avec des clés de testnet (ou à déployer en production du code validé sur le testnet sans remplacer le jeu de clés). Conservez les secrets du testnet et de la production dans des entrées de secrets TradingHost distinctes, et ne réutilisez jamais un secret d'un environnement à l'autre. Le quota de requêtes du testnet est nettement inférieur à celui du mainnet ; ne dimensionnez pas le débit de votre stratégie sur la base de vos observations sur le testnet.
SourcePhemex testnet docs04 · Séparation US
Phemex US est une entité distincte dotée de sa propre infrastructure
Phemex US (`phemex.com/us`) opère en tant qu'entité juridique distincte de la plateforme mondiale Phemex et fonctionne sur une infrastructure séparée. Un compte Phemex mondial ne donne pas accès à Phemex US, et un compte Phemex US ne peut pas signer de requêtes vers les endpoints de Phemex mondial. Si votre stratégie bascule entre les juridictions américaines et non américaines, configurez la sélection de la plateforme comme une variable de configuration de premier ordre, et non comme un simple commutateur basé sur le type de clé. L'application des restrictions de juridiction s'effectue lors de la création du compte et peut entraîner le rejet des requêtes API en fonction de l'adresse IP.
05 · Posture post-incident
Renouvelez vos clés après janvier 2025 si vous en déteniez pendant l'incident
Phemex a divulgué un incident de sécurité lié à son hot-wallet le 23 janvier 2025 à 11h30 UTC. Les dépôts et les retraits ont été temporairement suspendus ; les fonds stockés sur les cold-wallets n'ont pas été affectés. La plateforme a fait appel à des entreprises de sécurité tierces et aux forces de l'ordre, puis a progressivement rétabli ses services au cours des semaines suivantes. Si vous déteniez une clé API Phemex durant cette période et que vous ne l'avez pas renouvelée depuis, considérez-la comme compromise et générez-en une nouvelle. Le mécanisme de signature lui-même reste inchangé ; la bonne pratique opérationnelle consiste simplement à renouveler toute clé antérieure aux mesures de sécurité post-incident.
06 · Portée des sub-accounts
Les sub-accounts possèdent leurs propres clés ; associez-y des clés dédiées par stratégie
Les sub-accounts de Phemex constituent un cloisonnement de premier ordre : chaque sub-account possède son propre solde, ses propres positions et ses propres clés API. L'utilisation de clés dédiées par stratégie et limitées à un sub-account permet de contenir la zone d'impact en cas de fuite de clé, et de limiter l'exposition de chaque stratégie au solde de son sub-account plutôt qu'à la totalité du compte. Nous vous conseillons d'utiliser par défaut un sub-account par stratégie en production, avec une clé opérationnelle distincte sur le compte principal pour les transferts entre sub-accounts, qui ne doit pas être accessible par le code de la stratégie.
Section 06 · Conçu pour
Conçu pour
Les runtimes TradingHost pour Phemex sont particulièrement adaptés aux :
- Développeurs concevant des stratégies dans des IDE IA (Cursor, Claude Code)
- Traders crypto systématiques
- Développeurs quantitatifs
- Utilisateurs de CCXT, Freqtrade et Hummingbot
- Équipes migrant d'un hébergement VPS vers un déploiement conteneurisé
La connexion à GitHub et la création de votre première stratégie sont gratuites.
Section 08 · FAQ
FAQ
Non. TradingHost est indépendant et n'est pas affilié à Phemex.
Non. Le code de votre stratégie se connecte à Phemex et envoie des instructions selon votre propre logique, les autorisations de votre compte et votre méthode d'intégration. TradingHost fournit l'environnement d'exécution (runtime) dans lequel ce code s'exécute.
Non. L'accès à l'API Phemex est fourni par Phemex. Vous êtes responsable de votre compte Phemex, des autorisations de votre API, de vos identifiants et du respect des conditions d'utilisation de Phemex.
Non. TradingHost est l'environnement d'exécution cloud (runtime) où s'exécute le code de votre stratégie. Nous ne fournissons pas de signaux, de modèles de prédiction IA ni de bots prêts à l'emploi. Avec TradingHost, vous écrivez ou générez vous-même votre stratégie (souvent avec Cursor ou Claude Code), vous la conservez sur GitHub sous forme de code, et vous utilisez TradingHost pour l'exécuter en production. Des produits comme 3Commas ou Cryptohopper détiennent la logique de la stratégie ; TradingHost se contente d'exécuter la vôtre.
AWS et DigitalOcean vous fournissent de la puissance de calcul brute. Vous devez gérer vous-même les mises à jour de l'OS, l'orchestration des conteneurs, la centralisation des logs, la rotation des secrets, le basculement de région et la surveillance de la disponibilité. TradingHost vous offre un environnement d'exécution géré, conçu spécifiquement pour les stratégies de trading : déploiement natif via GitHub, contrôle piloté par MCP depuis vos IDE IA, ainsi que des interfaces de logs et de suivi d'état prêtes à l'emploi. Si vous souhaitez gérer l'infrastructure vous-même, AWS convient parfaitement. Si vous préférez un environnement d'exécution clé en main sous forme de service géré, TradingHost est la solution la plus simple.
Oui. TradingHost prend en charge les stratégies Python ; choisissez l'environnement d'exécution de framework qui correspond à votre stack ou déployez votre propre dépôt.
Oui. TradingHost prend en charge n'importe quel langage capable de s'exécuter dans un conteneur.
Oui. CCXT expose les marchés spot et de swaps perpétuels de Phemex via la classe unifiée `phemex`. Intégrez votre stratégie CCXT dans un conteneur, liez-la à GitHub, et TradingHost l'exécutera comme n'importe quel projet Python ou Node. Consultez la page de l'environnement d'exécution du framework CCXT pour connaître la procédure de configuration complète.
Oui, si votre projet est conçu ainsi. Vous pouvez exécuter plusieurs processus ou services de stratégie au sein d'un même environnement d'exécution, ou les séparer dans différents environnements pour plus d'isolation et de clarté opérationnelle. Les sub-accounts de Phemex s'associent parfaitement au modèle multi-stratégie : attribuez une clé par sub-account et par stratégie. Consultez la page de l'environnement d'exécution TradingHost pour en savoir plus sur le modèle multi-stratégie.
La méthode la plus rapide consiste à dupliquer (fork) un environnement d'exécution de framework TradingHost : CCXT, Freqtrade ou Hummingbot pour obtenir un projet prêt à être déployé. Vous pouvez également connecter votre propre dépôt de stratégie GitHub. Lier un dépôt GitHub et créer une stratégie est gratuit ; les abonnements pour les environnements d'exécution sont détaillés sur la page des tarifs.
Dans votre flux de gestion des secrets contrôlé par GitHub. TradingHost les lit au moment de l'exécution via les secrets de dépôt GitHub, les secrets d'environnement ou votre propre processus de gestion des secrets approuvé. TradingHost n'a pas besoin de détenir vos clés API et secrètes Phemex. Consultez la page sur les secrets de la plateforme pour connaître le modèle de gestion complet.
Non. Les stratégies ne devraient jamais avoir besoin d'autorisations de retrait. Utilisez des autorisations restreintes (lecture, trading) et excluez totalement les retraits de la clé de la stratégie. Les sub-accounts Phemex vous permettent de limiter la zone d'impact par stratégie, de sorte que le compte principal ne détienne jamais de clé de stratégie disposant de droits de retrait.
Oui. TradingHost prend en charge le contrôle basé sur MCP pour les IDE IA, notamment Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande (CLI). Les outils d'IA peuvent inspecter les déploiements, consulter les logs, redémarrer les stratégies et gérer les flux de travail de l'environnement d'exécution. MCP est une interface de contrôle et d'observabilité, et non le canal d'exécution des transactions. Consultez la page sur l'interface de contrôle MCP pour une présentation complète.
Les deux. L'interface de contrôle MCP fonctionne tout aussi bien à partir d'agents en ligne de commande (CLI de Claude Code, clients MCP personnalisés, appels MCP scriptés) que depuis un IDE. Le cycle de déploiement natif GitHub fonctionne également sans aucun outil d'IA : un simple git push vers votre branche principale déclenche un redéploiement.
L'environnement d'exécution détecte le plantage et affiche les logs ainsi que les informations d'état correspondantes. Lorsque cela est pris en charge, la stratégie concernée peut être redémarrée sans perturber les autres stratégies s'exécutant dans le même conteneur. Le code de votre stratégie reste responsable de la gestion sécurisée des erreurs, de la protection contre les ordres doublons et des contrôles de risques. Consultez la page sur l'observabilité pour en savoir plus sur l'interface de logs et de suivi d'état.
Le limiteur de requêtes de Phemex est divisé en trois groupes indépendants (contract, spotOrder, others), et le dépassement de la limite de l'un n'affecte pas les autres. Si votre boucle contract est limitée alors que le spot continue de fonctionner, c'est le quota du groupe contract qui pose problème, et non le compte global. Réduisez la fréquence de vos requêtes contract, ou séparez les activités contract et spot sur des sub-accounts distincts, chacun disposant de ses propres clés. Consultez la section Notes opérationnelles ci-dessus pour obtenir des conseils détaillés.
TradingHost est déployé dans les régions EU et US-East. Choisissez la région la plus proche du moteur d'appariement dont dépend votre stratégie. Consultez la page des régions pour obtenir des détails sur le routage et la proximité.
Non. TradingHost se concentre exclusivement sur l'exécution en production et le déploiement. Le backtesting doit être effectué au sein de votre environnement de recherche, de votre framework ou d'AlgoBuilder.