Consultar Tenencias
Cada tenencia consiste en la cantidad de cuotapartes que tiene actualmente una cuenta sobre cierto activo/fondo. Este valor va cambiando conforme se realizan transacciones. A continuación se detallan los endpoints disponibles para consultar tenencias:
Consultar tenencia por cuenta
La consulta de tenencias de una cuenta nos indica la cantidad de cuotapartes por fondo y su valor actual, para ello se debe utilizar el endpoint /v1/accounts/{account_id}/holdings/
Método: GET
URL: /v1/accounts/{account_id}/holdings/
Respuesta:
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"holding_id": 60,
"price": 5.320557,
"name": "Testeo de fondos - Testo FMA - Clase Fondo Clase A",
"quantity": 2819.253698,
"available": "now",
"asset_type": 3,
"group": "None",
"current_position_value": "14999.99",
"trading_currency": "Peso Argentino",
"fund_id": 1,
"fund_minimum_amount": 1.0
}
]
}
Hay que recalcar que si el campo available
es frozen
significa que
la tenencia está congelada, por lo cual esa tenencia no se puede operar.
Para un mismo Fondo/Asset puede existir 1 tenencia now
y 1 tenencia
frozen
.
Es importante guardar el holding_id
, ya que más adelante lo podremos
utilizar para consultar el rendimiento de la tenencia.
Obtener tenencia
Puedes consultar una tenencia de una Cuenta con una petición al endpoint api/v1/accounts/{account_id}/holdings/{holding_id} enviando el account_id
de la cuenta y holding_id
de la tenencia como query param.
Total de Cartera
También puedes consultar el Total de Cartera de una Cuenta enviando una petición al endpoint api/v1/accounts/{account_id}/holdings/total_portfolio/ con el account_id
de la cuenta como query param.