Temps de lecture : … min

Runtime natif IA pour stratégies Alpaca

Développez dans Cursor, Claude Code ou n'importe quel IDE IA. Déployez depuis GitHub sur un runtime cloud managé avec contrôle MCP de premier ordre, logs et choix de région.

Par l’équipe d’ingénierie de TradingHost

Section 01 · En un coup d’œil

En un coup d’œil

Courtier
Alpaca Securities LLC
Type de courtier
Courtier de détail réglementé aux États-Unis, axé API
Classe d’actifs
Actions US, options US, crypto
Actifs couverts
Actions US (cotations NYSE, NASDAQ, NYSE ARCA, BATS, IEX), options cotées aux États-Unis (single-leg et multi-leg, compensées par l'OCC), crypto (via la filiale Alpaca Crypto LLC), fractions d'actions, ETF.
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
alpaca-py (SDK Python actuel), alpaca-trade-api (obsolète), alpaca-trade-api-js, clients natifs REST et WebSocket, NautilusTrader, connecteurs personnalisés
Intégration du workflow d’IA
Surface de contrôle MCP pour Cursor, Claude Code, GitHub Copilot et agents CLI
Rôle de TradingHost
Runtime, déploiement, logs, bilans de santé, choix de région, contrôle MCP
Rôle de Alpaca
Compte de courtage, accès API, données de marché, lieu d'exécution, garde de titres, règlement-livraison, rapports fiscaux
Régulateurs
Alpaca Securities LLC : courtier-négociant enregistré auprès de la SEC et de la FINRA (CRD 288257). Membre de la SIPC. Alpaca Crypto LLC : entreprise de services monétaires (Money Services Business) enregistrée auprès du FinCEN pour le trading de crypto-actifs.
Particuliers US
Oui. Trading simulé (paper trading) et réel (live trading) tous deux pris en charge.
Affiliation
TradingHost est indépendant et n'est pas affilié à Alpaca Securities LLC ni à Alpaca Crypto LLC

Section 02 · Ce que propose Alpaca

Ce que propose Alpaca

Alpaca propose une API REST et WebSocket pensée pour les développeurs, couvrant les actions US, les options US et les cryptos sous un seul identifiant. L'API Trading API et l'API Market Data API sont hébergées séparément. Les environnements de simulation (paper) et réel (live) partagent la même structure de points de terminaison (endpoints) mais utilisent des clés distinctes, permettant de passer une stratégie testée en simulation au mode réel sans réécriture de code. Les chemins d'accès spécifiques, les limites de requêtes (rate limits) et les abonnements de données sont détaillés dans la documentation d'Alpaca.

Marchés et types de stratégies

  • Rééquilibrage de portefeuille prenant en compte les fractions d'actions
  • Stratégies d'options US single-leg et multi-leg
  • Actions, options et cryptos regroupées sous une API Trading API unifiée
  • Stratégies validées en simulation passant au réel sans modification de code
  • Flux WebSocket en temps réel pour les cotations, transactions et événements de compte
  • Stratégies de crypto au comptant (spot) via Alpaca Crypto LLC (BTC, ETH, etc.)
  • Stratégies systématiques sur actions basées sur les données SIP d'Algo Trader Plus

Interface API

Produits pris en charge
Trading API v2 pour les actions US, les options US et les cryptos sous un seul identifiant. L'API Market Data API fournit les cotations, transactions et barres (bars) sur un hôte distinct. Les environnements de simulation (paper) et réel (live) utilisent des URL de base et des clés différentes ; la structure des points de terminaison étant identique, le code testé en simulation passe au réel sans réécriture.
Méthodes de connexion
REST pour les ordres, les positions, l'état du compte, les chaînes d'options et les métadonnées d'actifs. Flux WebSocket pour les données de marché en temps réel (cotations, transactions, barres) et les mises à jour de transactions au niveau du compte. Les cryptos, actions et options partagent les mêmes conventions REST et WebSocket, ne différant que par l'asset_class et le chemin du point de terminaison.
Authentification
Identifiant de clé API et secret dans les en-têtes de requête APCA-API-KEY-ID et APCA-API-SECRET-KEY. Les clés de simulation et réelles sont émises séparément ; une clé de simulation ne peut pas passer d'ordre réel. OAuth 2.0 est disponible pour les applications déléguées (par exemple, les fintechs d'interface de courtage) plutôt que pour l'accès individuel aux stratégies.

Pour plus de précisions, reportez-vous à Alpaca

Les points de terminaison spécifiques, les limites de requêtes, les niveaux d'abonnement aux données de marché et les exigences d'approbation pour les options figurent dans la documentation d'Alpaca. Considérez-les comme la source de référence.

Section 03 · Développer avec l’IA

Développez votre stratégie Alpaca avec l’IA

Choisissez une méthode d'intégration, dupliquez (fork) un modèle de départ TradingHost, et développez votre stratégie dans un IDE IA. Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande fonctionnent tous avec le même cycle de déploiement natif GitHub.

  • REST et WebSocket natifs Alpaca

    Contrôle direct sur l'état du compte Alpaca, les points de terminaison d'ordres et l'API Market Data API. Utilisez n'importe quel client HTTP et WebSocket compatible avec votre conteneur.

  • alpaca-py

    Le SDK Python officiel actuel d'alpacahq. Couvre la Trading API, la Market Data API, l'API de courtage et la crypto. À utiliser pour les nouveaux projets.

  • alpaca-trade-api (obsolète)

    Ancien SDK Python, toujours maintenu pour les stratégies existantes. Alpaca recommande de migrer vers alpaca-py pour les nouveaux développements.

  • Connecteur personnalisé ou framework

    NautilusTrader, moteurs internes, JavaScript et TypeScript via alpaca-trade-api-js, et tout autre framework encapsulant les points de terminaison REST et WebSocket d'Alpaca.

Prise en charge des bibliothèques et frameworks pour les produits Alpaca

alpaca-py couvre l'ensemble de l'offre d'Alpaca (actions, options, crypto, trading simulé) et constitue le SDK recommandé pour les nouveaux projets. alpaca-trade-api reste maintenu pour les stratégies existantes. NautilusTrader dispose d'une intégration Alpaca maintenue par la communauté ; vérifiez la prise en charge des options dans la documentation actuelle de l'adaptateur avant de l'utiliser.

Bibliothèque ou frameworkActions USOptions USCryptoSimulation
alpaca-pyPris en chargePris en chargePris en chargePris en charge
alpaca-trade-apiPris en chargePris en chargePris en chargePris en charge
alpaca-trade-api-jsPris en chargePartiellement pris en chargePris en chargePris en charge
NautilusTraderPris en chargePartiellement pris en chargePris en chargePris en charge
Native REST + WebSocketPris en chargePris en chargePris en chargePris en charge

✓ prise en charge confirmée selon la documentation officielle du SDK ou de l'adaptateur. « partial » indique une couverture partielle au niveau de l'adaptateur ; à vérifier dans la documentation actuelle de l'intégration. « check SDK » indique que la fonctionnalité dépend de la version du SDK. Les liens de workflow pointent vers les pages /workflows/ en cours de rédaction.

TradingHost n’impose aucune bibliothèque. La plateforme exécute votre projet.

Développer avec l’IA

alpaca-py et alpaca-trade-api fonctionnent tous deux avec les IDE IA. La surface de contrôle MCP de TradingHost ferme la boucle : les outils d'IA peuvent inspecter les déploiements, consulter les logs et gérer le runtime à vos côtés, sans jamais intervenir sur le chemin d'exécution des transactions.

Section 04 · Exécuter sur TradingHost

Exécutez votre code sur TradingHost

Alpaca fournit le compte de courtage, l’accès API et le lieu d’exécution. TradingHost fournit l’environnement de production où s’exécute votre stratégie connectée à Alpaca.

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 conteneur géré par TradingHost.

Vous

  • Votre dépôt contient votre code.
  • Votre déploiement définit ses paramètres d’exécution.
  • Votre stratégie se connecte à Alpaca.

TradingHost

  • Maintient l’environnement d’exécution en ligne.
  • Expose les journaux et les bilans de santé.
  • Sélection de la région.
  • Interface de déploiement contrôlée.

Flux de déploiement

  1. ÉTAPE 01

    Connecter GitHub

    Autorisez TradingHost à accéder à votre compte GitHub.

  2. ÉTAPE 02

    Lier un dépôt ou utiliser un modèle de départ

    Pointez TradingHost vers votre dépôt de stratégie Alpaca existant, ou dupliquez (fork) un modèle de départ alpaca-py pour obtenir une base fonctionnelle.

  3. ÉTAPE 03

    Déployer dans un conteneur TradingHost

    Choisissez une région (US-East est la plus proche des moteurs d'appariement des actions américaines ; EU convient pour le trading de cryptomonnaies durant la session européenne), renseignez votre clé API et votre secret Alpaca comme variables d'environnement, 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.

  4. ÉTAPE 04

    Suivre les journaux et l’état de santé

    Suivez en direct les journaux, l’état de santé et le statut de l’environnement 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 CLI de lire l’état du déploiement et de gérer l’environnement d’exécution à vos côtés. L’exécution des transactions reste exclusivement sur le chemin du code de la stratégie, et non sur MCP.

  5. ÉTAPE 05

    Mettre à jour et redéployer

    Poussez vos modifications sur votre branche principale GitHub et TradingHost se redéploie automatiquement. Un déploiement configuré avec des clés de simulation constitue l'environnement de test idéal avant de passer aux clés réelles.

Section 05 · Notes opérationnelles

Notes opérationnelles pour Alpaca

Ce qui peut poser problème lors de l'exécution réelle d'une stratégie Alpaca dans un environnement cloud conteneurisé, et qui n'est pas toujours mentionné dans la documentation d'Alpaca ou les fichiers README des frameworks. Chaque point ci-dessous est cité ou paraphrasé depuis la documentation officielle d'Alpaca ou une source réglementaire de premier plan ; les conseils de déploiement sont issus de l'exploitation de ces stratégies sur TradingHost.

  1. 01 · En-têtes d'authentification

    APCA-API-KEY-ID et APCA-API-SECRET-KEY dans les en-têtes de requête

    Alpaca authentifie les requêtes de la Trading API à l'aide de l'identifiant de clé API et de la clé secrète transmis dans les en-têtes APCA-API-KEY-ID et APCA-API-SECRET-KEY. Il n'y a pas d'étape de signature distincte. OAuth 2.0 est un flux séparé utilisé par les applications déléguées (une fintech qui s'intègre à Alpaca pour ses clients), et non par les stratégies individuelles. Les clés de simulation (paper) et réelles (live) sont émises séparément et ne sont pas interchangeables.

  2. 02 · Paper vs live

    L'environnement paper utilise une URL de base et une clé différentes

    Le trading de simulation (paper trading) s'exécute sur paper-api.alpaca.markets. Le trading réel (live trading) s'exécute sur api.alpaca.markets. Les points de terminaison de streaming WebSocket diffèrent de la même manière. Les clés générées pour le mode paper ne peuvent pas passer d'ordres en mode live, et inversement. L'ensemble des points de terminaison étant par ailleurs identique, un code validé en mode paper passe en production simplement en remplaçant l'URL de base et le jeu de clés. Conservez les secrets paper et live dans des entrées de secrets TradingHost distinctes ; ne réutilisez jamais un secret d'un environnement à l'autre.

  3. 03 · Niveaux de données de marché

    Basic (IEX uniquement) vs Algo Trader Plus (flux SIP américain complet)

    Le forfait de données de marché par défaut d'Alpaca renvoie uniquement les cotations et transactions de l'IEX, ce qui suffit à de nombreuses stratégies systématiques mais constitue par définition un carnet d'ordres partiel. Algo Trader Plus est l'offre payante de niveau SIP et débloque les données consolidées (consolidated tape). Les stratégies qui dépendent de la précision du meilleur cours acheteur/vendeur (top-of-book) sur l'ensemble des plateformes doivent définir un abonnement Algo Trader Plus comme prérequis de déploiement ; ce n'est pas nécessaire pour les stratégies qui se contentent de l'échantillonnage IEX.

  4. 04 · Actions fractionnées

    Utilisez notional, et non qty, pour les ordres fractionnés, et vérifiez fractionable: true

    Alpaca prend en charge les actions fractionnées par symbole. Pour acheter un montant en dollars plutôt qu'un nombre d'actions, soumettez un ordre avec le paramètre notional au lieu de qty. Avant l'envoi, interrogez le point de terminaison des métadonnées de l'actif pour confirmer que fractionable: true ; tous les symboles cotés ne sont pas fractionnables. Les ordres fractionnés annulés ne peuvent pas faire l'objet d'une exécution partielle de la même manière qu'un ordre d'action entière, la gestion des erreurs doit donc prendre cette différence en compte.

  5. 05 · Approbation pour les options

    Requise séparément des actions ; le niveau d'approbation détermine les stratégies acceptées

    Le trading d'options sur Alpaca nécessite une étape d'approbation distincte de l'ouverture de compte pour les actions. Le niveau d'approbation est exposé sur le point de terminaison du compte ; les ordres qui dépassent le niveau approuvé sont rejetés par Alpaca, et non par TradingHost. Planifiez votre déploiement autour d'une stratégie compatible avec votre niveau d'approbation, ou demandez une extension d'approbation auprès d'Alpaca avant le déploiement. TradingHost ne peut ni déroger à ces règles ni modifier votre niveau d'approbation des options.

  6. 06 · Pattern Day Trader

    Le statut PDT s'applique aux comptes sur marge de moins de 25 000 $ selon la règle FINRA Rule 4210

    La règle FINRA Rule 4210 qualifie un compte sur marge de Pattern Day Trader après quatre opérations de day trading ou plus sur une période de cinq jours ouvrables, et restreint toute nouvelle opération de day trading tant que l'encours du compte n'atteint pas 25 000 $. Alpaca expose cet indicateur sur le point de terminaison du compte (pattern_day_trader). Cette règle est appliquée par le courtier, et non par l'environnement d'exécution. Les stratégies qui effectuent des opérations de day trading fréquentes sur des comptes sur marge inférieurs à ce seuil doivent s'adapter à cette restriction ou approvisionner le compte au-delà de 25 000 $.

  7. 07 · Entité crypto

    Les transactions crypto passent par Alpaca Crypto LLC, une entité distincte enregistrée auprès du FinCEN

    Le trading de crypto au comptant (spot) est proposé par Alpaca Crypto LLC, une entreprise de services monétaires (Money Services Business) enregistrée auprès du FinCEN, et non par Alpaca Securities LLC. Du point de vue de la stratégie, les identifiants sont identiques et l'interface de passage d'ordres est exposée via la même Trading API ; d'un point de vue réglementaire, l'entité juridique est distincte. La protection de la SIPC s'applique au compte de courtage, mais pas aux avoirs en cryptomonnaies. Mentionnez-le clairement dans tout document d'avertissement sur les risques que vous générez parallèlement à la stratégie.

Section 06 · Conçu pour

Conçu pour

Les runtimes TradingHost Alpaca sont particulièrement adaptés pour :

  • Développeurs concevant des stratégies dans des IDE IA (Cursor, Claude Code)
  • Traders systématiques d'actions et d'options
  • Développeurs quantitatifs passant du notebook à la production
  • Développeurs Python utilisant alpaca-py
  • Traders particuliers s'affranchissant des interfaces graphiques de courtiers (Robinhood, Webull, Power E*Trade)

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é à Alpaca Securities LLC ni à Alpaca Crypto LLC.

Non. TradingHost est un environnement d'exécution (runtime) pour le code de vos stratégies de trading. Alpaca Securities LLC est le courtier-dépositaire (broker-dealer), enregistré auprès de la SEC et de la FINRA (CRD 288257) et membre de la SIPC. Votre compte, la conservation des titres, l'accès au marché, le règlement-livraison et les déclarations fiscales sont entièrement gérés par Alpaca.

Non. Le code de votre stratégie se connecte à Alpaca et transmet les instructions d'achat ou de vente selon votre propre logique, les autorisations de votre compte et votre méthode d'intégration. TradingHost fournit l'environnement d'exécution où tourne ce code.

Non. L'accès à l'API d'Alpaca est fourni par Alpaca. Vous êtes responsable de votre compte Alpaca, des autorisations d'API, de vos identifiants et du respect des conditions d'utilisation d'Alpaca.

AWS et DigitalOcean vous fournissent de la puissance de calcul brute. Vous devez gérer vous-même les mises à jour du système d'exploitation, l'orchestration des conteneurs, la centralisation des journaux, la rotation des secrets, le basculement régional et la surveillance de la disponibilité. TradingHost vous offre un environnement d'exécution géré et conçu spécifiquement pour les stratégies de trading : déploiement natif depuis GitHub, contrôle via MCP depuis vos IDE IA, ainsi que des interfaces intégrées pour les journaux et le suivi de l'état de santé. Si vous souhaitez gérer l'infrastructure vous-même, AWS convient parfaitement. Si vous préférez un environnement d'exécution sous forme de service managé, TradingHost est la voie la plus directe.

Oui. Le SDK Python actuel d'Alpaca est alpaca-py ; l'ancienne bibliothèque alpaca-trade-api est toujours maintenue. Les deux fonctionnent sur TradingHost. JavaScript et TypeScript sont pris en charge via alpaca-trade-api-js.

Oui. TradingHost prend en charge tous les langages capables de s'exécuter dans un conteneur. Alpaca propose alpaca-trade-api-js pour JS et TS ; les autres langages peuvent appeler directement les points de terminaison REST et WebSocket.

Oui, sous réserve de l'approbation des options par Alpaca. Les options sont accessibles via les mêmes identifiants de la Trading API que les actions et les cryptomonnaies. Le niveau d'approbation détermine les stratégies acceptées par le courtier ; TradingHost ne permet pas de contourner cette approbation.

Oui. Les cryptomonnaies sont proposées par Alpaca Crypto LLC, une entreprise de services monétaires (Money Services Business) enregistrée auprès du FinCEN, qui est une entité juridique distincte d'Alpaca Securities LLC. Du point de vue de la stratégie, les identifiants de la Trading API sont identiques ; d'un point de vue réglementaire, l'entité est distincte.

Connectez votre dépôt GitHub contenant le code de votre stratégie, associez-le à TradingHost et lancez le déploiement. Utilisez un déploiement avec des clés paper comme environnement de test, puis passez aux clés live une fois la stratégie stable. L'association de GitHub et la création d'une stratégie sont gratuites ; les forfaits 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 approuvé de gestion des secrets. TradingHost n'a pas besoin de conserver vos clés APCA-API-KEY-ID et APCA-API-SECRET-KEY. Consultez la section sur les secrets de la plateforme pour connaître l'intégralité du modèle de gestion.

Non. Vos stratégies ne doivent jamais nécessiter d'autorisations de retrait ou de transfert de fonds. La clé API requiert uniquement les habilitations (scopes) nécessaires pour la transmission d'ordres et l'accès aux données de marché.

Oui. TradingHost prend en charge le contrôle via MCP pour les IDE d'IA, y compris Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande. Les outils d'IA peuvent inspecter les déploiements, consulter les logs, redémarrer les stratégies et gérer les flux de travail d'exécution. MCP est une interface de contrôle et d'observabilité, et non le chemin d'exécution des transactions. Consultez la section sur l'interface de contrôle MCP pour en savoir plus.

Oui, à condition de les traiter comme des stratégies TradingHost distinctes avec des secrets séparés. L'environnement paper d'Alpaca utilise des URL de base et des clés différentes de l'environnement live, de sorte que les déploiements sont isolés par configuration. Le même code source peut alimenter les deux environnements avec des variables d'environnement différentes.

Non. La règle PDT (FINRA Rule 4210) est appliquée par Alpaca, et non par TradingHost. Les comptes sur marge inférieurs à 25 000 $ sont soumis aux restrictions PDT sur le day trading. Votre stratégie doit interroger l'endpoint du compte et respecter le flag pattern_day_trader.

Non. Vos formulaires 1099 sont fournis par Alpaca en fin d'année, pas par TradingHost. TradingHost fournit l'environnement d'exécution (runtime) ; Alpaca gère les déclarations fiscales liées au courtage.

Non. La SIPC couvre votre compte de courtage Alpaca (jusqu'à 500 000 $, dont 250 000 $ en espèces) dans le cadre de la protection des membres de la SIPC. L'environnement d'exécution de TradingHost n'est pas assuré par la SIPC car TradingHost n'est pas un courtier.

TradingHost fonctionne dans les régions EU et US-East. US-East est la plus proche des moteurs d'appariement des actions américaines, ce qui en fait le choix naturel pour la plupart des stratégies Alpaca. Consultez la page des régions pour obtenir des détails sur le routage et la proximité.

Non. TradingHost se concentre exclusivement sur l'environnement d'exécution en production et le déploiement. Le backtesting doit être effectué au sein de votre infrastructure de recherche, de votre framework ou d'AlgoBuilder.