Prophecies

Prophecies are predictive outputs generated by the simulation engine. They represent the engine’s forward-looking assessments based on the current simulation state and trajectory.

Prophecies are read-only — they are produced by the engine, not submitted by the caller.

List Prophecies

GET /v1/simulations/{id}/prophecies

Returns a paginated list of prophecies generated for a simulation.

Scope required: simulation:read

Path Parameters

Parameter	Type	Description
id	uuid	Simulation ID

Query Parameters

Parameter	Type	Default	Description
limit	integer	50	Results per page (1–200)
offset	integer	0	Pagination offset
order	string	"asc"	Sort order: "asc" or "desc"

Response

{
  "data": [
    {
      "id": "p1r2o3p4-...",
      "simulationId": "a1b2c3d4-...",
      "data": {
        "predictedPhase": "volatile",
        "confidence": 0.87,
        "horizon": 50
      },
      "createdAt": "2025-06-15T10:36:00.000Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 7
  }
}

Response Fields

Field	Type	Description
id	uuid	Prophecy identifier
simulationId	uuid	Parent simulation
data	object	Prophecy payload (structure varies by engine version)
createdAt	string	ISO 8601 timestamp

Example

curl "https://api.anankelabs.ai/v1/simulations/a1b2c3d4-.../prophecies?limit=10" \
  -H "X-Api-Key: krs_..."