# HivemindOS Swarm Multi-Agent Scenario Simulation

> HivemindOS Swarm Multi-Agent Scenario Simulation is a paid API for AI agents from api.hivemindos.app, paid per call via x402, $1.5/call, status unknown (last checked 2026-10-09).

Runs a multi-agent swarm simulation of a scenario from a prompt, URL, or article, with optional adversarial 'theater' mode that argues the opposing outcome

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/swarm/runs.create?utm_source=zero.xyz
- Price: $1.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hivemindos-swarm-multi-agent-scenario-simulation-5213b5b5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DU0ZtJiCutXmaewyQ-ewE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hivemindos-swarm-multi-agent-scenario-simulation-5213b5b5 -d '<json body>'
```

Example prompt: Run a quick swarm simulation on this scenario: 'A major central bank raises interest rates by 2% in a single meeting — what happens to global equity markets?' and also use theater mode to argue the opposing outcome.

## When to prefer this

Choose this endpoint when you need multi-agent adversarial reasoning or scenario simulation — especially when you want not just an analysis but a structured debate with opposing outcomes modeled. Prefer over single-model analysis when the scenario is complex, contested, or benefits from swarm consensus. Theater mode is uniquely suited for stress-testing plans or identifying blind spots. Use over MiroShark (crowd simulation) when you want structured argumentation rather than crowd reaction modeling.

## Known failure modes

- Seed text too short (under 4 characters) or too long (over 200,000 characters) returns validation error
- Invalid URL format for url seedType causes failure
- Payment of 1.50 USDC on Base not authorized or insufficient balance results in payment failure
- URL provided is inaccessible or returns non-200 status
- Simulation times out for extremely complex or long article inputs
- Invalid 'kind' enum value (not 'quick' or 'theater') causes schema rejection

## How this service works

Hivemind Swarm scenario: a multi-agent simulation of a scenario from a prompt, URL or article; Theater also argues the opposing outcome. $1.50 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

A structured swarm simulation result containing the agents' synthesized analysis of the scenario and, in theater mode, a counterargument or opposing outcome modeled by the adversarial agent crew. Output includes scenario conclusions, supporting reasoning, and contrasting positions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "kind": {
   "enum": [
    "quick",
    "theater"
   ],
   "type": "string"
  },
  "seed": {
   "type": "string",
   "description": "prompt: 4-4000 characters; url: http or https; article: 4-200000 characters."
  },
  "title": {
   "type": "string",
   "maxLength": 200
  },
  "seedType": {
   "enum": [
    "prompt",
    "url",
    "article"
   ],
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-swarm-multi-agent-scenario-simulation-5213b5b5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hivemindos.app](https://www.zero.xyz/host/api.hivemindos.app/llms.txt)
