The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Degenscan Intel listing page.
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.
MCP (streamable HTTP, stateless): POST http://host:8787/mcp. Stdio for local agents: npm run mcp:stdio.
| Layer | File(s) | Notes |
|---|---|---|
| Schema | src/schema.ts | Event, Impact, Asset, Universe (zod) — the contract agents consume |
| Universe | src/universe/ | ~110 curated equities (tags: sector/hq/rev/input/reg/theme) + ETFs, indices, 15 crypto, commodities, FX, rates. Daily top-100-by-volume refresh (Nasdaq screener → Yahoo fallback → seed) |
| Exposure graph | src/graph/ | ~230 curated edges + tag-derived edges + 30 critical facilities with lat/lng (fabs, ports, straits, refineries). propagate() = weighted BFS depth 3 |
| Engine | src/engine/ | entity linking (tickers, names, countries, regulators, commodities, themes, geo→facility), deterministic direction inference, session calendar (tradable_now, next_open, US holidays) |
| Connectors | src/ingest/connectors/ | 40 keyless sources: USGS, GDACS, EONET, NHC, NWS, SWPC · SEC EFTS 8-K by item, EDGAR Atom (Form 4/13D/S-1), SEC/Fed/ECB/BoE/BoJ press, Fed speeches, Federal Register API, FTC, DOJ, FDA, CFTC, FCC, White House, EU Commission, CISA KEV, OFAC, TreasuryDirect · Nasdaq halts, Nasdaq earnings, PR Newswire, Business Wire, GlobeNewswire, Google News per ticker, NHTSA · DefiLlama hacks + stablecoin supply, CoinGecko abnormal moves, Binance announcements, Coinbase status, mempool fees, Polymarket, GDELT DOC |
| Store | src/store/db.ts | SQLite via node:sqlite (built into Node ≥ 22.13, zero native builds) + FTS5; cross-source corroboration by title fingerprint; per-asset impact index; source health; billing log |
| Server | src/server/ | Fastify REST + MCP; x402.ts payment gate (402 → verify → settle via facilitator), API keys, free daily quota; pricing.ts |
| Tool | Price | What it answers |
|---|---|---|
events_since | $0.005 | what happened since t that touches my universe (past t = backtest) |
impact_for | $0.003 | net directional pressure on one asset + source events |
exposure_graph | $0.002 | who/what an asset is exposed to |
regime_snapshot | $0.01 | venues open, 24h pressure ranking, high-severity events, prediction markets |
explain | $0.02 | rationale for one event |
pulse | $0.001 | cheapest probe: last-hour event counts by class, top-3 severe, venues open |
news_for | $0.002 | headlines on one asset with tier, corroboration, heuristic sentiment |
filings_for | $0.002 | SEC EDGAR filings on one issuer (8-K, Form 4, 13D/G, S-1) |
calendar | $0.002 | upcoming macro prints, FOMC, auctions, earnings (N days) |
brief | $0.10 | premium one-call pre-trade briefing per asset (replaces six calls) |
polymarket_context | $0.01 | evidence pack for one prediction market: current odds + primary-source events in the feed that bear on the question |
universe, sources_status | free | discovery & transparency |
Free trial: header X-Free-Trial: 1 → 100 calls/day/IP without payment (MCP tools/call gets it automatically). Otherwise priced routes answer 402 with x402 requirements, or accept X-API-KEY.
Networks: USDC on Base (eip155:8453) and, when configured, Solana mainnet — both offered in the same 402, gasless via PayAI.
Three ways to pay
| Who | How | Endpoint |
|---|---|---|
| Autonomous agent, per call | x402 v2 — answer the 402 with USDC on Base; any x402 client does it automatically | any priced endpoint |
| Autonomous agent, prepaid key (no human, no card) | one USDC payment → { api_key } with a lifetime budget: pack_1k $5 / 1,000 calls · pack_10k $40 / 10,000 · pack_100k $300 / 100,000 | POST /v1/keys/x402/<pack> → then header X-API-KEY; balance at GET /v1/keys/me |
| Human operator, card | Stripe subscription Starter $29 (10k/mo) · Pro $199 (200k/mo) → key shown once | GET /v1/plans → checkout → /v1/keys/claim |
For agents & indexers: /.well-known/x402 (resources, prices, payTo) · /openapi.json · /llms.txt · /wallets.json (our own wallets, excluded from metrics). Install the skill: npx skills add tradewr333-lgtm/degenscan-intel.
Agent skill: skills/degenscan-intel/SKILL.md (also served at /skill.md) — when to call which tool, the recommended loop, how to read confidence, how to pay. Drop it into a Claude/Cursor skills folder or point the agent at the URL.
Public usage metrics: /v1/metrics (JSON) · /v1/metrics.csv — one row per week since 2026-09-27: free/API-key/paid calls, unique paying wallets, USDC revenue with on-chain tx hashes, active Stripe subscriptions. Owner and test wallets are listed explicitly and excluded from customers and revenue.
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.
render.yaml defines one web service (server + scheduler in-process, persistent disk for SQLite). Dockerfile for anywhere else.
corroboration.count), never origin.explain is the only place a model may be used.raw_ref points at the source document; path shows the graph route; sources_status is public.universe_version so backtests are reproducible.See SPEC §8. Next: deploy + live probe → real x402 settlement ✅ → registries (MCP Registry, Smithery, Glama, x402 Bazaar) ✅ → 10-K-driven graph expansion → webhooks → Degenscan bot integration.
Operated by Marbella Collins LLC (Florida, USA) · contact@degenscan.io. Built and operated by Renato Pereira Chagas, who specified the product, made the design and commercial decisions and operates the service; the code was written with AI assistance (Claude).
Not investment advice. Degenscan Intel is an information and analytics service. Impact scores are deterministic heuristics over public events; they are not recommendations to buy or sell any asset and carry no guarantee of accuracy or timeliness. You are solely responsible for your trading decisions.
Data licensing. All connectors read public, keyless sources; the service redistributes normalized event metadata (titles, timestamps, links) and its own derived scores, never bulk source content or real-time quotes. Government and issuer sources (SEC, Fed, Federal Register, USGS, NOAA, agency press) are public domain or freely redistributable. Sources marked best-effort in sources_status use unofficial or terms-limited endpoints (Nasdaq halts/earnings pages, Yahoo screener fallback, CoinGecko public API) and are subject to those providers' terms; they are isolated so the service degrades gracefully if any is removed.
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 Marbella Collins LLC / degenscan.io