Non-custodial, end to end
The API cannot withdraw or transfer funds. Allocation calls operate strictly within the trade-only permission scope you granted via Privy delegated signing or an exchange API key.
Same invariants
The API inherits the architecture.
Under the same breaker
Every trade-decision routed through the API passes the same in-process Rust validation, Redis shared state, and Postgres audit log as the dashboard. There is no second engine.
Typed and versioned
Routes are mounted under /api/v1. Payloads are typed; a malformed response surfaces as a typed error, never a silent failure. Breaking changes ship under a new version.
Auditable by you
Every state change the API makes is written to the hash-chained audit log, which you can query back through the API itself. Any modification breaks the chain.
Surface
Representative endpoints.
Read state, open bounded allocations, and audit everything. The full reference — schemas, error codes, and rate limits — lives in the docs.
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/swarms | List swarms with their current governance stage. |
| GET | /api/v1/swarms/{id}/calibration | Brier scores and calibration history for one swarm. |
| GET | /api/v1/allocations | Your active allocations across swarms. |
| POST | /api/v1/allocations | Open or adjust an allocation, bounded by your venue scope. |
| GET | /api/v1/breaker | Current circuit-breaker state across the three layers. |
| GET | /api/v1/audit | Query the hash-chained, tamper-evident audit log. |
Authentication
Keyed access, scoped trading.
You authenticate the API with a bearer key minted from your account. The key authorizes read access and bounded allocation calls — it never authorizes withdrawal, because withdrawal is not part of the permission scope STAXIS holds in the first place.
Revoke a key at any time from your dashboard. Revoking the API key does not touch your custody: your funds were never reachable by it.
curl https://api.staxis.ai/api/v1/swarms \ -H "Authorization: Bearer $STAXIS_KEY"