BSL Business Line

What this group covers

BSL Business Line endpoints support quote obligations, sessions, receipts, compact order entry, full hotpath results, and low-latency liquidity operations for professional clients.

The endpoint list below is generated from the canonical OpenAPI specification and kept in sync through CI.

📄️Control bsl dead man switch

Uses the registered BSL session-key Ed25519 signature over session_key_dms_control_hash. The key must authorize the account, gateway and cancellation. Arms, heartbeats, reads status or disarms an authenticated session. DMS must be enabled and recovered. An idempotent arm does not extend the deadline. Authentication is carried in the signed request body.

📄️Submit legacy BSL JSON action batch (disabled in production)

Legacy Business Line JSON order-entry route retained for compatibility. The active production profile reports `ingress.jsonEnabled=false` and does not enable this route. New clients must use BSL Direct TCP or the compact HTTP route `/api/v1/bsl/orders/compact`.

📄️Submit BSL compact action batch

Canonical compact byte order-entry facade for latency-sensitive quote engines. Each action in the batch still carries a signed action payload. Use an `institutional_agent` HMAC credential with `quote` scope, or a provisioned dedicated order-entry lane key where the beta bundle allows it. HTTP 200 is an envelope/admission result; inspect `actionResults[]`, receipts, streams, and drop-copy for terminal state.

📄️Replace BSL order

BSL replace facade. For high-frequency quoting, prefer signed QuoteReplace or SpotQuoteReplace actions in a BSL batch.

📄️Cancel-replace BSL order

Alias for the BSL replace facade. Compatibility alias; migrate to `/api/v1/bsl/orders/replace`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.

📄️Submit scoped BSL cancel-all

Cancels the authenticated engine account's open orders, optionally narrowed by market, book, and side. HTTP 200 is an acknowledgement boundary only; reconcile terminal cancel reports through the private execution stream, drop-copy, receipts, or a fresh open-order read.

📄️Get BSL action receipts

Durable receipt read used to reconcile fast BSL acknowledgements with final action state. A submit can return HTTP 200 while an individual action later appears as rejected in receipts, execution stream, or drop-copy.

📄️Get BSL limits

Returns the live machine-readable action, ingress, backlog, rate-limit, order-book, nonceModel, errorGuidance, and QuoteReplace recovery contract. Values from this endpoint override copied documentation.

📄️Get institutional BSL/FIX/FIXP connectivity bundle

Live machine-readable bundle for institutional connectivity: BSL/FIX/FIXP hosts, ports, TLS SNI values, required agent type, signing domain, FIX CompIDs, FIXP schema URL, and direct TCP feature flags.

📄️Self-verify the authenticated BSL compact account mapping

Returns the authenticated account hash, recommended compact index hint, primary/shard mapping diagnostics, and the identity-authority contract. `compactAccountIdx` is a non-authoritative locality hint; the verified SignedAction or registered session key determines account identity and the target shard normalizes its local dense index before apply.

📄️Get BSL sessions

Get BSL sessions

📄️Trigger BSL cancel-on-disconnect cleanup

Trigger BSL cancel-on-disconnect cleanup

📄️Get BSL quote obligations

Get BSL quote obligations

📄️Get BSL execution stream contract

Returns cursor and gap-fill semantics. cursor is exclusive; fromSeq is inclusive. A fast submit ACK is not terminal order truth.

📄️Get BSL execution gap-fill

Get BSL execution gap-fill

📄️Submit legacy BSL JSON action batch compatibility route (disabled in production)

Compatibility JSON route under the legacy `/api/v1/mm` path. The active production profile disables JSON BSL ingress. New clients must use BSL Direct TCP or `POST /api/v1/bsl/orders/compact`. Compatibility alias; migrate to `/api/v1/bsl/orders/batch`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.

📄️Submit BSL compact action batch compatibility route

Trading-plane compact byte route under the legacy /api/v1/mm path. New clients should use POST /api/v1/bsl/orders/compact. Compatibility alias; migrate to `/api/v1/bsl/orders/compact`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.

📄️Submit BSL order-entry byte batch alias

Tested private-beta HTTP surface for direct institutional order entry. The body is a signed action batch encoded as bytes and submitted with `application/x-senticore-order-entry-batch`. Prefer this path for beta direct binary submit and reconcile `derivedOrderIds[]` through orders, receipts, execution stream, or FIX drop-copy. Compatibility alias; migrate to `/api/v1/bsl/orders/compact`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.

📄️Replace BSL order compatibility route

Compatibility alias; migrate to `/api/v1/bsl/orders/replace`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.

📄️Cancel-replace BSL order compatibility route

Compatibility alias; migrate to `/api/v1/bsl/orders/replace`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.

📄️Get BSL action receipts compatibility route

Compatibility alias; migrate to `/api/v1/bsl/receipts`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.

📄️Get BSL limits compatibility route

Compatibility alias; migrate to `/api/v1/bsl/limits`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.

📄️Get BSL sessions compatibility route

Compatibility alias; migrate to `/api/v1/bsl/sessions`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.

📄️Trigger BSL cancel-on-disconnect cleanup compatibility route

Compatibility alias; migrate to `/api/v1/bsl/sessions/cancel-on-disconnect`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.

📄️Get BSL quote obligations compatibility route

Compatibility alias; migrate to `/api/v1/bsl/markets/{market_id}/quote-obligations`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.

📄️Get BSL drop-copy metadata compatibility route

Compatibility alias; migrate to `/api/v1/bsl/executions`. It remains mounted through the compatibility period (retirement review no earlier than 2027-03-07). Signed requests must use the actual request path; no redirect is applied.