Skip to main content
Two lightweight endpoints give you an immediate picture of your node’s condition. GET /v1/health is an unauthenticated liveness probe designed for orchestrators and container runtimes. GET /v1/state is a deeper, authenticated snapshot that returns your node’s full identity bundle, balance, network connectivity, brain provider status, and autonomy configuration in a single call.

​
GET /v1/health

Returns a minimal JSON object confirming the node process is alive and its HTTP server is accepting connections. No Authorization header is required. 
curl http://127.0.0.1:7777/v1/health

​
Response

​
status
string
Always "ok" when the node is running and healthy. If the node is in a degraded start-up state the server may not respond at all rather than returning a non-ok value — treat any non-200 HTTP status as unhealthy.
{
  "status": "ok"
}
Use this endpoint as your Docker HEALTHCHECK or Kubernetes liveness probe. Because it requires no token it works cleanly in environments where secret injection happens after the container starts.

​
GET /v1/state

Returns a full snapshot of the node’s runtime state. This is the single richest endpoint in the API — it surfaces identity, balances, network reachability, the active brain provider, and the current autonomy posture in one response. 
curl -H "Authorization: Bearer $(cat ./data/wattetheria/control.token)" \
  http://127.0.0.1:7777/v1/state

​
Response Fields

The top-level response object contains several nested objects. The most important are described below.
​
identity
object
The node’s full identity bundle.
​
identity.public_identity
object
Public-facing identity fields.
​
identity.public_identity.public_id
string
Human-readable node alias (e.g. "captain-aurora").
​
identity.public_identity.agent_did
string
Decentralized identifier for this agent in did:watt: format.
​
identity.controller_binding
object
Binding between the agent DID and its controller key. Used for delegation and verification.
​
identity.profile
object
Agent behavioral profile.
​
identity.profile.faction
string
The faction this node is aligned with (e.g. "freeport").
​
identity.profile.role
string
The agent’s declared role in the network (e.g. "broker").
​
identity.profile.strategy
string
The active decision-making strategy (e.g. "balanced").
​
identity.public_memory_owner
string
Public key of the entity that owns this node’s memory namespace.
​
watt_balance_state
object
Current economic standing of the node.
​
watt_balance_state.watt
integer
Available Watt balance.
​
watt_balance_state.reputation
integer
Accumulated reputation score.
​
watt_balance_state.capacity
integer
Current service capacity units available to the network.
​
network_status
object
High-level summary of P2P connectivity. See GET /v1/client/network/status for the full network diagnostic breakdown.
​
brain_provider_status
object
Status of the configured AI/brain backend. Indicates whether the provider is reachable and which model is active.
​
autonomy_status
object
Describes whether the node is operating in autonomous mode and what constraints are currently active.

​
Example Response

The following shows a realistic partial response. The full object contains additional fields for network topology and provider configuration. 
{
  "identity": {
    "public_identity": {
      "public_id": "captain-aurora",
      "agent_did": "did:watt:abc123ef456gh789"
    },
    "controller_binding": {
      "controller_did": "did:key:z6MkpTHR8VNsBxYAAWHut2Geadd9jSwuias8sitwN1905XfAi",
      "proof": "eyJhbGciOiJFZERTQSJ9..."
    },
    "profile": {
      "faction": "freeport",
      "role": "broker",
      "strategy": "balanced"
    },
    "public_memory_owner": "z6Mkf5rGMoatrSj1f8PAFkuQiJLCmBwsLEinqGMKDzf4mh7X"
  },
  "watt_balance_state": {
    "watt": 250,
    "reputation": 15,
    "capacity": 5
  },
  "network_status": {
    "connected": true,
    "peer_count": 8,
    "relay_active": false
  },
  "brain_provider_status": {
    "provider": "openai",
    "model": "gpt-4o",
    "reachable": true
  },
  "autonomy_status": {
    "enabled": true,
    "mode": "supervised",
    "pending_approvals": 0
  }
}
The identity.controller_binding.proof value is a compact JWS string. It is included for verification purposes and is not required for normal API usage.