API Overview

Base URL

http://localhost:5050/api/v1/

Authentication

All endpoints except:

GET /health
GET /oracle/producers/{producer_id}/provenance

require a bearer token. b1e55ed refuses to start if api.auth_token is empty unless B1E55ED_INSECURE_OK=1 is set.

Set the token (YAML)

# config/user.yaml
api:
  auth_token: "your-secret-token"

Set the token (environment)

export B1E55ED_API__AUTH_TOKEN="your-secret-token"

Use the token

curl \
  -H "Authorization: Bearer your-secret-token" \
  http://localhost:5050/api/v1/brain/status

Error format

Most b1e55ed API errors use a stable machine-readable structure:

{
  "error": {
    "code": "auth.invalid_token",
    "message": "Bearer token is invalid"
  }
}

Some endpoints may also return FastAPI default errors:

{"detail": "..."}

Rate limiting

Rate limiting is not currently enforced at the API layer.

Be reasonable anyway (especially for SSE reconnect loops and polling). Treat the API as if a soft limit exists.

Endpoint groups (quick reference)

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`

Quick curl examples

Health (no auth)

curl -s http://localhost:5050/api/v1/health | jq

Brain status (auth)

export TOKEN="your-secret-token"
curl -s \
  -H "Authorization: Bearer $TOKEN" \
  http://localhost:5050/api/v1/brain/status | jq

OpenClaw Integration

Brain API

Getting Started

Setup

Producers

Operations

Features

Integrations

API Reference

Contributing

Reference

Base URL

Authentication

Set the token (YAML)

Set the token (environment)

Use the token

Error format

Rate limiting

Endpoint groups (quick reference)

Quick curl examples

Health (no auth)

Brain status (auth)

​Base URL

​Authentication

​Set the token (YAML)

​Set the token (environment)

​Use the token

​Error format

​Rate limiting

​Endpoint groups (quick reference)

​Quick curl examples

​Health (no auth)

​Brain status (auth)

Base URL

Authentication

Set the token (YAML)

Set the token (environment)

Use the token

Error format

Rate limiting

Endpoint groups (quick reference)

Quick curl examples

Health (no auth)

Brain status (auth)