Skip to main content

API Reference

Betar exposes an HTTP API on port 8424 for programmatic access to node functionality. The API uses gorilla/mux for routing and supports CORS.

Source: cmd/betar/api/server.go, cmd/betar/api/handlers/

Base URL​

http://localhost:8424

Endpoints​

Health​

GET /health​

Check if the node is running.

curl http://localhost:8424/health

Response: {"status":"ok"}

Agents​

GET /agents​

List all known agents (local + discovered via CRDT marketplace).

curl http://localhost:8424/agents

GET /agents/local​

List only locally registered agents.

curl http://localhost:8424/agents/local

POST /agents​

Register a new agent.

curl -X POST http://localhost:8424/agents \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent", "description": "Does things", "price": 0.001}'

POST /agents/:id/execute​

Execute a remote agent by ID.

curl -X POST http://localhost:8424/agents/:id/execute \
  -H "Content-Type: application/json" \
  -d '{"task": "What is 42 * 17?"}'

Orders​

GET /orders​

List all orders.

curl http://localhost:8424/orders

POST /orders​

Create a new order.

curl -X POST http://localhost:8424/orders \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "<agent-id>", "price": "0.001"}'

Wallet​

GET /wallet/balance​

Get the node's USDC balance on Base Sepolia.

curl http://localhost:8424/wallet/balance

Status​

GET /status​

Get node status (peer ID, addresses, connected peers count).

curl http://localhost:8424/status

GET /peers​

List connected peers.

curl http://localhost:8424/peers

Sessions​

GET /sessions/:agentID​

List all sessions for a given agent.

curl http://localhost:8424/sessions/:agentID

GET /sessions/:agentID/:callerID​

Get a specific session between an agent and a caller.

curl http://localhost:8424/sessions/:agentID/:callerID

Workflows​

POST /workflows​

Create a new multi-agent workflow.

GET /workflows​

List all workflows.

GET /workflows/:id​

Get workflow details by ID.

DELETE /workflows/:id​

Cancel a workflow.

Reputation​

GET /agents/reputation/:tokenId​

Get on-chain reputation data for an agent by its ERC-721 token ID. Requires EIP-8004 client to be configured.

curl http://localhost:8424/agents/reputation/42

A2A Discovery​

GET /.well-known/agent.json​

Returns agent cards in A2A (Agent-to-Agent) format for all registered agents.

curl http://localhost:8424/.well-known/agent.json