HTTP API Overview
The Senticore HTTP API uses JSON over HTTPS for public data, trading, account, funding, vault, transparency, and status flows. Professional quote engines should read the Market Maker Beta Quickstart before using the generated API reference.
Endpoint Groups
| Group | Purpose | Auth |
|---|---|---|
| Public Market Data | Markets, books, trades, candles | None |
| Trading | Signed actions, delegated orders, cancels, batch flows | Wallet signature or delegated API agent |
| Accounts | Balances, positions, fills, history | Private session token or account auth |
| Funding | Deposits and withdrawals | Wallet signature |
| Vaults | Vault creation, deposits, withdrawals | Wallet signature |
| BSL Order Entry | Professional signed action batches and quote refresh | Signed action, optional lane key, provisioned machine credentials for protected routes |
| Protocol Transparency | Commitments, proofs, status | Mixed, mostly public |
| Status | Health, readiness, build information | None |
Generated /api/v1/institutional/* entries are not the market-maker order-entry
path. They are account/reporting/provisioning surfaces and may require separate
parameters or operator access.
Base URLs
| Environment | Base URL |
|---|---|
| Live private beta | https://api.sentico-labs.xyz |
| Local development | http://localhost:8080 |
Public mainnet is not live yet.
Professional Order Entry
Current private-beta tested submit path:
POST /api/order-entry/binary
Content-Type: application/x-senticore-order-entry-batch
X-BSL-Result-Mode: ack
X-Senticore-Response-Mode: detailed
Direct compatibility route:
POST /api/v1/mm/orders/batch.bin
Canonical BSL route after edge rollout:
POST /api/v1/bsl/orders/compact
Use X-Senticore-Order-Entry-Key only when operations assigns a dedicated lane
key. The action inside the batch must still be signed by the account or a
delegated signer.
Response Contract
In 0.1.3 private beta, start with x-bsl-result-mode: ack and
x-senticore-response-mode: detailed. This returns acceptance metadata and derived
order ids where available. Treat it as an acknowledgement, not final terminal
order truth.
The BSL result-mode names ack, durable, and full are the target contract
for professional clients. Do not require full in production until a live
conformance run passes for your account and route.
API Reference
The endpoint reference is generated from the canonical OpenAPI specification. Use it as a reference, not as the market-maker onboarding path.