Operations and Execution

Securities Position Keeping

sd-securities-position-keeping · bian-operations

A BIAN service domain in Operations and Execution. It applies the Maintain functional pattern to the Securities Position, with the Securities Position Maintenance Agreement as its control record — one independent Spring Boot microservice on the platform's Cilium eBPF mesh.

View repository ↗The 162-domain platform ↗

Business DomainSecurities

Functional PatternMaintain

Asset TypeSecurities Position

Control RecordSecurities Position Maintenance Agreement

USEWhat it is used for

Representative use cases for the Securities Position Keeping service domain within a BIAN-aligned core-banking landscape.

Maintain Securities Position positions and process settlements/corporate actions
Service portfolios for wealth and institutional clients
Reconcile holdings against custodian and CSD records daily

APIBIAN semantic API

The control record (Securities Position Maintenance Agreement) is exposed through uniform BIAN action terms. Java 21 · Spring Boot 3, OpenAPI at /swagger-ui.html, health at /actuator/health.

Method	Path	BIAN action
GET	`/v1/service-domain`	Service metadata
POST	`/v1/securities-position-maintenance-agreement/initiate`	Initiate
GET	`/v1/securities-position-maintenance-agreement/{crId}/retrieve`	Retrieve
PUT	`/v1/securities-position-maintenance-agreement/{crId}/update`	Update
PUT	`/v1/securities-position-maintenance-agreement/{crId}/control`	Control (suspend / resume / terminate)

INTBackend integrations

The systems and standards a real deployment of Securities Position Keeping would transact with.

Custodians: BNY Mellon, Citi; CSDs: NSDL/CDSL, Euroclear
OMS/PMS: Charles River, BlackRock Aladdin
Connectivity: FIX, SWIFT securities messages

RUNRun it yourself

Each service domain is its own standalone Spring Boot repository — clone and run in seconds, or deploy onto Kubernetes with the bundled Helm chart behind the Cilium mesh.

# run this service domain standalone
git clone https://github.com/Sreenivas-Sadhu-Prabhakara/sd-securities-position-keeping
mvn -f sd-securities-position-keeping spring-boot:run
curl localhost:8080/v1/service-domain

# or deploy onto Kubernetes (Cilium eBPF mesh)
helm upgrade --install sd-securities-position-keeping ./helm -n bian-operations

FAQQuestions

What is a BIAN service domain?

BIAN (the Banking Industry Architecture Network) decomposes a bank into independent service domains, each owning exactly one business capability. Securities Position Keeping is the service domain for Securities; it manages the Securities Position Maintenance Agreement and exposes it through standard BIAN action terms.

What business area does Securities Position Keeping belong to?

Securities Position Keeping sits in the Operations and Execution business area — the operational core that executes payments, positions, settlements and transactions. It runs in the bian-operations namespace as one independent Spring Boot microservice.

Is Securities Position Keeping production-ready?

It is an educational reference implementation: a real BIAN REST API over an in-memory store, ready to be filled with domain logic. It is not a live bank and is not affiliated with BIAN.