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.
| Header | Required | Notes |
|---|---|---|
Content-Type: application/x-senticore-order-entry-batch | yes | Preferred beta content type. application/x-senticore-bsl-batch and application/octet-stream may remain accepted for migration. |
X-Senticore-Order-Entry-Key | beta bundle dependent | Preferred dedicated lane key. |
SC-Auth-Version: 2 plus SC-* | beta bundle dependent | Use an institutional_agent HMAC credential when enabled. |
X-BSL-Result-Mode | optional | ack, durable, or full. Start with ack. |
X-Senticore-Response-Mode | optional | Use detailed during integration so actionResults[] is present. |
Expected failure classes:
| Status | Meaning |
|---|---|
401 | Missing or invalid machine/lane auth. |
403 | Credential exists but is not allowed for institutional BSL/order-entry. |
413 | Batch exceeds the beta body limit; split the batch. |
415 | Content type is not an accepted order-entry batch type. |
400 | Batch cannot be decoded or an action envelope is malformed. |
409 | Nonce/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.
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.
Request
Responses
- 200
- 400
- 401
- 403
- 409
- 413
- 415
Envelope accepted at the requested order-entry result boundary.
Malformed batch or action envelope.
Missing or invalid machine/lane authentication.
Credential is not allowed for institutional BSL/order-entry.
Nonce, idempotency, order-state, or risk conflict. Risk rejects include actionResults[].risk with asset, free, locked, required, account, market, and book.
Batch exceeds the configured body limit.
Unsupported order-entry batch content type.