View as Markdown

Custodian holdings

Custodian holdings are the raw position snapshot as the custodian reported it for a legal entity on a given date — before Aleta's instrument mapping, classification, or consolidation logic runs. This is the right endpoint for reconciliation against custodian statements; for downstream consolidated views, use the v3 holdings endpoints which return the platform's normalised shape against a reporting entity.

Data model

A custodian holding represents one line on the custodian's daily position report.

  • Name
    date
    Type
    ISO 8601 date
    Description

    The custodian's snapshot date for this position.

  • Name
    externalIdentifier
    Type
    string
    Description

    The instrument identifier the custodian sent — typically an ISIN or the custodian's internal code. Aleta has not yet resolved this to a canonical instrument at this stage.

  • Name
    quantity
    Type
    decimal
    Description

    Units held as of the snapshot date.

  • Name
    marketValue
    Type
    decimal
    Description

    Position value in the snapshot's reporting currency. Whether dirty or clean depends on what the custodian sent.

Relationships

  • Name
    legalEntity
    Type
    legal-entity
    Description

    The legal entity the snapshot belongs to.

  • Name
    depository
    Type
    depository
    Description

    The depository that produced the snapshot.

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

List custodian holdings

Returns custodian-side positions for the legal entity. Pass date to query a specific snapshot day; omit it for the most recent.

Query parameters

  • Name
    date
    Type
    ISO 8601 date
    Description

    Snapshot date to retrieve. Required for historical reconciliation; defaults to the latest available date when omitted.

Request

GET/api/v2/custodian-holdings/legal-entities/{id}
curl -G https://platform.aleta.io/api/v2/custodian-holdings/legal-entities/{id} \
  -H "Authorization: Bearer {access_token}" \
  -d date=2026-04-30