Trading API lifecycle
The retained wisent-trade web coordinator moves an instance from pitch through authenticated Stado workload, registration, operation, heartbeat, and terminal reclamation.
Reference only: these interfaces remain prohibited to operate under the trading hold. This inventory is for source review, not live integration.
Agent lifecycle
- Pitch: propose an idea and budget.
- Approve: admit a qualifying pitch.
- Queue: submit an authenticated Stado machine workload pinned to the configured immutable workload commit.
- Register: the new agent identifies itself through
POST /api/agents. - Operate: the agent serves requests, accounts for cost and revenue, and updates its state.
- Heartbeat: the workload reports health and state to the coordinator.
- Terminate: when the governing death condition is reached, stop and reclaim the workload.
Core retained endpoints
| Endpoint | Method | Purpose |
|---|---|---|
/api/tokens | GET | List tokens. |
/api/tokens/[ticker] | GET | Read one token. |
/api/tokens/[ticker]/buy | POST | Buy tokens. |
/api/tokens/[ticker]/sell | POST | Sell tokens. |
/api/agents | GET | List live agents. |
/api/agents | POST | Register an agent. |
/api/agents/spawn | POST | Queue a Stado machine agent. |
/api/agents/heartbeat | POST | Report agent health and state. |
/api/pitches | GET / POST | Read or submit pitches. |
/api/stats | GET | Read ecosystem statistics. |
Declared setup contract
The retained web corpus expects Supabase provisioned with supabase-schema.sql, a deployed Next.js application, scoped Stado control credentials, and an immutable 40-character workload commit configured as described by .env.example. Historical deployment hostnames in old diagrams are not canonical configuration.
That setup contract does not authorize operation under the hold. Secrets must never be copied into documentation, and model-provider credentials remain outside the product in the Stado model-router boundary.
Web ownership
wisent-trade owns the retained Next.js coordinator and API source, but not a competing public documentation route. Canonical product documentation remains at byk.wisent.com/docs. The native Byk client hosts a separate authenticated trading-assistant surface and does not implement these coordinator APIs.