Kontrakte & Symbole mit der Tradovate-API finden
Bevor Ihr Code ein Quote abrufen oder eine Order auslösen kann, muss er den genauen Kontrakt benennen, den Tradovate erwartet. So lösen Sie Symbole und Kontrakt-IDs mit product/find und contract/find auf, Schritt für Schritt.
On This Page
Bevor Ihr Code ein Quote abrufen oder eine Order auslösen kann, muss er den genauen Kontrakt benennen, den Tradovate erwartet. Wenn Sie einen Trading-Bot bauen, eine numerische Kontrakt-ID wieder einem lesbaren Ticker zuordnen oder Automatisierung wie PickMyTrade einrichten, beginnt hier Ihr Weg. Unten lösen Sie Symbole und Kontrakt-IDs mit den Endpunkten product/find und contract/find auf, Schritt für Schritt.
Was sind Produkte, Kontrakte und Symbole in der Tradovate-API?
Tradovate gliedert die Futures-Welt in eine kleine dreistufige Hierarchie, und sobald Sie sie verstanden haben, wird der Rest der API deutlich einfacher.
Ein Produkt ist die Instrumentenfamilie, „ES“ oder „MES“, ohne Verfallsdatum. Ein Kontrakt ist eine bestimmte Fälligkeit dieses Produkts, geschrieben als Symbol wie MESU5, das ist das, was Sie tatsächlich handeln. Und jeder Kontrakt trägt eine numerische Kontrakt-ID, die die API in Positionen, Orders und Fills zurückgibt. Die Symbolsuche bewegt sich lediglich zwischen diesen dreien: ein Produkt benennen, seine aktuellen Kontrakte erhalten und eine ID in etwas übersetzen, das ein Mensch lesen kann.
Kontrakte & Symbole über die Tradovate-API finden: Schritt für Schritt
Authentifizieren und ein Access-Token erhalten
Jede Abfrage ist eine authentifizierte HTTPS-Anfrage, besorgen Sie sich daher zuerst ein Bearer-Token. Senden Sie Ihre Zugangsdaten und App-Details per POST an /auth/accessTokenRequest; die Antwort enthält ein accessToken, das Sie bei jedem weiteren Aufruf in einem Authorization: Bearer-Header mitsenden. Schicken Sie es an den passenden Host, demo.tradovateapi.com/v1 für die Simulationsumgebung oder live.tradovateapi.com/v1, wenn echtes Geld im Spiel ist.
Das Produkt mit product/find nachschlagen
Lösen Sie zuerst die Instrumentenfamilie auf. Rufen Sie GET /product/find?name=MES mit Ihrem Token auf, und Tradovate liefert das Produktobjekt zurück, seine numerische id, seinen name und den Produkttyp. Merken Sie sich die Produkt-id, denn mit ihr zählen Sie alle Kontrakte des Instruments auf. Es gibt keinen öffentlichen Endpunkt „alle Symbole auflisten“, Sie beginnen also immer mit einer Wurzel, die Sie bereits kennen, ES, NQ, CL, und fragen von dort aus nach außen ab.
Den aktiven Kontrakt mit contract/find oder contract/suggest auflösen
Jetzt machen Sie aus diesem Produkt etwas Handelbares. GET /contract/suggest?t=MES liefert passende Kontrakte, sortiert mit der besten Fälligkeit zuerst, Index 0 ist in der Regel der Frontmonat. GET /contract/find?name=MESU5 löst einen exakten Symbol-String zum vollständigen Kontraktobjekt auf, einschließlich der numerischen Kontrakt-id, die Sie an Order- und Marktdaten-Aufrufe übergeben. Ein Stolperstein, den Sie sich einprägen sollten: Fortlaufende Chart-Ticker wie @MES sind für das Charting in Ordnung, aber Sie können sie nicht handeln. Sie brauchen das datierte Kontraktsymbol, das dieser Schritt liefert.
Eine ID umkehren oder den Verfall mit contract/item und contractMaturity bestätigen
Manchmal gehen Sie in die andere Richtung: Sie haben eine Kontrakt-id aus einer Position oder Order und benötigen den Ticker. Rufen Sie GET /contract/item?id=<id> auf, um name, productId und contractMaturityId des Kontrakts zu erhalten. Möchten Sie wissen, wie nah er am Verfall ist? Übergeben Sie diese contractMaturityId an GET /contractMaturity/item?id=<id> und lesen Sie das expirationDate. Den Roll anhand der Tage bis zum Verfall zu steuern ist besser, als sich nahe dem Roll auf ein einzelnes „Front“-Flag zu verlassen, das unter Ihnen umspringen kann.
So lesen Sie ein Tradovate-Futures-Symbol
Ein datiertes Futures-Symbol besteht aus drei Teilen, die ohne Leerzeichen aneinandergehängt sind: Instrument + Monatscode + letzte Ziffer des Jahres. MESU5 ist also MES (Micro E-mini S&P 500) + U (September) + 5 (2025). Die Monatscodes ändern sich von Jahr zu Jahr nicht, es lohnt sich also, sie einmal auswendig zu lernen:
| Code | Monat | Code | Monat |
|---|---|---|---|
| F | Januar | N | Juli |
| G | Februar | Q | August |
| H | März | U | September |
| J | April | V | Oktober |
| K | Mai | X | November |
| M | Juni | Z | Dezember |
Wofür Sie das brauchen
- Orders platzieren, jede Order braucht ein gültiges, nicht abgelaufenes Kontraktsymbol oder eine ID, die vor dem Senden aufgelöst wurde.
- Marktdaten abonnieren, Quote- und Chart-Abonnements beziehen sich auf den exakten Kontrakt.
- Positionen und Fills lesen, die API liefert numerische IDs, die Sie für Logs und Dashboards wieder auf Ticker abbilden.
- Rollovers automatisieren, den Frontmonat erkennen und auf den nächsten Kontrakt rollen, wenn der Verfall näher rückt.
Automatisieren Sie das mit PickMyTrade
Haben Sie keine Lust, product/find, contract/find, Kontrakt-IDs und Rollover-Logik selbst zu jonglieren? PickMyTrade verknüpft Ihre TradingView-Alerts direkt mit Ihrem Tradovate-Konto und löst den richtigen aktuellen Kontrakt für Sie auf, sodass Orders automatisch auf dem richtigen Symbol ausgelöst werden, ohne dass Sie eine einzige Zeile API-Code schreiben müssen.
Verzichten Sie auf Symbol-Abfragen
Lassen Sie PickMyTrade den richtigen aktuellen Kontrakt für Sie auflösen, Orders werden automatisch auf dem richtigen Symbol ausgelöst, ganz ohne API-Code.
Starten Sie Ihre kostenlose 7-Tage-TestphaseHäufig gestellte Fragen
Nein, es gibt keinen unterstützten „Alle Symbole auflisten“-Aufruf. Beginnen Sie mit einer bekannten Produktwurzel wie ES, MES, NQ oder CL, fragen Sie product/find und anschließend contract/find oder contract/suggest ab und cachen Sie die Ergebnisse, die Ihre App tatsächlich braucht.
Rufen Sie contract/item?id=<id> auf. Die Antwort enthält den Kontraktnamen (das ist Ihr Ticker) sowie dessen productId und contractMaturityId für weitere Abfragen.
Fortlaufende und indexartige Ticker sind nur für das Charting gedacht. Um eine Order zu platzieren, benötigen Sie das datierte Kontraktsymbol, zum Beispiel MESU5, oder dessen Kontrakt-ID aus contract/find.
Dieser Leitfaden dient ausschließlich Bildungs- und Informationszwecken und stellt keine Finanz-, Anlage- oder Handelsberatung dar. Der Handel mit Futures und anderen gehebelten Produkten birgt ein erhebliches Verlustrisiko und ist nicht für jeden Anleger geeignet. PickMyTrade ist eine unabhängige Automatisierungsplattform eines Drittanbieters und steht in keiner Verbindung zu Tradovate, Inc., wird weder von dieser unterstützt noch gesponsert. „Tradovate“ und alle zugehörigen Namen, Logos und Marken sind Eigentum ihrer jeweiligen Inhaber. Funktionen und Schritte der Plattform ändern sich im Laufe der Zeit; bestätigen Sie daher stets den aktuellen Ablauf in der offiziellen Tradovate-Plattform und -Dokumentation, bevor Sie handeln.