get
https://example.com/api/prices/market-instruments-prices
Obtiene un listado paginado de precios en tiempo real de instrumentos de mercado.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Listá los precios en tiempo real de los instrumentos de mercado disponibles.
Antes de empezar
- Usá este endpoint cuando necesites consultar el universo completo de precios de instrumentos de mercado.
- Agregá
pageysizesi querés paginar el resultado. - Si necesitás consultar un instrumento puntual, usá
GET /api/prices/market-instruments-prices/{market_instrument_id}. - Si necesitás consultar varios instrumentos específicos, usá
PUT /api/prices/market-instruments-prices-list.
Cómo listar precios de instrumentos de mercado
GET /api/prices/market-instruments-pricesConsultar con paginación
GET /api/prices/market-instruments-prices?page=1&size=50Query parameters
| Parámetro | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
page | integer | No | 1 | Número de página que querés consultar. |
size | integer | No | 50 | Cantidad de instrumentos por página. |
Qué devuelve este endpoint
La respuesta devuelve un objeto paginado con:
items: lista de instrumentos con precios en tiempo realtotal: cantidad total de registros disponiblespage: página actualsize: cantidad de elementos por página
Cada elemento dentro de items incluye:
| Campo | Tipo | Descripción |
|---|---|---|
market_instrument_id | integer | Código identificador del instrumento en el mercado. |
ticker | string | Abreviatura para identificar el instrumento en el mercado. |
market_id | string | Identificador del mercado en el que se negocia el instrumento. |
settlement_0 | object | Precios para contado inmediato. |
settlement_1 | object | Precios para operaciones a 24 horas. Puede ser null si no hay precios para ese plazo. |
settlement_2 | object | Precios para operaciones a 48 horas. Puede ser null si no hay precios para ese plazo. |
updated_at | string | Fecha y hora de la última actualización. |
Estructura de cada objeto settlement
settlementDentro de cada settlement, la respuesta puede incluir:
| Campo | Tipo | Descripción |
|---|---|---|
prices | object | Información de precios de oferta y demanda. |
high_price | number | Precio más alto registrado durante el período de negociación. |
last_price | number | Precio de la última transacción realizada. |
last_trade_date | string | Fecha y hora de la última transacción. |
nominal_value | integer | Valor nominal del instrumento. |
low_price | number | Precio más bajo registrado durante el período de negociación. |
open_price | number | Precio de apertura del instrumento. |
prev_close_price | number | Precio de cierre del período anterior. |
effective_volume | number | Volumen efectivo operado. |
actual_close_price | number | Precio de cierre actual del período. |
day_percentage_change | number | Variación porcentual del día. |
day_price_change | number | Variación absoluta del día. |
Estructura de prices
prices| Campo | Tipo | Descripción |
|---|---|---|
ask | array de objetos | Lista de precios de oferta. |
bid | array de objetos | Lista de precios de demanda. |
Cada elemento de ask o bid puede incluir:
| Campo | Tipo | Descripción |
|---|---|---|
price | number | Precio informado en la punta. |
size | number | Cantidad o volumen asociado a esa punta. |
Respuesta esperada
{
"items": [
{
"market_instrument_id": 123,
"ticker": "AL30",
"market_id": "ROFX",
"settlement_0": {
"prices": {
"ask": [
{
"price": 642.5,
"size": 100
}
],
"bid": [
{
"price": 642.3,
"size": 80
}
]
},
"high_price": 650,
"last_price": 642.36,
"last_trade_date": "2026-04-22T15:30:00Z",
"nominal_value": 1,
"low_price": 635,
"open_price": 638,
"prev_close_price": 640,
"effective_volume": 150000,
"actual_close_price": 642.36,
"day_percentage_change": 0.37,
"day_price_change": 2.36
},
"settlement_1": null,
"settlement_2": null,
"updated_at": "2026-04-22T15:31:00Z"
},
{
"market_instrument_id": 124,
"ticker": "GD30",
"market_id": "ROFX",
"settlement_0": {
"prices": {
"ask": [
{
"price": 710.2,
"size": 50
}
],
"bid": [
{
"price": 709.8,
"size": 40
}
]
},
"high_price": 715,
"last_price": 710,
"last_trade_date": "2026-04-22T15:29:00Z",
"nominal_value": 1,
"low_price": 700,
"open_price": 705,
"prev_close_price": 708,
"effective_volume": 120000,
"actual_close_price": 710,
"day_percentage_change": 0.28,
"day_price_change": 2
},
"settlement_1": null,
"settlement_2": null,
"updated_at": "2026-04-22T15:31:00Z"
}
],
"total": 2,
"page": 1,
"size": 50
}Cuándo usar este endpoint
Este endpoint es útil cuando necesitás:
- obtener el listado completo de precios de instrumentos de mercado
- construir tableros o catálogos con precios en tiempo real
- revisar precios, puntas y variaciones de múltiples instrumentos en una sola consulta
Errores frecuentes
400 Not Found: no existe información de precios disponible para la consulta.422 Validation Error:pageosizetienen un formato inválido.500 Internal Server Error: ocurrió un error no especificado durante la consulta.
Siguiente paso
Usá GET /api/prices/market-instruments-prices/{market_instrument_id} para consultar un instrumento puntual o PUT /api/prices/market-instruments-prices-list para consultar varios instrumentos específicos en una sola llamada.
