PRICES
Servicio por el cual se podrán obtener los precios en tiempo real de los distintos instrumentos, tanto los que se operan en BYMA, como los FCI.
GET/ market-instruments-prices
Endpoints para obtener los precios en tiempo real de los instrumentos de BYMA que se comercialicen.
Se podrá consultar por un instrumento y se enviará como pathParam el "market_instrument_id".
- URL del Endpoint:
GET/{{baseUrl}}/api/prices/market-instruments-prices/{market_instrument_id}
| Campo | Tipo | Descripción |
|---|---|---|
| market_instrument_id | int | Código identificador del instrumento en el mercado. |
| ticker | str | Abreviatura para identificar el instrumento en el mercado. |
| market_id | str | Identificador del mercado en el que se negocia el instrumento. |
| updated_at | datetime | Fecha y hora de la última actualización de los datos del instrumento. |
Dentro del objeto settlement:
En el JSON, en los objetos settlement estaran los precios para los distintos plazos, en caso de que no haya precios para algun plazo el tipo de dato va a ser null.
| Campo | Tipo | Descripción |
|---|---|---|
| prices | objeto | Información de precios de oferta |
| high_price | float | Precio más alto registrado durante el periodo de negociación. |
| last_price | float | Precio de la última transacción realizada. |
| last_trade_date | datetime | Fecha y hora de la última transacción. |
| nominal_value | int | Valor nominal del instrumento. |
| low_price | float | Precio más bajo registrado durante el periodo de negociación. |
| open_price | float | Precio de apertura del instrumento al inicio del periodo de negociación. |
| prev_close_price | float | Precio de cierre del periodo de negociación anterior. |
| effective_volume | float | Volumen efectivo de transacciones realizadas. |
| actual_close_price | float | Precio de cierre actual al final del periodo de negociación. |
| day_percentage_change | float | Cambio porcentual en el precio del instrumento durante el día. |
| day_price_change | float | Cambio absoluto en el precio del instrumento durante el día. |
Dentro del objeto prices:
| Campo | Tipo | Descripción |
|---|---|---|
| ask | lista | Lista de precios de oferta. |
| bid | lista | Lista de precios de demanda. |
Response:
{
"items": [
{
"market_instrument_id": "int",
"ticker": "str",
"market_id": "str",
"settlement_0": {
"prices": {
"ask": [
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
}
],
"bid": [
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
}
]
},
"high_price": "float",
"last_price": "float",
"last_trade_date": "datetime",
"nominal_value": "int",
"low_price": "float",
"open_price": "float",
"prev_close_price": "float",
"effective_volume": "float",
"actual_close_price": "float",
"day_percentage_change": "float",
"day_price_change": "float"
},
"settlement_1": {...},
"settlement_2": {...},
"updated_at": "datetime"
}
]
}
Se podrá consultar por POST request para consultar mas de un instrumento:
[
{
"market_instrument_id": "int"
},
{
"market_instrument_id": "int"
}
]
Response:
{
"items": [
{
"market_instrument_id": "int",
"ticker": "str",
"market_id": "str",
"settlement_0": {
"prices": {
"ask": [
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
}
],
"bid": [
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
}
]
},
"high_price": "float",
"last_price": "float",
"last_trade_date": "datetime",
"nominal_value": "int",
"low_price": "float",
"open_price": "float",
"prev_close_price": "float",
"effective_volume": "float",
"actual_close_price": "float",
"day_percentage_change": "float",
"day_price_change": "float"
},
"settlement_1": "None",
"settlement_2": "None",
"updated_at": "datetime"
},
{
"market_instrument_id": "int",
"ticker": "str",
"market_id": "str",
"settlement_0": {
"prices": {
"ask": [
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
}
],
"bid": [
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
},
{
"price": "float",
"size": "float"
}
]
},
"high_price": "float",
"last_price": "float",
"last_trade_date": "datetime",
"nominal_value": "int",
"low_price": "float",
"open_price": "float",
"prev_close_price": "float",
"effective_volume": "float",
"actual_close_price": "float",
"day_percentage_change": "float",
"day_price_change": "float"
},
"settlement_1": "None",
"settlement_2": "None",
"updated_at": "datetime"
}
]
}
Para obtener los precios de todos los instrumentos BYMA disponibles, utilizar el siguiente endpoint:
- URL del Endpoint:
GET/{{baseUrl}}/api/prices/market-instruments-prices/
Se podrá consultar por los precios historicos de un instrumento, entre las fechas especificadas por medio de queryParams.
- URL del Endpoint:
GET/{{baseUrl}}/api/prices/market-instruments-history/:{market_instrument_id}?from_date=2023-08-01&until_date=2023-08-12
GET/ mutual-funds-prices
Endpoints para obtener los precios de los fondos comúnes de inversión.
Se podrá consultar el precio de un instrumento en el siguiente endpoint y se enviará como pathParam el "mutual_fund_id".
- URL del Endpoint:
GET/{{baseUrl}}/api/prices/mutual-funds-prices/{mutual_fund_id}
Response:
{
"items": [
{
"mutual_fund_id": "int",
"mutual_fund_name": "str",
"clazz_worth": "float",
"share_price": "float",
"share_price_date": "date",
"day_percentage_change": "float",
"day_price_change": "float",
"prev_close_price": "float",
"updated_at": "datetime"
}
]
}
Se podrá consultar por POST request para consultar mas de un instrumento:
[
{
"mutual_fund_id": "int"
},
{
"mutual_fund_id": "int"
}
]
Response:
{
"items": [
{
"mutual_fund_id": "int",
"mutual_fund_name": "str",
"clazz_worth": "float",
"share_price": "float",
"share_price_date": "date",
"day_percentage_change": "float",
"day_price_change": "float",
"prev_close_price": "float",
"updated_at": "datetime"
},
{
"mutual_fund_id": "int",
"mutual_fund_name": "str",
"clazz_worth": "float",
"share_price": "float",
"share_price_date": "date",
"day_percentage_change": "float",
"day_price_change": "float",
"prev_close_price": "float",
"updated_at": "datetime"
}
]
}
Para obtener los precios de todos los instrumentos FCI disponibles, utilizar el siguiente endpoint:
- URL del Endpoint:
GET/{{baseUrl}}/api/prices/mutual-funds-prices
Response:
{
"items": [
{
"mutual_fund_id": "int",
"mutual_fund_name": "str",
"clazz_worth": "float",
"share_price": "float",
"share_price_date": "date",
"day_percentage_change": "float",
"day_price_change": "float",
"prev_close_price": "float",
"updated_at": "datetime"
},
{
"mutual_fund_id": "int",
"mutual_fund_name": "str",
"clazz_worth": "float",
"share_price": "float",
"share_price_date": "date",
"day_percentage_change": "float",
"day_price_change": "float",
"prev_close_price": "float",
"updated_at": "datetime"
}
]
}
Se podrá consultar por los precios historicos de un fci, entre las fechas especificadas por medio de queryParams.
- URL del Endpoint:
GET/{{baseUrl}}/api/prices/mutual-funds-history/:{mutual_fund_id}?from_date=2023-08-01&until_date=2023-08-12