Skip to content
Partner API Docs

Custody and Beneficial Ownership

Understand omnibus custody, per-sub-account beneficial ownership, settlement, and custody reconciliation in the MyStocks operating model.

MyStocks maintains the per-sub-account beneficial-ownership ledger. Regulated brokers, custodians, and the relevant CSD hold and settle securities according to each market’s rules.

What the API represents

  • A filled order is an execution event; it is not automatically settled custody.
  • Unsettled sell proceeds remain unavailable for withdrawal until the relevant settlement condition is met.
  • Portfolio and holdings endpoints show the per-sub-account ledger.
  • The custody section of GET /report/reconciliation compares pooled custody positions with the sum of attributed sub-account holdings.
  • Corporate actions and dividends are distributed through account records and signed events.

Daily custody control

  1. Pull securities and custody_positions sections from the reconciliation pack.
  2. Compare total units by symbol and market with the custodian/CSD file.
  3. Break differences down by sub-account, pending order, settlement date, and corporate action.
  4. Record the exception and do not silently overwrite the beneficial-ownership ledger.
  5. Close the exception only after a corrected source record or operations confirmation.

MyStocks is a technology and orchestration platform, not a broker-dealer. The executing broker and custodian for a market are disclosed through the applicable contractual and operational process. See Architecture & Custody and Going Live.

Was this page useful?

Your signal helps us tighten partner onboarding docs.

Last updated on

On this page