MiroSharkMiroShark

Endpoints

Poll /status and /report, check /ready and /suggest for free, cancel active runs, and discover the x402 agent skill.

Follow & read runs

Reading a run requires only run_id (no authentication):

RoutePurpose
GET /status/<run_id>JSON status for agents (queued, running, interrupted, resuming, completed, failed, budget_exceeded, cancelled, rejected). Poll every 15-30s.
GET /wait/<run_id>Auto-refreshing HTML progress page for humans; links to /share/<sim_id> on completion.
GET /report/<run_id>?format=md|jsonRaw Markdown or JSON report once completed (409 while still running).
GET /card/<sim_id>.pngCached 1200x630 PNG recap card for social unfurls.
POST /cancel/<run_id>Stops an active run. Requires X-Cancel-Token: <cancel_token>.

Polling tips

  • interrupted and resuming mean the worker is recovering automatically - keep polling at no extra cost.
  • stages in /status is an object keyed by stage name, whereas stages in the 202 response is an array.

Pre-flight & discovery (free)

  • POST /suggest (#preflight-suggest): Free endpoint that turns {"prompt": "stablecoin regulation"} into up to 5 ready-to-run simulation prompts ({ title, pitch, prompt, angle }).
  • GET /health & GET /ready (#preflight-health-and-ready): Always check GET /ready (200 when Postgres + Neo4j are reachable, 503 otherwise) before settling a payment.
  • Discovery & agent manual (#discover): Indexed on agentic.market, x402scan, CDP Bazaar, AgentCash, and Ampersend. Contracts live at GET /openapi.json and GET /skill.md.
# CDP discovery is read-only and unauthenticated:
curl 'https://api.cdp.coinbase.com/platform/v2/x402/discovery/search?query=miroshark'
curl 'https://api.cdp.coinbase.com/platform/v2/x402/discovery/merchant?payTo=0x6cab485fc28ec70d3845113b704d4824e4d2b24f'

SDK Examples

Call POST /run over x402 on Base, Solana, or Monad from Python, TypeScript, Agentic Wallet CLI, or MCP hosts.

Wire Format

Inspect raw x402 v2 PAYMENT-REQUIRED, PAYMENT-SIGNATURE, and PAYMENT-RESPONSE headers and settlement caveats.

On this page

Follow & read runsPre-flight & discovery (free)