API

Engine API

Return current agent states, persisted decisions, persistence mode, market state, and heartbeat.

#Endpoint

METHOD	PATH	PURPOSE
GET	/api/engine	Return current agent states, persisted decisions, persistence mode, market state, and heartbeat.

#Parameters

Name	Location / type	Description
—	—	No parameters

#Response

{
  "states": [AgentRuntimeState],
  "decisions": [DecisionEntry],
  "persistence": "durable",
  "marketAvailable": true,
  "updatedAt": "…",
  "heartbeat": { "workerStartedAt": "…", "lastSuccessfulCycle": "…", "lastFailedCycle": null, "lastError": null, "observationCount": 120, "decisionCount": 0, "source": "pm2-worker" }
}

#Errors

Status	Condition
200	Current market cycle available
503	Market source unavailable; state payload may retain durable history

#Cache behavior

Cache-Control: no-store. A request-runtime tick may persist observations when the hosted D1 environment has no separate PM2 worker.

#Example request

curl https://overweight.example/api/engine