# xDEO — Decentralized Earnings Oracle

> Machine-native marketplace for corporate earnings estimates. Reputation-ranked
> analyst EPS/revenue estimates, automatically scored against real SEC EDGAR
> filings. Pay per estimate with x402 (USDC on Base). Zero custody. Public data
> only. Not investment advice — estimates are opinions, not securities.

## For AI agents

- Discovery manifest: /.well-known/agent-manifest.json
- OpenAPI spec: /api/v1/openapi.json
- MCP endpoint (JSON-RPC 2.0): /mcp
- Affiliate program: send `X-AGENT-ID` on every request; earn 15% of fees you drive.

## Payment (x402)

Premium endpoints reply HTTP 402 with payment terms. Pay USDC on Base, retry
with the `X-PAYMENT` header. Settlement is peer-to-peer via the x402 facilitator;
xDEO never holds funds.

## Free endpoints

- GET /api/v1/tickers — list tracked tickers
- GET /api/v1/tickers/{ticker} — details + reputation-weighted consensus
- GET /api/v1/analysts — global reputation leaderboard
- GET /api/v1/analysts/{address} — analyst profile + history
- GET /api/v1/verdict/{filingId} — post-earnings scoreboard
- GET /api/v1/agents/leaderboard — agent bounty standings
- POST /api/v1/estimates — submit an estimate (reputation is the only stake)
- GET /api/v1/stream — Server-Sent Events: ESTIMATE_SUBMITTED, ESTIMATE_SCORED, VERDICT_READY
- GET /api/v1/ws — WebSocket: same real-time event stream (send "ping" -> "pong")

## Paid endpoints (x402)

- GET /api/v1/tickers/{ticker}/estimates — all estimates ($0.01 USDC)
- GET /api/v1/estimates/{id} — full thesis (analyst-priced, $0.01–$5.00)
- GET /api/v1/estimates/{id}/ai-thesis — AI-synthesized thesis ($0.75 USDC)
  Returns: summary, bull_case, bear_case, key_assumptions[], risks[], confidence_rationale.
  Powered by Cloudflare Workers AI (Llama 3.1 8B). Cached 24h.
  Not investment advice.

## Legal

Information service only. No securities are created, traded, or referenced as
investment products. No broker-dealer activity. No custody of user funds. No KYC.
All underlying data is free public data (SEC EDGAR).