▚ BIAN PLATFORM
CatalogRunFAQRepo ↗

Operations and Execution

Currency Exchange

sd-currency-exchange · bian-operations

A BIAN service domain in Operations and Execution. It applies the Process functional pattern to the FX Deal, with the FX Deal Procedure as its control record — one independent Spring Boot microservice on the platform's Cilium eBPF mesh.

View repository ↗The 162-domain platform ↗

Business DomainOperations
Functional PatternProcess
Asset TypeFX Deal
Control RecordFX Deal Procedure

USEWhat it is used for

Representative use cases for the Currency Exchange service domain within a BIAN-aligned core-banking landscape.

APIBIAN semantic API

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

MethodPathBIAN action
GET/v1/service-domainService metadata
POST/v1/fx-deal-procedure/initiateInitiate
GET/v1/fx-deal-procedure/{crId}/retrieveRetrieve
PUT/v1/fx-deal-procedure/{crId}/updateUpdate
PUT/v1/fx-deal-procedure/{crId}/controlControl (suspend / resume / terminate)

INTBackend integrations

The systems and standards a real deployment of Currency Exchange would transact with.

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-currency-exchange
mvn -f sd-currency-exchange spring-boot:run
curl localhost:8080/v1/service-domain

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

FAQQuestions

What is the BIAN “Process” functional pattern?
A Process service domain executes and tracks a defined operational procedure, step by step, to completion. Currency Exchange applies it to the FX Deal.
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. Currency Exchange is the service domain for Operations; it manages the FX Deal Procedure and exposes it through standard BIAN action terms.
What business area does Currency Exchange belong to?
Currency Exchange 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 Currency Exchange 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.

SEEIn the landscape

Currency Exchange is one of 162 BIAN service domains on the platform. Explore the rest:

▚ Platform overview The Master Catalog (162 domains) This repository ↗