get
https://example.com/api/instruments/market/all
Obtiene todos los instrumentos de mercado disponibles y permite paginar el resultado.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Listá todos los instrumentos de mercado disponibles para comercializar.
Antes de empezar
- Usá este endpoint cuando necesites obtener el universo completo de instrumentos de mercado disponibles.
- Agregá
pageysizesi querés paginar el resultado. - Si necesitás el detalle de un instrumento puntual, usá
GET /api/instruments/market/{market_instrument_id}.
Cómo listar instrumentos de mercado
GET /api/instruments/market/allConsultar con paginación
GET /api/instruments/market/all?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 | 100 | Cantidad de instrumentos por página. |
Qué devuelve este endpoint
La respuesta devuelve un objeto paginado con:
items: lista de instrumentos de mercadototal: cantidad total de instrumentos 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. |
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
},
{
"market_instrument_id": 42,
"ticker": "AL30D",
"currency_id": "USD",
"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
}
],
"total": 2,
"page": 1,
"size": 50
}Cuándo usar este endpoint
Este endpoint es útil cuando necesitás:
- obtener el listado completo de instrumentos de mercado
- construir selectores o catálogos de instrumentos
- identificar qué instrumentos están habilitados para compra o venta
Errores frecuentes
422 Validation Error:pageosizetienen un formato inválido.
Siguiente paso
Usá el market_instrument_id devuelto por este endpoint para consultar el detalle de un instrumento puntual con GET /api/instruments/market/{market_instrument_id}.
