Consultá los precios en tiempo real de un instrumento de mercado usando su market_instrument_id.

Antes de empezar

1. Tené a mano el market_instrument_id del instrumento que querés consultar.
2. Usá este endpoint cuando necesites el precio actual de un instrumento puntual que cotiza en mercado.
3. Si necesitás consultar varios instrumentos a la vez, usá PUT /api/prices/market-instruments-prices-list.
4. Si necesitás el histórico de precios, usá GET /api/prices/market-instruments-history/{market_instrument_id}.

Cómo consultar el precio de un instrumento

GET /api/prices/market-instruments-prices/{market_instrument_id}

Path parameters

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa los precios vigentes del instrumento consultado.

Estructura de cada objeto settlement

Dentro de cada settlement, la respuesta puede incluir:

Estructura de prices

Cada elemento de ask o bid puede incluir:

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"
    }
  ]
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

• consultar el precio actual de un instrumento específico
• mostrar puntas compradoras y vendedoras
• revisar variaciones diarias y volumen negociado

Errores frecuentes

• 400 Not Found: no existe información de precios para el market_instrument_id enviado.
• 422 Validation Error: el market_instrument_id tiene un formato inválido.
• 500 Internal Server Error: ocurrió un error no especificado durante la consulta.

Siguiente paso

Si necesitás consultar varios instrumentos en una sola llamada, usá PUT /api/prices/market-instruments-prices-list. Si necesitás el histórico, usá GET /api/prices/market-instruments-history/{market_instrument_id}.