Scenarios

Scenarios are pre-built simulation configurations that define agents, initial state, and rules. These endpoints are public and require no authentication.

List Scenarios

GET /v1/scenarios

Returns all available scenarios in a data array of summaries. The list is not paginated. The example shows the first summary, with the remaining summaries omitted.

Response

{
  "data": [
    {
      "id": "standard",
      "label": "Standard",
      "seed": 1207,
      "note": "The default equilibrium."
    }
    // Further scenario summaries omitted
  ]
}

Response Fields

Field	Type	Description
id	string	Unique scenario identifier
label	string	Human-readable name
seed	number	Default random seed
tags	string[]	Optional categorization tags
note	string	Optional brief description

Example

curl https://api.anankelabs.io/v1/scenarios

Get Scenario

GET /v1/scenarios/{id}

Returns the stored configuration for a single scenario. Optional agents, initial state, and rules appear only when the manifest supplies them.

Path Parameters

Parameter	Type	Description
id	string	Scenario identifier

Response

{
  "id": "standard",
  "label": "Standard",
  "seed": 1207,
  "note": "The default equilibrium.",
  "nodeLabels": {
    "A-01": "Q3 Goals",
    "R-02": "Supply Shock"
  }
}

Response Fields

Field	Type	Description
id	string	Unique scenario identifier
label	string	Human-readable name
seed	number	Default random seed
tags	string[]	Optional categorization tags
note	string	Optional brief description
initialState	any	Optional starting-state overrides
agents	Agent[]	Optional agent configurations
agents[].id	string	Agent identifier
agents[].marker	{x, y}	Agent’s initial position
agents[].policy	{lambda?, gamma?}	Optional agent policy with optional numeric values
agents[].attractorPreferences	object	Optional map of attractor names to numeric weights
nodeLabels	object	Optional map of node IDs to labels
rules	object	Optional simulation rule overrides
rules.zeroSumAttractorCapture	boolean	Optional zero-sum attractor capture setting

Errors

Status	Code	When
404	NOT_FOUND	Scenario ID does not exist

Both routes can return 429 RATE_LIMITED or 500 INTERNAL_ERROR. See Error Handling for the error envelope and supplied-credential errors.

Example

curl https://api.anankelabs.io/v1/scenarios/standard