Custodian holdings

Custodian holdings are the raw position snapshots Aleta receives from each depository — before instruments are mapped to the canonical catalogue, before lots are reconciled, before anything rolls up to a reporting entity. Most integrators never touch them, but they're invaluable for reconciliation, debugging, and building dashboards that show "what the custodian thinks" alongside "what Aleta computed."

When to use this endpoint

  • Reconciliation: compare the custodian's reported position against Aleta's reconstructed holding to spot ingestion gaps.
  • Statement-parity UI: expose to the end user the exact numbers the custodian is showing on the monthly statement.
  • Data-quality audits: flag accounts where custodian-reported totals consistently differ from Aleta's ledger-reconstructed totals.

For anything else — dashboards, performance, allocation analysis — use holdings. Those are reconciled, canonical, and reporting-entity scoped.

Data model

  • Name
    account_id
    Type
    string
    Description

    Account whose snapshot this row belongs to.

  • Name
    depository_id
    Type
    string
    Description

    The depository (custodian relationship) the snapshot came from.

  • Name
    custodian_reference
    Type
    string
    Description

    The identifier the custodian uses for this position on their system. Opaque, not stable across custodians, useful only for cross-referencing with a custodian statement.

  • Name
    description
    Type
    string
    Description

    Free-form position description as provided by the custodian. Not normalised — expect all the typos, abbreviations, and local-language quirks of the source system.

  • Name
    quantity
    Type
    decimal
    Description

    Units as reported by the custodian.

  • Name
    market_value
    Type
    decimal
    Description

    Valuation in the snapshot's native currency.

  • Name
    currency
    Type
    ISO-4217 code
    Description

    Currency of the market value above. Not converted to the reference currency — this is the custodian's own view.

  • Name
    as_of
    Type
    timestamp
    Description

    The snapshot's cut-off. Custodians report at different cadences; as_of is the right field for time-alignment.

GET/v2/custodian-holdings/legal-entities/{id}

Returns every custodian-reported position across every account the legal entity owns. Large responses are paginated; follow the standard pagination convention.

Results are grouped by depository so statement-parity UIs can render one section per custody relationship without re-grouping client-side.

Request

GET
/v2/custodian-holdings/legal-entities/{id}
curl https://api.aleta.io/v2/custodian-holdings/legal-entities/{id} \
  -H "Authorization: Bearer {token}"
  • Holdings — the reconciled view most integrators want.
  • Transactions — the ledger Aleta reconciles the snapshot against.