Skip to main content
GET
Devuelve las velas diarias de un contrato de dólar futuro de A3: apertura, máximo, mínimo, cierre y volumen por día. Es la serie del gráfico de evolución de precio de la ficha del contrato. También responde contratos vencidos, que ya no aparecen en /futures/instruments. En un contrato vigente, la última vela es la rueda en curso. Requiere el scope futures:read.

Parámetros de ruta

string
required
Ticker exacto del contrato, con la barra (DLR/NOV26) o URL-encodeado (DLR%2FNOV26). No se normalizan mayúsculas: dlr/nov26 da 404. Solo se aceptan tickers que cumplen ^DLR/[A-Z]{3}\d{2}$.

Parámetros de consulta

string
default:"1 year"
Intervalo de fechas, mutuamente excluyente con date_from/date_to. Ejemplos: 1 week, 1 month, 3 months, ytd, 1 year, max (también se aceptan los alias cortos 1W, 1M, 3M, YTD, 1Y).
string
Fecha de inicio en formato YYYY-MM-DD. Mutuamente excluyente con interval.
string
Fecha de fin en formato YYYY-MM-DD. Requiere date_from y es mutuamente excluyente con interval.
Enviá interval o date_from/date_to, nunca ambos. Si mandás los dos, la API responde 422. También da 422 mandar date_to sin date_from (“Must provide ‘interval’ or ‘date_from’”). Sin ninguno, devuelve el último año.

Ejemplo de Solicitud

Respuesta Exitosa

string
Ticker del contrato.
string[]
Nombres de columna, siempre los mismos seis y en este orden: date, opening_price, high_price, low_price, closing_price, trade_volume.
array
Una fila por día, con los valores en el orden de columns. date va en YYYY-MM-DD, los precios en ARS y trade_volume en contratos operados. Si una vela no trae un valor, ese lugar va en null. Las filas más viejas pueden traer solo el cierre, con apertura, máximo, mínimo y volumen en null (ej., ["2026-09-29", null, null, null, 1576.5, null]). trade_volume puede venir como float (142615.0).
Para graficar la evolución del precio, usá date en el eje X y closing_price en el eje Y. Con opening_price, high_price y low_price armás velas.

Ejemplo de Respuesta Exitosa

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

ticker
string
required

Ticker exacto del contrato, con la barra (DLR/NOV26) o URL-encodeado (DLR%2FNOV26). No se normalizan mayúsculas: dlr/nov26 da 404.

Pattern: ^DLR/[A-Z]{3}\d{2}$
Example:

"DLR/NOV26"

Query Parameters

interval
string
default:1 year

Intervalo de fechas, mutuamente excluyente con date_from/date_to. Ejemplos: '1 week', '1 month', '3 months', 'ytd', '1 year', 'max' (también se aceptan los alias cortos 1W, 1M, 3M, YTD, 1Y).

date_from
string

Fecha de inicio YYYY-MM-DD. Mutuamente excluyente con interval.

Pattern: ^\d{4}-\d{2}-\d{2}$
date_to
string

Fecha de fin YYYY-MM-DD. Requiere date_from y es mutuamente excluyente con interval.

Pattern: ^\d{4}-\d{2}-\d{2}$

Response

Velas diarias del contrato

ticker
string
required

Ticker del contrato.

columns
enum<string>[]
required

Nombres de columna, siempre en este orden.

Available options:
date,
opening_price,
high_price,
low_price,
closing_price,
trade_volume
rows
((string | number | null)[])[]
required

Una fila por día: [date, opening_price, high_price, low_price, closing_price, trade_volume]. Un valor que la vela no trae va en null.