Skip to content

GET /health

Free

The gateway’s health: whether it can serve and take payment, and how fresh its data feeds are. No payment required. Not rate limited.

GET https://api.cerebruspulse.xyz/health

No parameters.

FieldTypeDescription
statusstringok, or degraded when the engine, payments or the settlement ledger is not working
enginestringavailable or missing
paymentsstringactive, or DOWN (paid endpoints fail closed)
ledgerstringwritable or NOT WRITABLE (the settlement record)
kill_switchstringenabled (serving) or disabled (paid endpoints answer 503)
a2astringenabled
a2a_paymentstringhttp route only: A2A names the HTTP endpoint and payment happens there
networksarrayPayment networks: eip155:8453 (Base), plus Solana when its rail is on
paid_routesnumberPaid endpoints currently priced
engine_poolstringwarm, or spawn-per-request (fallback)
engine_workersarrayPer-worker status of the engine pool
settlements_since_startnumberPayments settled since the gateway started
feedsobjectAge of each upstream data feed, as the stale-feed gate sees it
concurrencyobjectin_use and max concurrent requests; a full gauge means paid routes answer 429
versionstringGateway API version
  • If payments is not active, paid endpoints answer 503 and quote no price (they fail closed).
  • If kill_switch is disabled, paid endpoints answer 503 with retry_after: 3600.
  • A feed past its age budget makes the endpoints that read it answer 503 until it is fresh again.
  • Use this endpoint for uptime monitoring and as a check before a batch of paid requests.