Consultar tenencia valorizada

Devuelve la tenencia valorizada cacheada para una o más cuentas del PSP.

Cuentas fuera de tu rango

Un número de cuenta fuera de tu bloque asignado vuelve como entrada de error dentro de una respuesta 200, no como una falla del request. Leé las entradas por cuenta, no solo el status code.

Allaria reserva ese bloque contiguo de números de cuenta para tu integración cuando se da de alta — ver Introducción.

POST/v1/psp/tenencia-val

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de acceso en formato Bearer ACCESS_TOKEN
Content-Type	string	Sí	Debe ser application/json

No aplica: Path Parameters, Query Parameters.

Body

Campo	Tipo	Requerido	Descripción
cuentas	number[]	Sí	Números de cuenta a consultar

Response

2XX Éxito

Campo	Tipo	Descripción
cuenta	number	Número de cuenta
fondo	string	Código del fondo
cantidad	number	Cantidad de cuotapartes
precio	number	Precio actual de la cuotaparte
valuacion	number	Valuación de la posición
error	string	Presente cuando la cuenta no puede consultarse

Códigos de error

Status	Descripción
400	Payload cuentas faltante o inválido
401	Unauthorized - token inválido o ausente
403	Forbidden - el token no tiene permiso para acceder a este recurso

Ejemplo de código

cURL

curl -X POST "https://b2b.allaria.cloud/v1/psp/tenencia-val" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cuentas": [300000001, 300000002]
  }'

2XX Éxito

[
  {
    "cuenta": 300000001,
    "fondo": "ALAHORA:AR",
    "cantidad": 10.25,
    "precio": 81.893806,
    "valuacion": 839.61
  },
  {
    "cuenta": 399999999,
    "error": "Cuenta errónea"
  }
]