Deployment model
For bank architects who need to know where the platform runs, who operates it, and how it connects to the bank.
Who this is for
Bank architects, infrastructure teams and risk functions deciding where Quant Flow Platform should run. This page covers the two deployment models, how banks are isolated from one another, who operates each layer, connectivity, data residency and releases. It does not cover individual security controls. See Security and key management.
Two deployment models
The platform supports Quant-hosted and client-hosted models. Confirm the installed release, enabled features and control configuration for your environment. The infrastructure responsibilities differ as shown below; the approved deployment design determines their implementation.
| Quant-hosted | Client-hosted | |
|---|---|---|
| Where it runs | Quant's managed Kubernetes environment | The bank's own infrastructure: its data centre or its own cloud subscription, on any conformant Kubernetes distribution |
| Who deploys and operates it | Quant | The bank, using Quant's signed container images and Helm charts. Quant supplies the software, its updates and support. |
| Identity provider that issues access tokens | Operated by Quant. Quant issues client credentials. | The bank's own identity provider and client registrations |
| Gateway, TLS termination and rate limiting | Operated by Quant | The bank's own gateway and edge |
| Database encryption at rest, secret store and key service | Operated by Quant | The bank's own, under keys the bank holds |
| Log collection and retention | Operated by Quant | The bank's own log platform and SIEM. Nothing in the logging path leaves the bank's environment. |
| Custody provider holding signing keys | Integrated and operated by Quant | The bank's own custody provider and workspace |
| Data residency and retention | Quant's hosting region and retention policy | Chosen by the bank |
Use the published API contract for both models and confirm the assigned gateway, trusted issuer, claims and enabled workflows during onboarding.
Isolation between banks
Confirm whether your bank has a dedicated deployment/database and record the isolation boundary in the approved hosting design. Do not infer physical isolation from a tenant-scoped API response.
Inside a deployment, tenant-scoped business operations use the organisation in the access token. Any tenant ID in a path must match that identity. Shared resources and user-by-ID lookup have distinct rules; see Authentication.
Shared responsibility
Controls built into the application are the same in every deployment. These include request validation, idempotency, webhook signing, structured logging and the append-only audit history of every change to persistent data.
In the client-hosted model, the bank operates the layers around the application:
| Layer | Provided in the platform software | Operated by the bank |
|---|---|---|
| Caller authentication | Uses the configured trusted issuer, claims and keys | Identity provider and client registrations |
| Token validation | Acts on the validated caller identity | Validation at the bank's gateway on every request |
| Encryption in transit at the edge | Gateway TLS termination and certificates | |
| Encryption at rest | Database and volume encryption with the bank's keys | |
| Signing keys | Holds no blockchain keys. Integrates with the custody provider. | Custody provider and its workspace |
| Secrets | Uses the agreed secret-management integration | Secret store, values and rotation policy |
| Logging and audit | Structured logs and append-only audit history | Log platform, retention, SIEM and alerting |
| Network segmentation | Network policies shipped with the charts | Cluster, network and perimeter operation |
| Vulnerability remediation | Quant advisories and patched releases | Deploying updates and patching infrastructure |
| Rate limiting and web application firewall | At the bank's edge | |
| Incident response | Quant's product-security process for platform defects | The bank's operational incident process |
Connectivity
External traffic reaches the platform over HTTPS. TLS 1.2 is the minimum and TLS 1.3 is preferred.
- Quant-hosted. The API can be reached over a private link from the bank's own cloud network, so traffic does not cross the public internet. Agree gateway exposure, private connectivity, firewall rules and any IP allow-listing with the deployment team. An API server URL does not specify the network access arrangement.
- Client-hosted. The bank's systems reach the platform over the bank's own private network paths, such as a site-to-site VPN, a dedicated interconnect or a private link. The platform's services, databases and message broker run on the bank's private network.
Inventory outbound dependencies with the deployment team, including identity keys, custody/HSM services, ledger nodes, webhook receivers and any enabled institution-identity verification service. The public endpoint list is not a complete network allow-list.
Data residency
The platform holds the operational data tokenisation needs: accounts and their references, token definitions, scripts and automations with their execution history, policies and decisions, webhook subscriptions and delivery events, signing requests (the transaction and its status, never a key) and the record of each ledger transaction. Data written to the ledger is limited to what the token contract requires.
- Quant-hosted. Data resides in Quant's hosting region under Quant's retention policy. Agree the hosting region and data-location requirements before provisioning the environment.
- Client-hosted. The bank hosts the databases, so it controls residency, retention, backup encryption and the handling of any data-subject or regulatory request.
Ledger nodes and custody
Tokens are issued on a private, permissioned ledger network that only the platform's own nodes join. See Supported networks.
- Quant-hosted. Quant operates the network's nodes and the custody integration.
- Client-hosted. Where the ledger nodes run is agreed with the bank as part of the deployment design. The bank's custody provider holds the signing keys in the bank's own workspace.
Document who operates the ledger nodes and how the bank connects to the selected network in the deployment operating model.
Releases and change
Obtain the approved release artefacts, source/version identity, release notes and available build/test/signature evidence for each upgrade. Agree the delivery cadence and security-patch process with the release owner; the API contract does not establish these assurances.
- Quant-hosted. Quant deploys releases. Agree the release calendar, notice period, rollback responsibilities and acceptance testing with your platform contact.
- Client-hosted. The bank deploys each release into its own non-production environment first and promotes it to production under its own change management.
A change that breaks clients is released as a new major API version. See API versioning.
Worked example
The same request in both models. Only the host and the issuer of the access token differ.
Quant-hosted:
GET /api/accounts/ACC-0001/balances HTTP/1.1
Host: api.qfp.quantnetwork.net
Authorization: Bearer <access token issued by the Quant-operated identity provider>
API-Version: 1.0.0Client-hosted:
GET /api/accounts/ACC-0001/balances HTTP/1.1
Host: <your gateway host>
Authorization: Bearer <access token issued by your identity provider>
API-Version: 1.0.0The response is the same in both:
HTTP/1.1 200 OK
Content-Type: application/json
{
"accountRef": "ACC-0001",
"customerRef": "CUST-0001",
"assetId": "GBP",
"total": "1250.00",
"available": "1210.00",
"locked": "40.00",
"asOf": "2026-08-13T11:58:04.114Z"
}View in API Reference
Errors and edge cases
- A token from another deployment is rejected. Tokens are validated for signature, issuer and expiry on every request, and a missing, expired or malformed token returns
401. - Client-hosted infrastructure is the bank's to size and operate. Availability of the gateway, identity provider, database, secret store and custody connection sits with the bank in that model.
- Recovery after a failover. The operational database records intent and status. Value is recorded on the ledger. After a failover, operations in flight are reconciled against the ledger. See Reconcile against your core banking.
API Reference
Open an endpoint for request fields, response examples and the interactive API console.
| Operation | Method |
|---|---|
| Get an account's balances | GET |
Related pages
Updated 4 days ago

