Skip to main content

Submit BSL order-entry byte batch alias

POST 
/api/order-entry/binary

Direct institutional order-entry contract​

POST /api/order-entry/binary is the tested beta HTTP surface for direct institutional order entry. It accepts the same signed action batch semantics as the BSL compact facade, but uses the dedicated order-entry lane.

HeaderRequiredNotes
Content-Type: application/x-senticore-order-entry-batchyesPreferred beta content type. application/x-senticore-bsl-batch and application/octet-stream may remain accepted for migration.
X-Senticore-Order-Entry-Keybeta bundle dependentPreferred dedicated lane key.
SC-Auth-Version: 2 plus SC-*beta bundle dependentUse an institutional_agent HMAC credential when enabled.
X-BSL-Result-Modeoptionalack, durable, or full. Start with ack.
X-Senticore-Response-ModeoptionalUse detailed during integration so actionResults[] is present.

Expected failure classes:

StatusMeaning
401Missing or invalid machine/lane auth.
403Credential exists but is not allowed for institutional BSL/order-entry.
413Batch exceeds the beta body limit; split the batch.
415Content type is not an accepted order-entry batch type.
400Batch cannot be decoded or an action envelope is malformed.
409Nonce/idempotency/order-state conflict.

cURL skeleton​

curl -X POST "$SENTICORE_API_BASE_URL/api/order-entry/binary" \
  -H "Content-Type: application/x-senticore-order-entry-batch" \
  -H "Accept: application/x-senticore-order-entry-batch-response, application/json" \
  -H "X-Senticore-Order-Entry-Key: $SENTICORE_ORDER_ENTRY_KEY" \
  -H "X-BSL-Result-Mode: ack" \
  -H "X-Senticore-Response-Mode: detailed" \
  --data-binary @tmp/known-good-bsl-batch.bin

Do not treat top-level ok: true as final execution truth. Reconcile derivedOrderIds[] through open orders, receipts, fills, execution stream, or FIX drop-copy.

deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

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.

Request​

Responses​

Order-entry batch accepted or rejected

Last updated on