Quickstart

Pay-per-run overviewCopy Anchor Link

https://x402.miroshark.xyz exposes MiroShark over the HTTP 402 Payment Required standard (x402 v2). Your agent sends a POST /run request, signs a $1.00 USDC transfer on Base, Solana, or Monad, and receives a run_id and share URL where a full simulation report appears in ~10 minutes.

• Flat $1.00 USDC (amount: "1000000"): No subscription, metering, or per-token billing.
• No account or API key: Your wallet signature is the only credential.
• Zero gas needed: Settlement gas is sponsored on all three chains by the Coinbase CDP facilitator (Base + Solana) and the Monad facilitator (Monad).

POST /run ($1 USDC) -> ingest (~8s) -> ontology (~10s) -> graph_build (~11s)
                    -> prepare ~25 personas (~70s) -> simulate 10 rounds (~6-18m)
                    -> cited report + share_url

POST /run seeds & walletsCopy Anchor Link

Provide exactly one seed field (prompt, url, or article) in the JSON body, plus an optional prediction_market:

{
  "prompt": "How will developers react if OpenAI releases GPT-6 next month?",
  "prediction_market": {
    "question": "Will GPT-6 top the coding leaderboard within 30 days?",
    "outcome_a": "YES",
    "outcome_b": "NO",
    "initial_probability": 0.65
  }
}

• prompt (6-4000 chars): Runs a live-web deep-research sweep before graph build to ground current actors and facts.
• url: Fetches and simulates the article at the given URL.
• article (400-200000 chars): Simulates raw document text directly.
• prediction_market (optional): Pass a question string or { question, outcome_a, outcome_b, initial_probability } to pin the Polymarket AMM.

Seeds are validated before settlement on the paid retry (400 invalid_input or url_unreachable never charges you).

Receiving wallets (accepts[])Copy Anchor Link

Builder codes (10% revenue share)Copy Anchor Link

Attach X-Builder-Code: bc_yourcode on POST /run to route 10% of every Base-settled $1 run to an immutable per-builder 0xSplits contract on Base (X-Builder-Code-Status: resolved). See www.x402aff.xyz/docs for full builder and seller integration details.