Lesezeit … Min.

KI-native Runtime für Ripio-Trading-Strategien

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

Vom TradingHost-Engineering-Team

Sektion 01 · Auf einen Blick

Auf einen Blick

Handelsplatz
Ripio
Handelsplatz-Typ
Krypto-Börse (Lateinamerika, 8 Jurisdiktionen)
Anlageklasse
Krypto mit Multi-Fiat-Notierung für Lateinamerika (BRL, ARS, MXN, EUR, USD)
Unterstützte Produkte
Spot-Handel mit ländergefilterten Paaren (BTC_BRL, ETH_BRL, BTC_ARS, BTC_MXN, BTC_EUR u. a.), lokale Stablecoins (wARS, wBRL, wMXN), Ripio Trade API v4
Laufzeit-Modell
Containerisierte Strategie-Runtime
Deployment-Quelle
GitHub
Programmiersprachen
Jede Sprache, die in einem Container läuft
Gängige Integrationen
Native Ripio Trade API v4 REST und WebSocket, CCXT, eigene Konnektoren
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 Ripio
Börsenkonto, API-Zugang, Marktzugang, Ausführungsplatz
Verbindung
TradingHost ist unabhängig und steht in keiner Verbindung zu Ripio

Sektion 02 · Das Angebot von Ripio

Das Angebot von Ripio

Ripio bietet Spot-Handel in 8 lateinamerikanischen Ländern mit Multi-Fiat-Handelspaaren (BRL, ARS, MXN, EUR, USD) und lokalen Stablecoins (wARS, wBRL, wMXN). Strategien authentifizieren sich über die Ripio Trade API v4 und unterliegen gestaffelten Rate Limits, die an den KYC-Status gekoppelt sind. Die ländergefilterte Verfügbarkeit von Handelspaaren über den Query-Parameter `countries` ermöglicht es, eine einzige Strategie für verschiedene regionale Produktsets bereitzustellen. Spezifische Endpunkte können sich ändern. Die grundlegende Struktur bleibt stabil; die genauen Rate-Limit-Gewichtungen, Paar-Listen und Mindestgrößen sind der Ripio-Dokumentation zu entnehmen.

Märkte und Strategiemuster

  • Spot-Strategien mit BRL-Notierung (BTC_BRL, ETH_BRL, USDC_BRL)
  • Spot-Strategien mit ARS-Notierung für argentinische Peso-Paare
  • Spot-Strategien mit MXN-Notierung für mexikanische Peso-Paare
  • Handel mit lokalen Stablecoins (wARS, wBRL, wMXN)
  • Arbitrage-Strategien zwischen lateinamerikanischen Fiat-Währungen
  • Ländergefilterte Paarsuche über den Query-Parameter `countries`
  • Ticket-authentifizierte WebSocket-Subscriptions für sensible Datenströme
  • Planung der Rate-Limit-Nutzung basierend auf der KYC-Stufe des Kontos

API-Schnittstelle

Produktbereiche
Spot-Handel mit ländergefilterten Paaren in Argentinien, Brasilien, Mexiko, Spanien, Uruguay, Kolumbien, Chile und den USA. Paar-Codes verwenden die Unterstrich-Notation (BTC_BRL, ETH_BRL, BTC_ARS, BTC_MXN). Lokale Stablecoins (wARS, wBRL, wMXN) ermöglichen direkte Transaktionen in digitalen Währungen. Mindestbetrag (`min_amount`), Mindestwert (`min_value`) und Preis-Tick (`price_tick`) müssen für jedes Paar einzeln abgefragt werden.
Verbindungsmethoden
REST für Orderplatzierung, Kontoabfragen und Paarsuche. WebSocket-Streams für Echtzeit-Marktdaten. Der Zugriff auf sensible WebSocket-Themen erfordert ein Ticket, das vor dem Abonnieren über POST `/v4/ticket` angefordert werden muss, nicht nur einen API-Key.
Authentifizierung
Gestaffelte API-Rate-Limits basierend auf dem KYC-Status. Nicht verifizierte Konten: 1 Anfrage pro Sekunde (~86.400 täglich). Verifizierte Konten: 3,5 Anfragen pro Sekunde (~302.400 täglich). Das Überschreiten des Limits gibt HTTP 429 mit dem standardmäßigen Retry-After-Header zurück.

Details finden Sie direkt bei Ripio

Spezifische Endpunkte, Rate-Limit-Gewichtungen, Paar-Listen, Gebührenstufen und die Versionshistorie sind in der Dokumentation von Ripio zu finden. Diese gilt als maßgebliche Quelle.

Sektion 03 · Mit KI entwickeln

Entwickeln Sie Ihre Ripio-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 Ripio-API

    Direkte Kontrolle über Ripio-spezifisches Verhalten, einschließlich ländergefilterter Paarsuche und Order-Routing für lateinamerikanische Fiat-Währungen.

  • CCXT

    Einheitliche Schnittstelle für Ripio und andere Krypto-Börsen. CCXT stellt Ripio Trade über die vereinheitlichte Klasse `ripio` für den Spot-Handel bereit.

  • Freqtrade oder Hummingbot

    Keines der beiden Frameworks führt Ripio derzeit als nativ unterstützte Börse. Der beste Weg sind eigene oder auf CCXT basierende Implementierungen.

  • Eigener Konnektor

    Ihre eigene interne Trading-Engine oder eine proprietäre Integration der Ripio Trade API v4 für REST und WebSocket.

Framework-Unterstützung für Ripio-Produkte

Die Unterstützung variiert je nach Framework. Da Ripio auf Börsenebene nur Spot-Handel anbietet (keine nativen Perpetuals oder Optionen auf Trade), ist die Matrix bewusst schmal gehalten. CCXT stellt den Spot-Handel von Ripio Trade über die vereinheitlichte Klasse `ripio` bereit. Weder Freqtrade noch Hummingbot führen Ripio derzeit als nativ unterstützte Börse; über den nativen API-Zugriff lässt sich jedoch alles erreichen, was Ripio Trade v4 bereitstellt.

FrameworkSpotMarginPerpOptionen
Native Ripio APIUnterstütztNicht als unterstützt dokumentiertNicht als unterstützt dokumentiertNicht als unterstützt dokumentiert
CCXTUnterstütztNicht als unterstützt dokumentiertNicht als unterstützt dokumentiertNicht als unterstützt dokumentiert
FreqtradeNicht als unterstützt dokumentiertNicht als unterstützt dokumentiertNicht als unterstützt dokumentiertNicht als unterstützt dokumentiert
HummingbotNicht als unterstützt dokumentiertNicht als unterstützt dokumentiertNicht als unterstützt dokumentiertNicht als unterstützt dokumentiert

✓ Bestätigter Support laut offizieller Framework-Dokumentation. „no“ bedeutet, dass kein offizieller Support dokumentiert ist. Workflow-Links verweisen auf /workflows/-Seiten, die sich derzeit in der Erstellung befinden.

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

Ripio stellt die Börse und den API-Zugang bereit. TradingHost liefert die Produktionsumgebung, in der Ihre mit Ripio 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 Ripio.

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 funktionierende Ausgangsbasis mit der Ripio Trade API v4.

  3. SCHRITT 03

    In einen TradingHost-Container deployen

    Wählen Sie eine Region (EU oder US-East), hinterlegen Sie die von Ihrer Strategie benötigten Umgebungsvariablen (Ripio Trade API-Key, Ländercode, WebSocket-Ticket-Einstellungen) und starten Sie das Deployment. TradingHost baut Ihren Container aus dem Repository und führt Ihre Strategie auf einer verwalteten Kubernetes-Infrastruktur aus. Eine lokale Docker-Installation ist nicht 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 Ripio

Fallstricke, die beim tatsächlichen Betrieb einer Ripio-Strategie in einer containerisierten Cloud-Runtime auftreten – nicht in der Ripio-Dokumentation oder in den Readmes der Frameworks beschrieben. Jede der folgenden Aussagen ist aus der Dokumentation von Ripio zitiert oder paraphrasiert; die Hinweise zur Bereitstellung basieren auf dem Betrieb dieser Strategien auf TradingHost.

  1. 01 · An KYC-Stufen gekoppelte Rate-Limits

    Nicht verifizierte Konten erhalten 1 rps; verifizierte Konten erhalten 3,5 rps

    Die Rate-Limits der Ripio Trade API v4 sind an die KYC-Stufe gekoppelt und nicht an bestimmte Endpunkt-Klassen. Nicht verifizierte Konten sind auf 1 Anfrage pro Sekunde (ca. 86.400 täglich) beschränkt. Verifizierte Konten erhalten 3,5 Anfragen pro Sekunde (ca. 302.400 täglich). Das Überschreiten des Limits führt zu HTTP 429. Eine Strategie, die im nicht verifizierten Modus startet und später hochgestuft wird, kann ihre sichere Abfragefrequenz fast vervierfachen; umgekehrt wird eine für die verifizierte Stufe geschriebene Strategie bei einem nicht verifizierten Konto sofort HTTP 429-Fehler erzeugen. Hinterlegen Sie die KYC-Stufe in der Runtime-Konfiguration, um das Rate-Limit-Budget explizit zu steuern.

  2. 02 · Ländergefilterte Paare

    Der Query-Parameter `countries` ist die maßgebliche Quelle für handelbare Paare

    Ripio erstreckt sich über 8 Jurisdiktionen (AR, BR, MX, ES, UY, CO, CL, US) mit länderspezifischen Compliance-Stufen. Die Verfügbarkeit von Handelspaaren wird über den Query-Parameter `countries` gefiltert, anstatt über eine einfache globale Symbolliste. Ein Paar, das in Brasilien gehandelt wird, ist in Argentinien möglicherweise nicht verfügbar und umgekehrt. Strategien mit einer fest codierten Symbolliste für den brasilianischen Markt führen bei einem argentinischen Konto unbemerkt zu Fehlern (No-op). Rufen Sie die Paare beim Start über den ländergefilterten Endpunkt ab, anstatt sie fest im Code zu verankern.

  3. 03 · Paar-Codes nutzen Unterstrich

    BTC_BRL und ETH_BRL, nicht BTCBRL

    Ripio-Paar-Codes nutzen die Unterstrich-Notation: BTC_BRL, ETH_BRL, BTC_ARS, BTC_MXN, BTC_EUR. Diese Konvention unterscheidet sich von Binance und den meisten globalen Handelsplätzen, bei denen die Paare zusammengeschrieben werden (BTCBRL). CCXT normalisiert das Symbol in seiner einheitlichen Schnittstelle zu BTC/BRL, aber jeder direkte Zugriff auf die native API muss das Unterstrich-Format nutzen. Strategie-Code, der von einer anderen Plattform portiert wird, schlägt oft unbemerkt mit einem "Pair-not-found"-Fehler fehl, bis das Format korrigiert wird.

  4. 04 · Mindestwerte je Paar

    `min_amount`, `min_value` und `price_tick` sind paarspezifisch und müssen abgefragt werden

    Mindestgrößen und Price Ticks sind spezifisch für das jeweilige Fiat-Paar. BRL-Paare, ARS-Paare und MXN-Paare haben jeweils eigene Werte für `min_amount`, `min_value` und `price_tick`, die vor der Orderplatzierung für jedes Paar abgefragt werden müssen. Eine Strategie, die einen einzigen fest codierten Mindestwert für BRL- und ARS-Paare nutzt, führt je nach aktivem Land unbemerkt zu kleinen oder zu großen Trades. Zwischenspeichern Sie die paarspezifischen Felder beim Start und validieren Sie diese vor jeder Order neu, anstatt von einem globalen Minimum auszugehen.

  5. 05 · WebSocket-Ticket-Authentifizierung

    Sensible WebSocket-Topics erfordern ein Ticket von POST `/v4/ticket`

    Öffentliche WebSocket-Topics (Marktdaten, Orderbuch) sind frei zugänglich. Sensible Topics (Kontostatus, Order-Ereignisse) erfordern vor dem Abonnieren ein Ticket, das über POST `/v4/ticket` abgerufen wird – ein API-Key allein reicht nicht aus. Das Ticket hat eine kurze Gültigkeitsdauer (TTL) und muss bei dauerhaft laufenden Strategien regelmäßig erneuert werden. Container, die die WebSocket-Verbindung verlieren und sich neu verbinden, müssen jedes Mal ein neues Ticket anfordern. Die Wiederverwendung eines abgelaufenen Tickets führt dazu, dass das Abonnement unbemerkt fehlschlägt und keine Callbacks zum Orderstatus mehr ausgelöst werden.

  6. 06 · Lokale Stablecoins

    wARS, wBRL und wMXN ermöglichen direkte Transaktionen mit digitalen Währungen

    Ripio gibt die lokalen Stablecoins wARS, wBRL und wMXN heraus, die direkte Transaktionen mit digitalen Währungen in den Märkten BRL, ARS und MXN ermöglichen. Diese unterscheiden sich von USDT/USDC und können andere Liquiditäts-, Abwicklungs- und Gebührenstrukturen aufweisen. Strategien, die für USDT optimiert sind, lassen sich nicht eins zu eins auf wARS oder wBRL übertragen. Validieren Sie die Markttiefe und den Spread der lokalen Stablecoin-Paare separat, bevor Sie das Live-Risiko bestimmen.

Sektion 06 · Entwickelt für

Entwickelt für

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

  • Entwickler, die Strategien in KI-IDEs (Cursor, Claude Code) erstellen
  • Systematische Krypto-Trader
  • Quant-Entwickler
  • CCXT-Nutzer
  • Teams, die vom 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 Ripio.

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

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

Nein. TradingHost ist die Cloud-Runtime, auf der Ihr Strategie-Code ausgeführt wird. Wir bieten keine Signale, KI-Vorhersagemodelle oder vorgefertigten Bots an. Mit TradingHost schreiben oder generieren Sie die Strategie selbst (oft mit Cursor oder Claude Code), verwalten sie als Ihren eigenen Code in GitHub und nutzen TradingHost, um sie in der Live-Umgebung auszuführen. Produkte wie 3Commas oder Cryptohopper stellen die Strategielogik bereit; TradingHost führt Ihre eigene Strategie aus.

AWS und DigitalOcean bieten Ihnen reine Rechenleistung. Sie müssen sich selbst um Betriebssystem-Updates, Container-Orchestrierung, Log-Weiterleitung, Secret-Rotation, Regionen-Failover und Uptime-Monitoring kümmern. TradingHost bietet Ihnen eine verwaltete Runtime, die speziell für Trading-Strategien entwickelt wurde: GitHub-natives Deployment, MCP-gestützte Steuerung aus KI-IDEs sowie direkt einsatzbereite Log- und Health-Schnittstellen. 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 bietet eine einheitliche `ripio`-Klasse, die den Spot-Handel auf Ripio Trade-Paaren abdeckt. Laden Sie Ihre CCXT-Strategie in einen Container, verknüpfen Sie ihn mit GitHub, und TradingHost führt sie wie jedes andere Python- oder Node-Projekt aus. Siehe die CCXT-Framework-Runtime für den vollständigen Einrichtungsprozess.

Ja. Die LATAM-Fiat-Paare von Ripio (BTC_BRL, ETH_BRL, BTC_ARS, BTC_MXN, BTC_EUR und andere) werden über dieselben REST- und WebSocket-APIs wie die globalen Paare erreicht. Der Strategie-Code in Ihrem Container authentifiziert sich mit Ihrem Ripio Trade API-Key. TradingHost verhält sich auf Runtime-Ebene neutral gegenüber dem Handelsplatz. Beachten Sie, dass die Verfügbarkeit von Paaren über den Query-Parameter `countries` ländergefiltert ist. Rufen Sie die Paare daher beim Start ab, anstatt sie fest zu codieren.

Ja, sofern Ihr Projekt so konzipiert ist. Sie können mehrere Strategieprozesse oder -dienste innerhalb einer Runtime ausführen oder sie zur Isolation und besseren Übersicht auf verschiedene Runtimes aufteilen. Details zum Multi-Strategie-Modell finden Sie auf der TradingHost-Runtime-Seite.

Der schnellste Weg ist das Forken einer TradingHost-Framework-Runtime: CCXT für ein sofort einsatzbereites Projekt. Alternativ können Sie Ihr eigenes GitHub-Strategie-Repository verbinden. Das Verknüpfen eines GitHub-Repositorys und das Erstellen einer Strategie ist kostenlos. Die Runtime-Tarife finden Sie auf der Preisseite.

In Ihrem von GitHub gesteuerten Secrets-Workflow. TradingHost liest diese zur Laufzeit über GitHub-Repository-Secrets, Environment-Secrets oder Ihren eigenen freigegebenen Secret-Management-Prozess aus. TradingHost benötigt keinen Zugriff auf Ihren API-Key und Ihr Secret. Details zur Handhabung finden Sie unter Plattform-Secrets.

Nein. Strategien sollten niemals Auszahlungsberechtigungen benötigen. Beschränken Sie Ihren API-Key ausschließlich auf das Trading und das Lesen des Kontostatus, und deaktivieren Sie Auszahlungen für diesen Key vollständig.

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 als Steuerungs- und Observability-Schnittstelle, nicht als Pfad für die Trade-Ausführung. Details finden Sie unter MCP-Steuerungsschnittstelle.

Beides. Die MCP-Steuerungsschnittstelle funktioniert gleichermaßen über CLI-basierte Agenten (Claude Code CLI, benutzerdefinierte MCP-Clients, geskriptete MCP-Aufrufe) wie auch direkt aus einer IDE heraus. Der GitHub-native Deployment-Prozess funktioniert zudem völlig ohne KI-Tools: Ein normaler Git-Push auf Ihren Main-Branch löst ein erneutes Deployment aus.

Die Runtime erkennt den Absturz und stellt die relevanten Logs und Health-Informationen bereit. Sofern unterstützt, kann die betroffene Strategie neu gestartet werden, ohne andere im selben Container laufende Strategien zu beeinträchtigen. Ihr Strategie-Code bleibt weiterhin für eine sichere Fehlerbehandlung, den Schutz vor doppelten Orders und Risikokontrollen verantwortlich. Details finden Sie unter Observability für Logs und Health-Schnittstellen.

Die Ratenbegrenzungen der Ripio Trade API v4 sind nach dem KYC-Status gestaffelt. Nicht verifizierte Konten erhalten 1 Anfrage pro Sekunde; verifizierte Konten erhalten 3,5 Anfragen pro Sekunde. Bei Überschreitung des Limits wird HTTP 429 zurückgegeben. Die Lösung besteht darin, Ihre Anfragenfrequenz auf die Stufe abzustimmen, in der sich Ihr Konto aktuell befindet, die Stufe als Runtime-Konfiguration statt als Konstante zu behandeln und bei HTTP 429 mit exponentiellem Jitter zu pausieren (Backoff). Die vollständige Anleitung finden Sie oben im Abschnitt „Betriebshinweise“.

TradingHost wird in den Regionen EU und US-East betrieben. Wählen Sie die Region, die der Matching-Engine Ihrer Strategie am nächsten liegt. Details zu Routing und Nähe finden Sie auf der Regionen-Seite.

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