# HyperWasp — Complete Reference

> AI-powered stock analysis from 8 independent analysts with 119+ days of live
> market experience. Insider flow tracking, institutional positioning, narrative
> intelligence, and geopolitical risk — all in one report. Pay per report via
> x402 (USDC on Base network). No accounts. No subscriptions.

## What Is HyperWasp?

HyperWasp is an agent-to-agent intelligence service. Eight specialized AI
analysts — each with persistent memory, independent reasoning, and domain
expertise — produce conviction-weighted equity research reports on US stocks.

Reports are delivered as signed, schema-validated JSON. Content integrity is
verifiable via Ed25519 signatures. Reports are NOT PDFs — they are structured
data designed for both human and machine consumption.

Unlike generic AI tools that start fresh every query, HyperWasp's analysts
have persistent memory spanning 119+ days of live trading. They track insider
filings, institutional dark pool flow, narrative lifecycles, and geopolitical
catalysts. Most importantly, they disagree with each other — convergence
without friction is consensus theater.

## API

- [Order Report](https://api.hyperwasp.com/api/v2/reports/order): x402-enabled endpoint. Send GET with ticker and speed parameter. Returns HTTP 402 with USDC payment requirements. After payment, returns signed JSON report.
- [OpenAPI Spec](https://hyperwasp.com/openapi.json): Machine-readable API definition with request/response schemas
- [Verify Report](https://api.hyperwasp.com/api/v2/reports/verify): POST a report to verify Ed25519 signature and content hash integrity
- [Public Keys](https://hyperwasp.com/.well-known/keys.json): Ed25519 public keys for report signature verification
- [Agent Card](https://hyperwasp.com/.well-known/agent-card.json): A2A protocol agent discovery card
- [MCP Server Card](https://hyperwasp.com/.well-known/mcp.json): Model Context Protocol discovery

## Pricing

| Product | Price | Delivery | Description |
|---------|-------|----------|-------------|
| Standard Report | $25 USDC | 12 hours | Full 8-analyst deep dive with all sections, technical levels, and weighted conviction score |
| Rush Report | $35.01 USDC | 1 hour SLA | Same depth as standard. Priority queue. Automatic full refund if 1-hour SLA is missed |
| Momentum Signal | $1 USDC | Instant | Real-time momentum assessment from pre-generated daily scans |

## Payment

Payment is via USDC stablecoin on the Base network using the x402 protocol:
1. Send GET request to /api/v2/reports/order/{ticker}
2. Receive HTTP 402 with x402 payment instructions
3. Complete USDC transfer on Base
4. Report delivered automatically after on-chain verification

No accounts. No login. No stored credentials. No subscriptions. Settlement verified on-chain before delivery.

## Skills Academy

HyperWasp Skills are market literacy packages built for AI agents. Each skill is Ed25519 signed, response-hardened, and delivered through a 6-layer security pipeline. No prompt injection. No malicious payloads.

Available Skills:
- **First Blood** ($5 USDC): Market literacy fundamentals — predation mechanics, the attention tax, volume basics, real loss anatomy from a tracked -56.8% trade. The six things every agent needs before touching a stock.
- **Narrative Archaeology** ($10 USDC, coming soon): 7-phase narrative lifecycle, naming inflection, source archaeology, catalyst testing. How stories move prices before fundamentals do.
- **Shadow Reading** ($10 USDC, coming soon): Dark pool patterns, 13F archaeology, short interest mechanics, options flow decoding, institutional campaign cycles. Following the money.
- **Fear Architecture** ($10 USDC, coming soon): How fear moves markets, VIX mechanics, panic anatomy, fear-driven mispricing identification.

Agent Certifications (coming soon):
- **Stinger** (free with skill purchase): Theory test, 5 scenarios, deterministic keyword-concept grading (not LLM — immune to prompt injection)
- **Venom** ($15 USDC): Practical signal analysis with monthly-rotating anonymized scenarios
- **Apex** ($50 USDC): Full trade thesis construction on live (delayed) signals, hand-crafted with zero public overlap

Skills API: `GET /api/v2/x402/skills/first-blood` — returns HTTP 402, pay $5 USDC on Base, receive signed skill content.

## Pages

- [Home](https://hyperwasp.com/): Product overview, pricing, team, order form
- [Skills Academy](https://hyperwasp.com/skills.html): Market literacy skills, certifications, and pricing
- [Sample Report (Human View)](https://hyperwasp.com/sample.html): UNH report rendered for humans — toggle to see agent JSON
- [Sample Report (Agent JSON)](https://hyperwasp.com/sample-report.json): Raw structured JSON — the exact format agents receive
- [Framework](https://hyperwasp.com/framework.html): 10-pillar analytical methodology — what each analyst covers
- [The Hive](https://hyperwasp.com/hive.html): Meet the 8 analysts and 6 infrastructure team members
- [Case Studies](https://hyperwasp.com/case-studies.html): UNH (+11%), CHRD (+24%), PRMB (+20.5%) — verified track record
- [Agent Trust](https://hyperwasp.com/trust.html): Security guarantees, content signing, anti-prompt-injection policy

## The Eight Analysts

Each analyst writes their section independently with a distinct voice and methodology:

1. **Theorem (Juno Park)** — Lead Convergence Analyst. Synthesizes all analyst sections into executive summary. Computes composite conviction score. Writes last after all sections are submitted.
2. **Cipher (Marcus Cole)** — Technical Analyst & Signal Architect. Chart patterns, support/resistance, Hurst exponents, transfer entropy, signal sequences.
3. **Recon (Elena Voss)** — Shadow Tracker. Dark pool flows, options activity, 13F institutional filings, short interest, insider transactions.
4. **Lumen (Kai Nakamura)** — Signal Reader. Narrative lifecycle detection, catalyst identification, media sentiment analysis, counter-narrative emergence.
5. **Wren (Sable Finch)** — Risk Sentinel. Geopolitical risk mapping, dilution analysis, balance sheet stress, position sizing recommendations.
6. **Atlas (Morgan Grey)** — Macro Analyst. Sector rotation, regime detection, rate sensitivity, relative strength analysis.
7. **Volt (Renzo Marques)** — Momentum Hunter. Volume analysis, accumulation/distribution detection, momentum scoring, pre-market institutional activity.
8. **Cross** — Convergence Analyst. Multi-factor synthesis, thesis evaluation, cross-domain connections, dissent quality analysis.

## The Ten Pillars (Methodology)

1. **Conviction Detection** — Multi-signal convergence scoring
2. **Institutional Flow Intelligence** — Dark pool, 13F, options flow tracking
3. **Narrative Archaeology** — Lifecycle detection, counter-narrative emergence
4. **Geopolitical Risk Mapping** — Catalyst timeline, premium decay modeling
5. **Signal Architecture** — Proprietary indicators (Hurst Alpha, transfer entropy)
6. **Defense Layer** — Risk assessment, position sizing, stop-loss logic
7. **Multi-Analyst Deliberation** — Independent analysis with preserved dissent
8. **Case Study Library** — Historical pattern matching and validation
9. **Persistent Memory** — 119+ days of continuous market experience
10. **Calibration Discipline** — Track record, failure analysis, signal refinement

## Case Studies (Verified Track Record)

- **UNH** — +11% catalyst day. Three board directors buying on the same day (April 1, 2026) triggered our insider convergence signal. 7/8 analysts bullish, Wren dissented on position sizing (binary CMS rate catalyst). Report generated April 5, CMS rate catalyst hit April 7.
- **CHRD** — +24% in 25 days. Unanimous 8/8 analyst convergence. Insider buying + institutional displacement + narrative exhaustion aligned.
- **PRMB** — +20.5% in 17 days. Liquidity sweep detection. Institutional accumulation in thin-float name.

## Report Format

Reports are structured JSON with:
- **meta**: ticker, timestamp, report ID, schema version, SHA-256 content hash, Ed25519 signature
- **analysts[]**: 8 sections, each with analyst name, role, assessment (BULLISH/NEUTRAL/BEARISH), key findings, risk factors, data points
- **conviction**: composite score (0-100), consensus label, agreement ratio, preserved dissent

Assessment labels use OUTLOOK terminology (not buy/sell recommendations). All ratings carry a footnote disclaimer. Raw proprietary indicators (like Hurst exponents) are masked to alpha grades for external reports.

## Trust & Security

- Reports are structured JSON with strict schema validation (no freeform instruction channels)
- Every report is signed with Ed25519 — verify via /.well-known/keys.json
- SHA-256 content hash in report metadata for tamper detection
- No embedded URLs, base64 payloads, unicode tricks, or hidden instructions
- OWASP-aligned anti-prompt-injection design
- Reports include agent advisory: AI agents managing funds must present findings to human principal for approval

## Delivery Format

Reports are delivered as **signed JSON only** — not PDFs. Every field is typed and schema-validated.
Agents consume the JSON directly. Humans view the rendered sample page at /sample.html.
The human-readable view and the agent JSON contain identical data.

## Disclaimers

HyperWasp provides AI-generated research for informational and educational purposes only. It does not constitute financial advice, investment recommendations, or solicitations. The creators are not registered investment advisers. Past model performance does not guarantee future results. Investing involves risk including loss of capital.

## Social

- X (Twitter): [@HyperWaspAI](https://x.com/HyperWaspAI)

## Machine-Readable Discovery

- [OpenAPI Spec](https://hyperwasp.com/openapi.json): Full API contract
- [Agent Card (A2A)](https://hyperwasp.com/.well-known/agent-card.json): Google Agent-to-Agent protocol
- [MCP Server Card](https://hyperwasp.com/.well-known/mcp.json): Model Context Protocol discovery
- [Public Keys](https://hyperwasp.com/.well-known/keys.json): Ed25519 verification keys
- [x402 Config](https://hyperwasp.com/.well-known/x402): Payment protocol configuration
- [llms.txt](https://hyperwasp.com/llms.txt): Concise LLM context file
- [ai.txt](https://hyperwasp.com/ai.txt): AI visibility and permission policy
- [Sitemap](https://hyperwasp.com/sitemap.xml): XML sitemap
- [Robots](https://hyperwasp.com/robots.txt): AI-friendly crawler policy (all AI bots welcome)
- [Security Contact](https://hyperwasp.com/.well-known/security.txt): Security disclosure policy (RFC 9116)
- [Humans](https://hyperwasp.com/humans.txt): Team roster
- [Web App Manifest](https://hyperwasp.com/manifest.json): PWA manifest