Get Instrument By Id

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Consultá la información detallada de un instrumento de mercado usando su market_instrument_id.

Antes de empezar

Tené a mano el market_instrument_id del instrumento que querés consultar.
Usá este endpoint cuando necesites recuperar el detalle de un instrumento puntual antes de mostrarlo, validarlo o usarlo en un flujo operativo.
Si necesitás listar todos los instrumentos disponibles, usá GET /api/instruments/market/all.

Cómo consultar un instrumento

GET /api/instruments/market/{market_instrument_id}

Path parameters

Parámetro	Tipo	Requerido	Descripción
`market_instrument_id`	integer	Sí	Identificador único del instrumento de mercado.

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa un instrumento de mercado e incluye:

Campo	Tipo	Descripción
`market_instrument_id`	integer	Código identificador del instrumento.
`ticker`	string	Abreviatura que identifica el instrumento en el mercado.
`currency_id`	string	Moneda del instrumento.
`instrument_type`	string	Tipo del instrumento.
`instrument_description`	string	Descripción del instrumento.
`market_index`	array de strings	Índices o mercados asociados al instrumento.
`selling_enabled`	boolean	Indica si el instrumento está habilitado para venta.
`buying_enabled`	boolean	Indica si el instrumento está habilitado para compra.
`base_instrument_id`	integer	Identificador del instrumento base.

Respuesta esperada

{
  "items": [
    {
      "market_instrument_id": 41,
      "ticker": "AL30",
      "currency_id": "ARS",
      "instrument_type": "GOVERNMENT_BOND",
      "instrument_description": "BONO NACION ARG.U$S STEP UP 2030 LA",
      "market_index": [
        "
      ],
      "selling_enabled": true,
      "buying_enabled": true,
      "base_instrument_id": 41
    }
  ]
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

consultar el detalle de un instrumento específico
validar si un instrumento está habilitado para compra o venta
obtener el base_instrument_id para relacionarlo con otros procesos

Errores frecuentes

404 Not Found: no existe un instrumento para el market_instrument_id enviado.
422 Validation Error: el market_instrument_id tiene un formato inválido.

Siguiente paso

Si necesitás explorar el universo completo de instrumentos disponibles, continuá con GET /api/instruments/market/all.