Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Authentication, error format, and endpoint group quick reference.
http://localhost:5050/api/v1/
GET /healthGET /oracle/producers/{producer_id}/provenanceapi.auth_token is empty unless B1E55ED_INSECURE_OK=1 is set.
# config/user.yaml
api:
auth_token: "your-secret-token"
export B1E55ED_API__AUTH_TOKEN="your-secret-token"
curl \
-H "Authorization: Bearer your-secret-token" \
http://localhost:5050/api/v1/brain/status
{
"error": {
"code": "auth.invalid_token",
"message": "Bearer token is invalid"
}
}
{"detail": "..."}
| Group | What it’s for | Key endpoints |
|---|---|---|
| Health | Liveness + basic DB size/uptime | GET /health |
| Brain | Regime/kill-switch state + run cycles | GET /brain/status, POST /brain/run |
| Signals | Read or submit signals | GET /signals, POST /signals/submit |
| Events / SSE | Real-time stream of events | GET /events/stream |
| Positions | Open positions view | GET /positions, GET /positions/{id} |
| Producers | Producer registry + health | GET /producers/, GET /producers/status, POST /producers/register |
| Contributors | Registry + scoring + attestations | GET /contributors/, POST /contributors/register, GET /contributors/leaderboard |
| Karma / Treasury | Treasury state + settlement projections | GET /treasury (plus /karma/*) |
| Oracle | Public provenance projection | GET /oracle/producers/{producer_id}/provenance |
curl -s http://localhost:5050/api/v1/health | jq
export TOKEN="your-secret-token"
curl -s \
-H "Authorization: Bearer $TOKEN" \
http://localhost:5050/api/v1/brain/status | jq