Custodian holdings

What the bank reported it holds, as it reported it: one point per security or contract and day. These are the bank's raw figures, before Aleta reconciles and calculates; for the holdings Aleta reports, see holdings. Cash balances are custodian balances.

Needs custody:read. You see the points on the custody accounts, cash accounts and portfolios you have access to, whoever loaded them. The figures are the bank's whole figures: they are not weighted by ownership.

A contract (a private equity fund, a loan, an fx forward) is an asset: its points are holdings of the contract's asset, with no custody account. Their quantity is the reported amount; price, price_date, market_value, accrued_interest and exchange_rate are null, and a private equity contract carries its reported figures. A contract point whose asset cannot be told apart (no asset, or two, carry the bank's contract id) is not listed.

The holding

idstring: The point. A UUID.
as_ofstring: The day the bank reported, yyyy-mm-dd.
custodian_idstring or null: The bank: the one on the point, else the custody account's; null when neither has one.
entity_idstring or null: The entity whose portfolio holds it: the point's portfolio, else the custody account's, else the cash account's; null when there is none.
custody_account_idstring or null: The custody account; null on a contract.
asset_idstring or null: The asset: the security, or the contract.
quantity, price, price_date, market_value, accrued_interest, currency_codestring or null: As reported. Decimals are strings, dates yyyy-mm-dd.
exchange_rateobject or null: The bank's rate, {from_currency_code, to_currency_code, date, rate}, when it sent one.
sourcestring or null: How the point arrived: scraper, bank_file, bank_api, external_delivery, priority_bank_file or manual; null when the point does not say.
total_commitment, commitment_remaining, paid_in_capital, distributions, recallable, reported_nav, reported_nav_datestring or null: A private equity contract's reported figures; null on other points.

GET/v1/custodian-holdings

List holdings

One day's points in id order, one page at a time (limit, cursor). The day is exactly as_of, as the bank reported it; banks report the day before, so today, the default, is usually empty. The answer's as_of is the day read. Any other parameter (date, depository_id, account_id, cash_account_id) is 400.

Optional attributes

as_ofstring: The day, yyyy-mm-dd. Default today (UTC).
entity_idstring: Only this entity's points (with its holding twin from the legacy platform).
custody_account_idstring: Only this custody account's points; contracts have none, so they are left out.
limitinteger: Page size. Default 100; a larger value is capped at 1000 and 0 counts as 1.
cursorstring: The next_cursor of the previous page.

Response

{
  "data": [
    {
      "id": "0199f2a0-7c1e-7a40-9d1b-3c5e8f0a2b11",
      "as_of": "2026-10-17",
      "custodian_id": "019dff7d-5a85-741e-8437-22e1d5f7c685",
      "entity_id": "0199f29f-1b2c-7d3e-8f40-5a6b7c8d9e0f",
      "custody_account_id": "0199f29f-3c4d-7e5f-8a6b-7c8d9e0f1a2b",
      "asset_id": "0199f29f-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "quantity": "103400.4",
      "price": "95.555",
      "price_date": "2026-10-16",
      "market_value": "9880258.22",
      "accrued_interest": "1250.5",
      "currency_code": "EUR",
      "exchange_rate": { "from_currency_code": "EUR", "to_currency_code": "DKK", "date": "2026-10-17", "rate": "7.4612" },
      "source": "bank_file",
      "total_commitment": null,
      "commitment_remaining": null,
      "paid_in_capital": null,
      "distributions": null,
      "recallable": null,
      "reported_nav": null,
      "reported_nav_date": null
    }
  ],
  "next_cursor": null,
  "limit": 100,
  "as_of": "2026-10-17"
}

400 (bad_request) for a malformed as_of, entity_id, custody_account_id or limit, an unknown parameter or a cursor that cannot be read (invalid cursor); 401 (unauthorized) without a valid token; 403 (forbidden) without custody:read.