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.

​
Response

​
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.
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.

​
Response Fields

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