Encuentre contratos y símbolos con la API de Tradovate
Antes de que su código pueda obtener una cotización o lanzar una orden, tiene que nombrar el contrato exacto que Tradovate espera. Así se resuelven símbolos e ID de contrato con product/find y contract/find, paso a paso.
On This Page
Antes de que su código pueda obtener una cotización o lanzar una orden, tiene que nombrar el contrato exacto que Tradovate espera. Si está creando un bot de trading, asociando un ID de contrato numérico con un ticker legible o configurando automatización como PickMyTrade, aquí es donde empieza todo. A continuación resolverá símbolos e ID de contrato con los endpoints product/find y contract/find, paso a paso.
¿Qué son los productos, contratos y símbolos en la API de Tradovate?
Tradovate divide el mundo de los futuros en una pequeña jerarquía de tres niveles, y una vez que se entiende, el resto de la API resulta mucho más sencillo.
Un producto es la familia del instrumento, «ES» o «MES», sin vencimiento asociado. Un contrato es un vencimiento concreto de ese producto, escrito como un símbolo como MESU5, que es lo que realmente se opera. Y cada contrato lleva un ID de contrato numérico, que es lo que la API devuelve en posiciones, órdenes y fills. La búsqueda de símbolos consiste simplemente en moverse entre esos tres elementos: nombrar un producto, obtener sus contratos vigentes y traducir un ID a algo que una persona pueda leer.
Encuentre contratos y símbolos con la API de Tradovate: paso a paso
Autentíquese y obtenga un token de acceso
Cada consulta es una solicitud HTTPS autenticada, así que obtenga primero un token bearer. Haga POST con sus credenciales y los datos de su aplicación a /auth/accessTokenRequest; la respuesta incluye un accessToken que debe adjuntar a cada llamada posterior en una cabecera Authorization: Bearer. Envíelo al host correspondiente, demo.tradovateapi.com/v1 para el entorno de simulación o live.tradovateapi.com/v1 cuando hay dinero real en juego.
Busque el producto con product/find
Resuelva primero la familia del instrumento. Llame a GET /product/find?name=MES con su token y Tradovate devuelve el objeto de producto, su id numérico, su name y el tipo de producto. Conserve el id del producto, porque es la clave que reutilizará para enumerar todos los contratos del instrumento. No existe un endpoint público para «listar todos los símbolos», así que siempre parte de una raíz que ya conoce, ES, NQ, CL, y consulta hacia afuera desde ahí.
Resuelva el contrato activo con contract/find o contract/suggest
Ahora convierta ese producto en algo operable. GET /contract/suggest?t=MES devuelve los contratos coincidentes ordenados con el mejor vencimiento primero; el índice 0 suele ser el mes frontal. GET /contract/find?name=MESU5 resuelve una cadena de símbolo exacta al objeto de contrato completo, incluido el id numérico del contrato que pasará a las llamadas de órdenes y de datos de mercado. Un detalle que conviene grabarse: los tickers continuos de gráfico como @MES sirven para graficar, pero no se pueden operar. Necesita el símbolo del contrato con fecha que le da este paso.
Invierta un ID o confirme el vencimiento con contract/item y contractMaturity
A veces va en la dirección contraria: tiene un id de contrato de una posición o una orden y necesita el ticker. Llame a GET /contract/item?id=<id> para obtener el name, el productId y el contractMaturityId del contrato. ¿Quiere saber lo cerca que está de vencer? Pase ese contractMaturityId a GET /contractMaturity/item?id=<id> y lea el expirationDate. Hacer el roll según los días hasta el vencimiento es mejor que fiarse de un único indicador «front» cerca del roll, cuando ese indicador puede cambiar de un momento a otro.
Cómo leer un símbolo de futuros de Tradovate
Un símbolo de futuros con fecha son tres partes pegadas sin espacios: instrumento + código de mes + último dígito del año. Así, MESU5 es MES (Micro E-mini S&P 500) + U (septiembre) + 5 (2025). Los códigos de mes no cambian de un año a otro, así que conviene memorizarlos una vez:
| Código | Mes | Código | Mes |
|---|---|---|---|
| F | Enero | N | Julio |
| G | Febrero | Q | Agosto |
| H | Marzo | U | Septiembre |
| J | Abril | V | Octubre |
| K | Mayo | X | Noviembre |
| M | Junio | Z | Diciembre |
Por qué lo necesitaría
- Colocar órdenes, cada orden necesita un símbolo o ID de contrato válido y no vencido, resuelto antes de enviarla.
- Suscribirse a datos de mercado, las suscripciones de cotizaciones y gráficos dependen del contrato exacto.
- Leer posiciones y fills, la API le entrega ID numéricos, y usted los asocia de nuevo a tickers para registros y paneles.
- Automatizar rollovers, detecte el mes frontal y haga el roll al siguiente contrato a medida que se acerca el vencimiento.
Automatice esto con PickMyTrade
¿No quiere malabarear con product/find, contract/find, ID de contrato y lógica de rollover por su cuenta? PickMyTrade enlaza sus alertas de TradingView directamente con su cuenta de Tradovate y resuelve por usted el contrato vigente correcto, de modo que las órdenes se ejecutan automáticamente en el símbolo adecuado, sin que escriba una sola línea de código de API.
Olvídese de las búsquedas de símbolos
Deje que PickMyTrade resuelva por usted el contrato vigente correcto: las órdenes se ejecutan automáticamente en el símbolo adecuado, sin necesidad de código de API.
Comience su prueba gratuita de 7 díasPreguntas frecuentes
No, no hay una llamada compatible de «listar todos los símbolos». Parta de una raíz de producto conocida como ES, MES, NQ o CL, consulte product/find y después contract/find o contract/suggest, y almacene en caché los resultados que su aplicación realmente necesite.
Llame a contract/item?id=<id>. La respuesta incluye el nombre del contrato (que es su ticker), además de su productId y contractMaturityId para consultas posteriores.
Los tickers continuos y de tipo índice son solo para gráficos. Para colocar una orden necesita el símbolo del contrato con fecha, por ejemplo MESU5, o su ID de contrato de contract/find.
Esta guía tiene fines exclusivamente educativos e informativos y no constituye asesoramiento financiero, de inversión ni de trading. Operar con futuros y otros productos apalancados conlleva un riesgo sustancial de pérdida y no es adecuado para todos los inversores. PickMyTrade es una plataforma de automatización independiente de terceros y no está afiliada, respaldada ni patrocinada por Tradovate, Inc. «Tradovate» y todos los nombres, logotipos y marcas relacionados son propiedad de sus respectivos titulares. Las funciones y los pasos de la plataforma cambian con el tiempo, por lo que debe confirmar siempre el proceso actual en la plataforma y la documentación oficiales de Tradovate antes de actuar.