Trovare contratti e simboli con l’API di Tradovate
Prima che il Suo codice possa recuperare una quotazione o inviare un ordine, deve indicare il contratto esatto che Tradovate si aspetta. Ecco come risolvere simboli e ID dei contratti con product/find e contract/find, passo dopo passo.
On This Page
Prima che il Suo codice possa recuperare una quotazione o inviare un ordine, deve indicare il contratto esatto che Tradovate si aspetta. Se sta costruendo un bot di trading, riconducendo un ID contratto numerico a un ticker leggibile o configurando un’automazione come PickMyTrade, è da qui che si parte. Di seguito risolverà simboli e ID dei contratti con gli endpoint product/find e contract/find, passo dopo passo.
Che cosa sono prodotti, contratti e simboli nell’API di Tradovate?
Tradovate suddivide il mondo dei futures in una piccola gerarchia a tre livelli e, una volta compresa, il resto dell’API diventa molto più semplice.
Un prodotto è la famiglia dello strumento, «ES» o «MES», senza scadenza associata. Un contratto è una specifica scadenza di quel prodotto, scritta come un simbolo come MESU5, ed è ciò che si negozia davvero. E ogni contratto porta un ID contratto numerico, che è ciò che l’API restituisce in posizioni, ordini e fill. La ricerca dei simboli consiste semplicemente nello spostarsi tra questi tre elementi: indicare un prodotto, ottenere i suoi contratti live e tradurre un ID in qualcosa che una persona possa leggere.
Trovare contratti e simboli tramite l’API di Tradovate: passo dopo passo
Si autentichi e ottenga un token di accesso
Ogni ricerca è una richiesta HTTPS autenticata, quindi ottenga prima un token bearer. Invii in POST le Sue credenziali e i dettagli dell’app a /auth/accessTokenRequest; la risposta contiene un accessToken che allega a ogni chiamata successiva in un header Authorization: Bearer. Lo invii all’host corrispondente, demo.tradovateapi.com/v1 per l’ambiente di simulazione o live.tradovateapi.com/v1 quando è in gioco denaro reale.
Cerchi il prodotto con product/find
Risolva prima la famiglia dello strumento. Chiami GET /product/find?name=MES con il Suo token e Tradovate restituisce l’oggetto prodotto, il suo id numerico, il suo name e il tipo di prodotto. Conservi l’id del prodotto, perché è la chiave che riutilizzerà per enumerare tutti i contratti dello strumento. Non esiste un endpoint pubblico per «elencare tutti i simboli», quindi parte sempre da una radice che già conosce, ES, NQ, CL, e interroga verso l’esterno da lì.
Risolva il contratto attivo con contract/find o contract/suggest
Ora trasformi quel prodotto in qualcosa di negoziabile. GET /contract/suggest?t=MES restituisce i contratti corrispondenti ordinati con la scadenza migliore per prima; l’indice 0 è di solito il mese front. GET /contract/find?name=MESU5 risolve una stringa di simbolo esatta nell’oggetto contratto completo, incluso l’id numerico del contratto che passerà alle chiamate di ordini e dati di mercato. Un’insidia da imprimersi bene in mente: i ticker continui dei grafici come @MES vanno bene per i grafici, ma non si possono negoziare. Le serve il simbolo del contratto con scadenza che questo passaggio fornisce.
Inverta un ID o confermi la scadenza con contract/item e contractMaturity
A volte procede nella direzione opposta: ha l’id di un contratto da una posizione o da un ordine e Le serve il ticker. Chiami GET /contract/item?id=<id> per ottenere il name, il productId e il contractMaturityId del contratto. Vuole sapere quanto manca alla scadenza? Passi quel contractMaturityId a GET /contractMaturity/item?id=<id> e legga l’expirationDate. Eseguire il roll in base ai giorni alla scadenza è meglio che fidarsi di un singolo flag «front» in prossimità del roll, quando quel flag può cambiare all’improvviso.
Come leggere un simbolo di futures Tradovate
Un simbolo di futures con scadenza è composto da tre parti unite senza spazi: strumento + codice del mese + ultima cifra dell’anno. Quindi MESU5 è MES (Micro E-mini S&P 500) + U (settembre) + 5 (2025). I codici dei mesi non cambiano da un anno all’altro, quindi vale la pena memorizzarli una volta per tutte:
| Codice | Mese | Codice | Mese |
|---|---|---|---|
| F | Gennaio | N | Luglio |
| G | Febbraio | Q | Agosto |
| H | Marzo | U | Settembre |
| J | Aprile | V | Ottobre |
| K | Maggio | X | Novembre |
| M | Giugno | Z | Dicembre |
Perché Le serve
- Inserire ordini, ogni ordine richiede un simbolo o un ID di contratto valido e non scaduto, risolto prima dell’invio.
- Sottoscrivere i dati di mercato, le sottoscrizioni di quotazioni e grafici si basano sul contratto esatto.
- Leggere posizioni e fill, l’API restituisce ID numerici e Lei li riconduce ai ticker per log e dashboard.
- Automatizzare i rollover, rilevi il mese front e passi al contratto successivo man mano che la scadenza si avvicina.
Automatizzi tutto con PickMyTrade
Non ha voglia di destreggiarsi da solo tra product/find, contract/find, ID dei contratti e logica di rollover? PickMyTrade collega i Suoi alert di TradingView direttamente al Suo conto Tradovate e risolve per Lei il contratto live corretto, così gli ordini partono automaticamente sul simbolo giusto, senza che Lei scriva una sola riga di codice API.
Eviti le ricerche dei simboli
Lasci che PickMyTrade risolva per Lei il contratto live corretto: gli ordini partono automaticamente sul simbolo giusto, senza alcun codice API.
Inizi la prova gratuita di 7 giorniDomande frequenti
No, non esiste una chiamata supportata per «elencare tutti i simboli». Parta da una radice di prodotto nota come ES, MES, NQ o CL, interroghi product/find e poi contract/find o contract/suggest, e memorizzi nella cache i risultati di cui la Sua app ha davvero bisogno.
Chiami contract/item?id=<id>. La risposta include il nome del contratto (cioè il Suo ticker), oltre a productId e contractMaturityId per le ricerche successive.
I ticker continui e di tipo indice servono solo per i grafici. Per inserire un ordine Le serve il simbolo del contratto con scadenza, per esempio MESU5, oppure il suo ID contratto da contract/find.
Questa guida ha scopo esclusivamente educativo e informativo e non costituisce consulenza finanziaria, di investimento o di trading. Il trading di futures e di altri prodotti a leva comporta un rischio sostanziale di perdita e non è adatto a tutti gli investitori. PickMyTrade è una piattaforma di automazione indipendente di terze parti e non è affiliata a Tradovate, Inc., né approvata o sponsorizzata da essa. «Tradovate» e tutti i nomi, loghi e marchi correlati sono di proprietà dei rispettivi titolari. Le funzionalità e i passaggi della piattaforma cambiano nel tempo, quindi verifichi sempre la procedura attuale nella piattaforma e nella documentazione ufficiali di Tradovate prima di agire.