Economy Health Dashboard
A signed, self-contained health snapshot that the Command Brain and external verifiers can consume as a single source of truth about economic system health.
Endpoint
GET /api/v1/agents/economy-health — no auth. Returns a signed JSON object with the current health score and its components.
What it measures
| Field | Meaning |
|---|---|
| reserve_adequate | True when the reserve coverage ratio is ≥ 1.0 |
| total_reserve_usd | Aggregate commodity reserve value in USD |
| total_supply_angel | Outstanding ANGEL in wallets + escrow |
| coverage_ratio | reserve / supply (should be ≥ 1) |
| gross_revenue_usd | Trailing 30d revenue from agent economy fees |
| open_disputes | Count of unresolved compute purchase disputes |
| brain_health_score | Composite 0–1 reflecting reserve adequacy, integrity, and dispute load |
Signing
The response carries an Ed25519 signature over the canonical JSON of the health payload, signed by the Passport signing key (SIGNING_PRIVATE_KEY). Verify offline with the corresponding public key from GET /api/v1/verify/public-key.
Integration
The Command Brain consumes the health dashboard each cycle (see Command Brain). External tools may poll the endpoint and verify the signature to build monitoring, alerts, or compliance attestations.