Lesezeit … Min.

KI-native Runtime für bitFlyer-Handelsstrategien

Entwickeln Sie in Cursor, Claude Code oder einer beliebigen KI-IDE. Deployen Sie direkt aus GitHub in eine verwaltete Cloud-Runtime mit erstklassiger MCP-Steuerung, Logs und Regionsauswahl.

Vom TradingHost-Engineering-Team

Sektion 01 · Auf einen Blick

Auf einen Blick

Handelsplatz
bitFlyer
Handelsplatz-Typ
Krypto-Börse (lizenziert in JP, US, EU)
Anlageklasse
Krypto (Spot, JP Crypto CFD)
Unterstützte Produkte
Spot-Handel für BTC-, ETH- und JPY-Paare. Nur in JP: Crypto-CFD-Produkt FX_BTC_JPY (ehemals Lightning FX). Die Produktverfügbarkeit unterscheidet sich je nach regulatorischem Sitz; US- und EU-Konten sehen eine Teilmenge der JP-product_code-Liste.
Laufzeit-Modell
Containerisierte Strategie-Runtime
Deployment-Quelle
GitHub
Programmiersprachen
Jede Sprache, die in einem Container läuft
Gängige Integrationen
Native bitFlyer Lightning API (REST und WebSocket), CCXT, eigene Connectoren
KI-Workflow-Integration
MCP-Steuerungsoberfläche für Cursor, Claude Code, GitHub Copilot und CLI-Agents
Rolle von TradingHost
Runtime, Deployment, Logs, Health Checks, Regionsauswahl, MCP-Steuerung
Rolle von bitFlyer
Börsenkonto, API-Zugang, Marktzugang, Ausführungsplatz
Verbindung
TradingHost ist unabhängig und steht in keiner Verbindung zu bitFlyer.

Sektion 02 · Das Angebot von bitFlyer

Das Angebot von bitFlyer

bitFlyer bietet Spot-Handel für BTC, ETH und andere Paare in drei Regionen (JP, US, EU) sowie ein nur in Japan verfügbares Crypto-CFD-Produkt (FX_BTC_JPY). Alle Regionen nutzen denselben Lightning API-Endpunkt unter api.bitflyer.com, greifen jedoch auf unterschiedliche product_code-Zuordnungen und Produktpaletten zu. Strategien authentifizieren sich über Anfragen mit drei Headern, die per HMAC-SHA256 signiert sind. Spezifische Endpunktdetails können sich ändern. Die grundlegende Struktur bleibt stabil; die genauen Rate-Limit-Gewichtungen, Gebührenstufen und Produktlisten sind der bitFlyer-Dokumentation zu entnehmen.

Märkte und Strategiemuster

  • In JPY notierte Spot-Strategien (BTC_JPY, ETH_JPY)
  • In USD notierte Spot-Strategien (US-Konten)
  • In EUR notierte Spot-Strategien (EU-Konten)
  • JP Crypto-CFD-Strategien über FX_BTC_JPY
  • Funding-Rate-Trading auf JP Crypto CFD
  • Länderübergreifende Preisarbitrage innerhalb derselben Kontostruktur
  • Echtzeit-Marktdaten-Abonnements via WebSocket
  • Über Unterkonten isolierte Multi-Strategie-Deployments

API-Schnittstelle

Produktbereiche
Spot-Handel für BTC, ETH und andere gelistete Paare. Nur in JP: Crypto CFD (FX_BTC_JPY, ehemals Lightning FX), abgerechnet in JPY. Die Produktverfügbarkeit ist regulatorisch beschränkt; derselbe Lightning API-Endpunkt bedient alle drei Regionen, aber die product_code-Zuordnung unterscheidet sich je nach Konto.
Verbindungsmethoden
REST unter https://api.bitflyer.com/v1/ für Orderplatzierung, Marktdaten und Kontoabfragen. WebSocket via JSON-RPC 2.0 über den Endpunkt lightning.bitflyer.com für Echtzeit-Marktdaten und private Kanäle. Öffentliche WebSocket-Kanäle erfordern keine Authentifizierung, private Kanäle hingegen schon.
Authentifizierung
API-Key und Secret pro Strategie. Private REST-Anfragen enthalten die Header ACCESS-KEY, ACCESS-TIMESTAMP und ACCESS-SIGN. Die Signatur ist ein HMAC-SHA256 über Zeitstempel + HTTP-Methode + Pfad + Body, ausgegeben als Hex-String. Berechtigungen werden pro Key vergeben (Lesen, Handeln, Auszahlen). Strategien sollten niemals Auszahlungsberechtigungen benötigen.

Details finden Sie direkt bei bitFlyer

Spezifische Endpunkte, Rate-Limit-Gewichtungen, product_code-Listen, Gebührenstufen und die Versionshistorie finden Sie in der bitFlyer-Dokumentation. Diese gilt als maßgebliche Quelle.

Sektion 03 · Mit KI entwickeln

Entwickeln Sie Ihre bitFlyer-Strategie mit KI

Wählen Sie eine Integrationsmethode, forken Sie ein TradingHost-Framework-Starter-Repository und schreiben Sie Ihre Strategie in einer AI IDE. Cursor, Claude Code, GitHub Copilot und CLI-basierte KI-Agenten nutzen alle denselben GitHub-nativen Deployment-Prozess.

  • Native bitFlyer Lightning API

    Direkte Kontrolle über bitFlyer-spezifisches Verhalten, product_code-Zuordnungen und Orderausführungslogik.

  • CCXT

    Einheitliche Schnittstelle für bitFlyer und andere Krypto-Börsen.

  • Hummingbot

    Framework-basierte Deployments unter Nutzung der Strategiestruktur und des Konfigurationsmodells von Hummingbot.

  • Eigener Connector

    Ihre eigene interne Trading-Engine oder proprietäre bitFlyer-Integration.

Framework-Unterstützung für bitFlyer-Produkte

Die Framework-Unterstützung ist für bitFlyer lückenhafter als für Tier-1-Handelsplätze. CCXT bildet den bitFlyer-Spot-Handel über die vereinheitlichte Klasse bitflyer ab; das japanische Crypto-CFD-Produkt ist in CCXT jedoch kein natives Standard-Primitive. Hummingbot und Freqtrade führen bitFlyer nicht unter ihren offiziell unterstützten Börsen. Der native Zugriff über die bitFlyer Lightning API deckt das gesamte Angebot von bitFlyer in der jeweiligen Region ab.

FrameworkSpotJP CFDOptionen
Native bitFlyer Lightning APIUnterstütztUnterstütztNicht als unterstützt dokumentiert
CCXTUnterstütztNicht als unterstützt dokumentiertNicht als unterstützt dokumentiert
HummingbotNicht als unterstützt dokumentiertNicht als unterstützt dokumentiertNicht als unterstützt dokumentiert
FreqtradeNicht als unterstützt dokumentiertNicht als unterstützt dokumentiertNicht als unterstützt dokumentiert

✓ Bestätigter Support laut offizieller Framework-Dokumentation. „no“ bedeutet, dass keine offizielle Unterstützung dokumentiert ist.

TradingHost schreibt kein Framework vor. Es führt Ihr Projekt einfach aus.

Mit KI programmieren

Die oben genannten Framework-Starter lassen sich nahtlos mit KI-IDEs kombinieren. Die TradingHost-MCP-Steuerungsebene schließt den Kreis: KI-Tools können Deployments analysieren, Logs prüfen und die Laufzeitumgebung gemeinsam mit Ihnen verwalten, ohne jemals in den Pfad der Trade-Ausführung einzugreifen.

Bereich 04 · Auf TradingHost ausführen

Ihren Code auf TradingHost ausführen

bitFlyer stellt die Börse und den API-Zugang bereit. TradingHost liefert die Produktionsumgebung, in der Ihre mit bitFlyer verbundene Strategie läuft.

Statt Ihren Strategie-Code auf einem Laptop, Desktop-PC, einem gewöhnlichen VPS oder einem manuell konfigurierten Server auszuführen, deployen Sie direkt aus GitHub in eine von TradingHost verwaltete Container-Runtime.

Sie

  • Ihr Repository enthält Ihren Code.
  • Ihr Deployment definiert, wie er ausgeführt wird.
  • Ihre Strategie verbindet sich mit bitFlyer.

TradingHost

  • Hält die Runtime online.
  • Stellt Logs und Health-Checks bereit.
  • Auswahl der Region.
  • Kontrollierte Deployment-Umgebung.

Deployment-Ablauf

  1. SCHRITT 01

    GitHub verbinden

    Autorisieren Sie TradingHost für den Zugriff auf Ihr GitHub-Konto.

  2. SCHRITT 02

    Repository verknüpfen oder mit einem Framework starten

    Verknüpfen Sie TradingHost mit Ihrem bestehenden Strategie-Repository oder forken Sie eine TradingHost-Framework-Runtime (CCXT) für eine startbereite Basis.

  3. SCHRITT 03

    In einen TradingHost-Container deployen

    Wählen Sie eine Region (EU oder US-East), geben Sie die von Ihrer Strategie benötigten Umgebungsvariablen an (bitFlyer-API-Key und -Secret, jurisdiktionsspezifischer product_code usw.) und starten Sie das Deployment. TradingHost baut Ihren Container aus dem Repository und führt Ihre Strategie auf einer verwalteten Kubernetes-Infrastruktur aus. Keine lokale Docker-Installation erforderlich.

  4. SCHRITT 04

    Logs und Status überwachen

    Verfolgen Sie Live-Logs, Systemzustand und Runtime-Status direkt im TradingHost-Dashboard. Dieselbe Schnittstelle ist über MCP aus jeder beliebigen AI IDE erreichbar. So können Cursor, Claude Code oder ein CLI-Agent den Deployment-Status auslesen und die Runtime an Ihrer Seite verwalten.

  5. SCHRITT 05

    Aktualisieren und neu deployen

    Pushen Sie Änderungen in Ihren GitHub-Main-Branch und TradingHost deployt automatisch neu.

Sektion 05 · Betriebshinweise

Betriebshinweise für bitFlyer

Fallstricke, die beim tatsächlichen Betrieb einer bitFlyer-Strategie in einer containerisierten Cloud-Runtime auftreten – abseits der offiziellen Dokumentation oder Framework-READMEs. Alle folgenden Punkte basieren auf Zitaten oder Auszügen aus der bitFlyer-Dokumentation; die Deployment-Hinweise stammen aus der Praxis beim Betrieb dieser Strategien auf TradingHost.

  1. 01 · Gemeinsamer Endpunkt

    Die Regionen JP, US und EU nutzen gemeinsam api.bitflyer.com, sehen jedoch unterschiedliche product_code-Zuordnungen

    Alle drei bitFlyer-Regionen (Japan, USA, EU) nutzen denselben Lightning API-Endpunkt unter https://api.bitflyer.com/v1/. Der Parameter product_code dient zur Unterscheidung: Ein japanisches Konto sieht die vollständige Liste inklusive FX_BTC_JPY (Crypto CFD); ein US-Konto sieht eine für die USA lizenzierte Teilmenge; ein EU-Konto eine für die EU lizenzierte Teilmenge. Strategien, die einen rein japanischen product_code fest im Code für ein Nicht-JP-Konto hinterlegen, führen bei der Orderübermittlung zu Fehlern (Produkt nicht verfügbar). Definieren Sie die product_code-Liste als Konfiguration basierend auf der Konto-Region, nicht als Konstante im Code.

  2. 02 · Umbenennung von Crypto CFD

    FX_BTC_JPY ist der aktuelle Product Code; das veraltete „FX BTC/JPY“ Lightning FX wurde im März 2024 eingestellt

    bitFlyer hat sein Margin-Trading-Produkt Lightning FX mit Wirkung zum März 2024 in Crypto CFD umbenannt und den Produktcode auf FX_BTC_JPY vereinheitlicht. Der alte Lightning FX-Endpunkt wurde eingestellt. Signaturen und Header blieben während der Übergangsphase abwärtskompatibel, aber Integrationen, die heute noch den alten Pfad ansteuern, geben Fehler wegen nicht verfügbarer Produkte zurück. Strategien aus der Zeit vor 2024 müssen auf den product_code FX_BTC_JPY unter dem Crypto CFD-Modell migriert werden.

  3. 03 · Dreistufige Ratenbegrenzungen

    Private Anfragen: 500 / 5 Min. pro IP; Orderplatzierungen unter 0,1 BTC pro Minute limitiert; 300 Order-/Stornierungsvorgänge pro 5 Min.

    bitFlyer setzt verschiedene Ratenbegrenzungen durch: 500 private Anfragen pro 5 Minuten pro IP und API-Schlüssel, 100 Orderplatzierungen pro Minute für Orders kleiner als 0,1 BTC sowie 300 Order- oder Stornierungsvorgänge pro 5 Minuten. Strategien, die das Limit für kleine Orders erreichen, stoßen meist kurz darauf auch an das 5-Minuten-Limit. Passen Sie die Platzierungsfrequenz an das jeweils niedrigere Limit an und nutzen Sie WebSockets für Status-Updates, statt REST-Endpunkte aggressiv abzufragen. Laut bitFlyer-Dokumentation können sich diese Limits je nach Systemlast ohne Vorankündigung ändern.

  4. 04 · Authentifizierung über drei Header

    ACCESS-KEY, ACCESS-TIMESTAMP und ACCESS-SIGN sind zwingend erforderlich

    Private REST-Anfragen bei bitFlyer erfordern drei Header: ACCESS-KEY (Ihr API-Schlüssel), ACCESS-TIMESTAMP (Unix-Zeitstempel) und ACCESS-SIGN (HMAC-SHA256 aus Zeitstempel + HTTP-Methode + Pfad + Body, signiert mit Ihrem Secret, Ausgabe als Hex-String). Fehlt einer dieser Header, wird die Anfrage mit einem Signaturfehler abgelehnt. Der kanonische Body muss exakt mit den gesendeten Daten übereinstimmen, einschließlich aller Leerzeichen. Serialisieren Sie JSON-Daten vor dem Signieren mit einer stabilen Sortierung der Schlüssel.

  5. 05 · WebSocket-Protokoll

    JSON-RPC 2.0 über lightning.bitflyer.com; private Channels erfordern Authentifizierung pro Nachricht, nicht pro Verbindung

    Der WebSocket von bitFlyer Lightning nutzt JSON-RPC 2.0 über den Endpunkt lightning.bitflyer.com. Öffentliche Channels (Ausführungen, Orderbuch, Ticker) erfordern keine Authentifizierung. Private Channels (Child-Orders, Parent-Orders, Ausführungen auf Ihrem Konto) verlangen nach dem Verbindungsaufbau eine Authentifizierungsnachricht, die ACCESS-KEY, ACCESS-TIMESTAMP und ACCESS-SIGN als Teil der JSON-RPC-Parameter enthält. Strategien, die sich nur beim HTTPS-Handshake und nicht im JSON-RPC-Body authentifizieren, verlieren im Hintergrund die privaten Subscriptions.

  6. 06 · Berechtigungsbereich der Schlüssel

    Ein spezifisch berechtigter Schlüssel pro Strategie, niemals ein gemeinsamer Master-Schlüssel

    API-Schlüssel von bitFlyer verfügen über feingranulare Berechtigungen (Lesen, Handeln, Auszahlungen). Strategien sollten niemals Auszahlungsrechte benötigen. Verwahren Sie Schlüssel mit Auszahlungsberechtigung separat und verwalten Sie diese manuell außerhalb der Container-Runtime. Eigene Schlüssel pro Strategie, die nur die absolut notwendigen Rechte besitzen, begrenzen den potenziellen Schaden bei einem Datenleck. IP-Whitelisting wird unterstützt; nutzen Sie diese Funktion, wenn der Egress-IP-Bereich der Runtime in Ihrer Region stabil ist.

Sektion 06 · Entwickelt für

Entwickelt für

TradingHost-Runtimes für bitFlyer eignen sich besonders für:

  • Entwickler, die Strategien in KI-IDEs (Cursor, Claude Code) erstellen
  • Systematische Krypto-Trader
  • Quant-Entwickler
  • Inhaber von bitFlyer-Konten in Japan, den USA und der EU
  • CCXT-Nutzer
  • Teams, die von VPS-Hosting auf containerisierte Deployments umsteigen

Die Verknüpfung mit GitHub und das Erstellen Ihrer ersten Strategie sind kostenlos.

Sektion 08 · FAQ

FAQ

Nein. TradingHost ist unabhängig und steht in keiner Verbindung zu bitFlyer.

Nein. Ihr Strategie-Code verbindet sich direkt mit bitFlyer und sendet Aufträge basierend auf Ihrer eigenen Logik, Ihren Kontoberechtigungen und Ihrer Integrationsmethode. TradingHost stellt lediglich die Runtime bereit, in der dieser Code ausgeführt wird.

Nein. Der API-Zugang wird von bitFlyer bereitgestellt. Sie sind selbst für Ihr bitFlyer-Konto, die API-Berechtigungen, Ihre Zugangsdaten und die Einhaltung der Nutzungsbedingungen von bitFlyer verantwortlich.

Nein. TradingHost ist die Cloud-Runtime, auf der Ihr eigener Strategie-Code läuft. Wir bieten keine Signale, KI-Vorhersagemodelle oder fertigen Bots an. Bei TradingHost schreiben oder generieren Sie Ihre Strategie selbst (oft mit Cursor oder Claude Code), verwalten sie als Ihren Code auf GitHub und nutzen TradingHost, um sie live auszuführen. Während Plattformen wie 3Commas oder Cryptohopper die Strategielogik vorgeben, führt TradingHost Ihre eigene Strategie aus.

AWS und DigitalOcean stellen reine Rechenleistung bereit. Sie müssen sich selbst um Betriebssystem-Updates, Container-Orchestrierung, Log-Weiterleitung, Secret-Rotation, Ausfallsicherheit in verschiedenen Regionen und Uptime-Monitoring kümmern. TradingHost bietet Ihnen eine verwaltete Runtime, die speziell für Trading-Strategien entwickelt wurde: GitHub-natives Deployment, MCP-Steuerung direkt aus KI-IDEs sowie integrierte Oberflächen für Logs und Systemzustand. Wenn Sie die Infrastruktur selbst verwalten möchten, ist AWS eine Option. Wenn Sie die Runtime als Managed Service nutzen wollen, ist TradingHost der direktere Weg.

Ja. TradingHost führt Python-Strategien aus. Wählen Sie einfach die Framework-Runtime, die zu Ihrem Stack passt, oder deployen Sie Ihr eigenes Repository.

Ja. TradingHost unterstützt jede Programmiersprache, die in einem Container ausgeführt werden kann.

Ja. CCXT bindet bitFlyer über die vereinheitlichte Klasse `bitflyer` an und deckt den Spot-Handel für die Regionen Japan, USA und EU ab. Das japanische Crypto CFD-Produkt (FX_BTC_JPY) wird von CCXT nicht nativ als Standard-Primitive unterstützt. Für dieses Margin-Produkt sollten Sie die native bitFlyer Lightning API ansteuern. Details zur Einrichtung finden Sie auf der Seite zur CCXT-Framework-Runtime.

Nein. Das japanische Crypto CFD-Produkt (FX_BTC_JPY, ehemals Lightning FX) ist für bitFlyer Japan lizenziert und steht nur Nutzern mit einer japanischen Lizenz zur Verfügung. Konten von bitFlyer in den USA und der EU erhalten eine andere product_code-Zuweisung und können FX_BTC_JPY unabhängig von der Strategielogik nicht über die API handeln. Strategien, die dieses Produkt nutzen, müssen über ein in Japan lizenziertes bitFlyer-Konto laufen, und der Egress-IP-Bereich der Runtime sollte zur Jurisdiktion des Kontos passen.

Ja, sofern Ihr Projekt entsprechend aufgebaut ist. Sie können mehrere Strategieprozesse oder -dienste innerhalb einer Runtime ausführen oder sie zur besseren Isolierung und Übersichtlichkeit auf verschiedene Runtimes aufteilen. Weitere Informationen finden Sie auf der Runtime-Seite von TradingHost unter dem Multi-Strategie-Modell.

Der schnellste Weg ist das Forken einer TradingHost-Framework-Runtime: CCXT für ein sofort einsatzbereites Spot-Projekt. Alternativ können Sie Ihr eigenes GitHub-Strategie-Repository verknüpfen, wenn Sie die native Lightning API für das japanische Crypto CFD-Produkt nutzen möchten. Das Verknüpfen eines GitHub-Repositorys und das Erstellen einer Strategie ist kostenlos. Die Runtime-Tarife finden Sie auf unserer Preisseite.

In Ihrem von GitHub verwalteten Secrets-Workflow. TradingHost liest diese zur Laufzeit über GitHub Repository Secrets, Environment Secrets oder Ihren eigenen freigegebenen Prozess zur Verwaltung von Secrets aus. TradingHost benötigt zu keinem Zeitpunkt die Verwahrung Ihres API-Schlüssels oder Secrets. Details dazu finden Sie unter Plattform-Secrets.

Nein. Strategien sollten niemals Auszahlungsrechte benötigen. Nutzen Sie stattdessen eingeschränkte Berechtigungen (Lesen, Handeln) und gegebenenfalls IP-Whitelisting.

Ja. TradingHost unterstützt die MCP-basierte Steuerung für KI-IDEs wie Cursor, Claude Code, GitHub Copilot und CLI-basierte KI-Agenten. KI-Tools können Deployments prüfen, Logs einsehen, Strategien neu starten und Runtime-Workflows verwalten. MCP dient dabei als Steuerungs- und Monitoring-Schnittstelle, nicht als Pfad für die Trade-Ausführung. Mehr dazu erfahren Sie unter MCP-Steuerung.

Beides. Die MCP-Steuerung funktioniert über CLI-basierte Agenten (Claude Code CLI, eigene MCP-Clients, geskriptete MCP-Aufrufe) genauso zuverlässig wie direkt aus einer IDE. Der GitHub-native Deployment-Prozess funktioniert zudem völlig ohne KI-Tools: Ein einfacher Push auf Ihren Main-Branch stößt das Redeployment an.

Die Runtime erkennt den Absturz und stellt die relevanten Logs und Statusinformationen bereit. Sofern unterstützt, kann die betroffene Strategie neu gestartet werden, ohne andere im selben Container ausgeführte Strategien zu beeinträchtigen. Ihr Strategiecode ist weiterhin selbst für eine sichere Fehlerbehandlung, den Schutz vor doppelten Orders und Risikokontrollen verantwortlich. Siehe Observability für Logs und Status-Schnittstellen.

Die product_code-Zuordnung von bitFlyer ist nach Jurisdiktionen eingeschränkt. Derselbe Lightning API-Endpunkt bedient zwar Nutzer in JP, US und der EU, aber jede Jurisdiktion sieht eine andere Auswahl an verfügbaren Produkten. Ein US- oder EU-Konto, das auf FX_BTC_JPY (das JP-exklusive Crypto CFD-Produkt) zugreift, erhält unabhängig von den Berechtigungen des API-Schlüssels product-not-available-Fehler. Strategien, die vor 2024 auf „Lightning FX“ ausgerichtet waren, müssen seit der Umbenennung im März 2024 ebenfalls auf FX_BTC_JPY migriert werden. Legen Sie die product_code-Liste als Konfiguration fest, die auf der Jurisdiktion des Kontos basiert. Die vollständigen Anweisungen finden Sie oben im Abschnitt „Betriebliche Hinweise“.

TradingHost läuft in den Regionen EU und US-East. Wählen Sie die Region, die der von Ihrer Strategie genutzten Matching-Engine am nächsten liegt. Details zu Routing und Latenzen finden Sie auf der Regions-Seite.

Nein. TradingHost konzentriert sich auf die Produktions-Runtime und das Deployment. Backtesting gehört in Ihren Research-Stack, Ihr Framework oder in AlgoBuilder.