degenscan-intel

Cross-asset event intelligence for autonomous agents. One normalized feed of everything that moves prices — natural events, regulators, central banks, federal rules, corporate filings, trading halts, on-chain shocks, prediction-market shifts — scored against an exposure graph into per-asset impacts, and sold per call in USDC via x402 or by API key.

Agents don't want a 3D globe. They want events_since("4h", universe=["NVDA","BTC","CL"]) for half a cent.

Spec and rationale: docs/SPEC.md.

Quick start

npm install                     # Node ≥ 22.13 required (node:sqlite)
cp .env.example .env            # optional; runs keyless in free mode by default
npm run probe                   # hit every connector once, dry-run, report reachability + sample scored events
npm run dev                     # ingest scheduler + MCP (POST /mcp) + REST (/v1) on :8787

curl 'localhost:8787/v1/events?since=4h&universe=NVDA,TSM,BTC&min_confidence=0.2'
curl  localhost:8787/v1/impact/NVDA?since=24h
curl  localhost:8787/v1/graph/MSTR
curl  localhost:8787/v1/regime
curl  localhost:8787/v1/sources

MCP (streamable HTTP, stateless): POST http://host:8787/mcp. Stdio for local agents: npm run mcp:stdio.

Related MCP server: x402nano

What's inside

Tools & pricing

Free quota: 100 calls/day/IP without payment. Then 402 with x402 requirements, or X-API-KEY.

Configuration

See .env.example. Nothing is required to run. For paid mode set X402_PAY_TO (Base address) and, for Base mainnet, a facilitator that supports it (Coinbase CDP or self-hosted). INTEL_UA must include a contact e-mail — SEC blocks anonymous clients.

Deploy (Render)

render.yaml defines one web service (server + scheduler in-process, persistent disk for SQLite). Dockerfile for anywhere else.

Design principles

1. Primary sources first. SEC, Fed, USGS, Nasdaq before any news site. Media is corroboration (corroboration.count), never origin.

2. Deterministic hot path. No LLM between event and impact — latency < 200 ms, cost ≈ 0. explain is the only place a model may be used.

3. Everything auditable. raw_ref points at the source document; path shows the graph route; sources_status is public.

4. Universe is versioned. Every response carries universe_version so backtests are reproducible.

5. Legal by construction. Only public/government/issuer data; no real-time equity quote redistribution; unofficial APIs (Nasdaq, Yahoo, Reddit) isolated as best-effort connectors.

Roadmap

See SPEC §8. Next: deploy + live probe → real x402 settlement → registries (Smithery, Glama, x402 Bazaar) → 10-K-driven graph expansion → webhooks → Degenscan bot integration.

Credits

Event-source ideas and the supplier-overlay concept trace to OSIRIS by simplifaisoul (MIT). This project shares no code with it and no UI; it is the data/agent layer OSIRIS never had.

License: MIT — © 2026 Edutech Wise FZCO / degenscan.io