# HivemindOS MiroShark Crowd Simulation

> HivemindOS MiroShark Crowd Simulation is a paid API for AI agents from api.hivemindos.app, paid per call via x402, $1.2/call, status unknown (last checked 2026-10-11).

Simulates how a crowd of people would react to a given prompt, URL, or article, with optional deep research or a prediction market.

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/miroshark/runs.create?utm_source=zero.xyz
- Price: $1.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hivemindos-miroshark-crowd-simulation-ff31570c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZHHZ7AIlUWle5NwuBgO0R

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-miroshark-crowd-simulation-ff31570c -d '<json body>'
```

Example prompt: Run a MiroShark crowd simulation on this article about the Fed raising interest rates — https://example.com/fed-article — and also set up a prediction market asking 'Will the Fed raise rates again in 2025?' with outcome_a being Yes and outcome_b being No, starting at 40% probability.

## When to prefer this

Choose this endpoint when you need to simulate crowd or public opinion on content — a URL, article, or prompt — especially when you want more than simple sentiment analysis and need simulated diverse reactions, optional deep research, or a prediction market framing. Prefer this over generic sentiment APIs when you need crowd-wisdom simulation rather than statistical sentiment scoring.

## Known failure modes

- Malformed or inaccessible URL causes fetch failure
- Prompt or article text below minimum length of 4 characters
- Article text exceeds 190,000 character limit
- Prediction market parameter not properly structured
- Payment of $1.20 USDC on Base fails or is rejected
- Simulation fails mid-run and no charge is applied

## How this service works

MiroShark simulation: a crowd simulation of how people react to a prompt, URL or article, with optional deep research or a prediction market. $1.20 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

Returns a crowd simulation result showing how a diverse population of simulated people would respond to the given prompt, URL, or article. May include aggregated sentiment, individual simulated reactions, deep research findings, and/or prediction market probabilities depending on the options enabled.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "format": "uri"
  },
  "prompt": {
   "type": "string",
   "maxLength": 4000,
   "minLength": 4
  },
  "article": {
   "type": "string",
   "maxLength": 190000,
   "minLength": 4
  },
  "deep_research": {
   "type": "boolean"
  },
  "prediction_market": {
   "description": "A question, or { question, outcome_a, outcome_b, initial_probability }."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-miroshark-crowd-simulation-ff31570c/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)