Cuentas y rendimiento

Alta de comitente y consulta de rendimiento por fecha.

Endpoints de cuentas

Método	Path	Descripción
`GET`	`/api/v1/accounts`	Rendimiento por cuenta: saldo, ganancia $/% (acumulado). Con `?date=YYYY-MM-DD` también el rendimiento del día.
`POST`	`/api/v1/accounts`	Alta de cuenta comitente (persona física) + sync al Back Office. Header `Idempotency-Key` obligatorio.
`GET`	`/api/v1/accounts/{comitente}`	Detalle de una cuenta + evolución histórica del saldo. Acepta `?date=`.

Alta de comitente

curl -X POST {BASE_URL}/api/v1/accounts \
  -H "Authorization: Bearer sk_xxx" \
  -H "Idempotency-Key: acct-2026-07-28-000123" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "tu id interno del cliente",
    "persona": {
      "nombre": "Test",
      "apellido": "Gallo",
      "cuit": 20331899926,
      "tipo_documento": 1,
      "nro_documento": 33189992,
      "fecha_nacimiento": 19601008,
      "email": "cliente@psp.example",
      "calle": "25 de Mayo",
      "numero": "347",
      "codigo_postal": "1002",
      "localidad": "CABA",
      "provincia": 1
    }
  }'

Respuesta 201 con account.comitente (número asignado por el BO) y status: "active". Reintento con la misma Idempotency-Key → 200 + replayed: true. Si el BO rechaza → 422 y el registro queda en failed (reintentable desde ops).

Rendimiento por fecha

curl "{BASE_URL}/api/v1/accounts?date=2026-08-05" \
  -H "Authorization: Bearer sk_xxx"

Por cada cuenta de la billetera: totals.gain / totals.gain_pct (acumulado al cierre) y totals.day_gain / totals.day_gain_pct (rendimiento de ese día vs el cierre anterior). Requiere VCPs cargados para la fecha. Sin date se usa el último VCP disponible.

Fondos

Antes de operar, consultá el catálogo:

Método	Path	Descripción
`GET`	`/api/v1/funds`	Catálogo de fondos activos. Filtrá con `?id=` o `?code=`.
`GET`	`/api/v1/funds/{id}`	Detalle de un fondo activo por UUID.

Las órdenes referencian el fondo por fund_id (UUID). La moneda se deriva del fondo.

Referencia completa: /docs/api (Swagger) · Hub de documentación