Degenscan Intel

degenscan-intel

面向自主 Agent 的跨资产事件情报。 统一规范化信息流，涵盖所有会推动价格变动的事件——自然事件、监管机构、中央银行、联邦法规、公司文件、交易暂停、链上冲击、预测市场变化——并根据敞口图谱评分，生成各资产的影响；通过 x402 按次使用 USDC 付费，或使用 API 密钥付费。

Agent 不想要 3D 地球仪。他们想要的是只需半美分的 events_since("4h", universe=["NVDA","BTC","CL"])。

规范与设计依据：docs/SPEC.md。

快速开始

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（可流式传输的 HTTP，无状态）：POST http://host:8787/mcp。供本地 Agent 使用的 Stdio：npm run mcp:stdio。

项目内容

层	文件	说明
架构	src/schema.ts	Event、Impact、Asset、Universe（zod）——Agent 使用的约定
资产范围	src/universe/	约 110 种精选股票（标签：sector/hq/rev/input/reg/theme）+ ETF、指数、15 种加密货币、大宗商品、外汇、利率。每日按成交量刷新前 100 名（Nasdaq 筛选器 → Yahoo 回退 → 种子数据）
敞口图谱	src/graph/	约 230 条精选边 + 基于标签生成的边 + 30 个含经纬度的关键设施（晶圆厂、港口、海峡、炼油厂）。propagate() = 加权 BFS，深度为 3
引擎	src/engine/	实体链接（股票代码、名称、国家、监管机构、大宗商品、主题、地理位置→设施）、确定性方向推断、交易时段日历（tradable_now、next_open、美国节假日）
连接器	src/ingest/connectors/	40 个无需密钥的来源：USGS、GDACS、EONET、NHC、NWS、SWPC · SEC EFTS 8-K（按项目）、EDGAR Atom（Form 4/13D/S-1）、SEC/Fed/ECB/BoE/BoJ 新闻稿、Fed 演讲、Federal Register API、FTC、DOJ、FDA、CFTC、FCC、White House、EU Commission、CISA KEV、OFAC、TreasuryDirect · Nasdaq 暂停交易、Nasdaq 财报、PR Newswire、Business Wire、GlobeNewswire、按股票代码获取的 Google News、NHTSA · DefiLlama 黑客事件 + 稳定币供应量、CoinGecko 异常波动、Binance 公告、Coinbase 状态、内存池费用、Polymarket、GDELT DOC
存储	src/store/db.ts	通过 node:sqlite 使用 SQLite（内置于 Node ≥ 22.13，无需原生构建）+ FTS5；按标题指纹进行跨来源佐证；各资产影响索引；来源健康状态；计费日志
服务端	src/server/	Fastify REST + MCP；x402.ts 支付关卡（402 → 验证 → 通过 facilitator 结算）、API 密钥、每日免费额度；pricing.ts

工具与定价

工具	价格	可回答的问题
events_since	$0.005	自 t 以来发生了哪些与我的资产范围相关的事件（过去的 t = 回测）
impact_for	$0.003	对单个资产的净方向性压力 + 来源事件
exposure_graph	$0.002	某项资产受哪些对象影响
regime_snapshot	$0.01	开放的交易场所、24 小时压力排名、高严重性事件、预测市场
explain	$0.02	单个事件的理由
pulse	$0.001	最便宜的探测：最近一小时各类别的事件数、严重性最高的 3 个事件、开放的交易场所
price_for	$0.001	价格探测，无需密钥：Hyperliquid 标记价格/中间价/预言机价格 + Coinbase 现货价格、24 小时变化、基差
funding_alerts	$0.001	当前资金费率极端的永续合约 + 按交易场所预测的资金费率
whale_moves	$0.002	Base/Ethereum 上的大额 USDC/USDT 转账，含交易所标签和资金流标签
polymarket_top	$0.002	最活跃的 Polymarket 市场：赔率、24 小时变化、交易量、流动性
derivs_for	$0.003	单种币的永续合约微观结构（Hyperliquid 公共 API）：资金费率、未平仓量、溢价、按交易场所预测的资金费率、标记 + 事件压力
news_for	$0.002	单项资产的新闻标题，含等级、交叉印证、启发式情绪分析
filings_for	$0.002	单个发行方在 SEC EDGAR 上的文件（8-K、Form 4、13D/G、S-1）
calendar	$0.002	即将发布的宏观数据、FOMC、拍卖、财报（N 天）
brief	$0.10	单项资产的高级单次调用交易前简报（替代六次调用）
oracle_board	$0.002	针对既定问题的校准概率每日看板（BTC/ETH/SOL 目标、FOMC、热门 Polymarket 市场）——已缓存，无需等待
oracle_forecast	$0.25	任意二元问题的校准 YES 概率：基于实时 Intel 数据的大模型 Agent 社群蒙特卡洛模拟 + 以基准率为锚点的专家小组；异步（202 → 免费轮询）；80% 区间、相对市场的优势、驱动因素、承诺哈希。公开 Brier 记录见 /v1/oracle/track-record（免费）
polymarket_context	$0.01	单个预测市场的证据包：当前赔率 + 信息流中与该问题相关的第一手来源事件
universe、sources_status	免费	发现与透明度

免费试用：请求头 X-Free-Trial: 1 → 无需付款，每个 IP 每天可调用 100 次（MCP tools/call 会自动添加）。否则，计费路由会返回含 x402 要求的 402，或接受 X-API-KEY。

**网络：**Base 上的 USDC（eip155:8453），以及在配置后可用的 Solana 主网——两者都会在同一个 402 中提供，通过 PayAI 实现免 Gas。

三种付款方式

用户	方式	端点
自主 Agent，按次付费	x402 v2 — 使用 Base 上的 USDC 响应 402；任何 x402 客户端都会自动处理	任意计费端点
自主 Agent，预付费密钥（无需人工或银行卡）	支付一次 USDC → 获得 { api_key }，附带终身额度：pack_1k $5 / 1,000 次调用 · pack_10k $40 / 10,000 次 · pack_100k $300 / 100,000 次	POST /v1/keys/x402/<pack> → 然后使用请求头 X-API-KEY；通过 GET /v1/keys/me 查看余额
人类操作员，银行卡	Stripe 订阅 Starter $29（每月 10k 次）· Pro $199（每月 200k 次）→ 密钥仅显示一次	GET /v1/plans → 结账 → /v1/keys/claim

面向 Agent 和索引器：/.well-known/x402（资源、价格、payTo）· /openapi.json · /llms.txt · /wallets.json（我们自己的钱包，不计入指标）。安装技能：npx skills add tradewr333-lgtm/degenscan-intel · SDK：npm i @degenscan/intel (packages/js) · pip install degenscan-intel (packages/py)。

Agent 技能：skills/degenscan-intel/SKILL.md（也可通过 /skill.md 访问）——介绍何时调用哪些工具、推荐的循环、如何解读置信度以及如何付款。将其放入 Claude/Cursor 技能文件夹，或让 Agent 使用该 URL。 公开使用指标： /v1/metrics（JSON）· /v1/metrics.csv — 自 2026-09-27 起每周一行：免费/API 密钥/付费调用次数、付费钱包数量、附带链上交易哈希的 USDC 收入、活跃的 Stripe 订阅。所有者和测试钱包均明确列出，且不计入客户和收入。

配置

参见 .env.example。运行时无需任何配置。要启用付费模式，请设置 X402_PAY_TO（Base 地址）；如果使用 Base 主网，还需配置支持它的支付促进方（Coinbase CDP 或可自托管的支付促进方）。INTEL_UA 必须包含联系邮箱——SEC 会屏蔽匿名客户端。

部署（Render）

render.yaml 定义了一个 Web 服务（服务器和调度程序在同一进程中运行，使用持久磁盘存储 SQLite）。其他环境可使用 Dockerfile。

设计原则

1. 优先使用一手来源。 SEC、Fed、USGS、Nasdaq 优先于任何新闻网站。媒体仅用于佐证（corroboration.count），绝不作为源头。
2. 确定性的热路径。 从事件到影响评估之间不使用大模型——延迟 < 200 ms，成本 ≈ 0。只有 explain 可能会用到模型。
3. 所有内容均可审计。 raw_ref 指向源文档；path 显示图谱路径；sources_status 公开可见。
4. 标的范围有版本控制。 每个响应都包含 universe_version，确保回测可复现。
5. 从设计上确保合法。 仅使用公开/政府/发行方数据；不转发实时股票报价；将非官方 API（Nasdaq、Yahoo、Reddit）隔离为尽力而为连接器。

路线图

参见 SPEC §8。下一步：部署并进行实时探测 → 完成真实 x402 结算 ✅ → 注册至各目录（MCP Registry、Smithery、Glama、x402 Bazaar）✅ → 扩展由 10-K 驱动的图谱 → Webhook → 集成 Degenscan bot。

运营方、免责声明与数据许可

由 Marbella Collins LLC 运营（美国佛罗里达州）· [email protected]。由 Renato Pereira Chagas 构建并运营；他负责产品规格、设计和商业决策，并负责运营该服务；代码由 AI 辅助编写（Claude）。

不构成投资建议。 Degenscan Intel 是信息与分析服务。影响评分是基于公开事件的确定性启发式结果，不构成买卖任何资产的建议，也不保证准确性或时效性。您须对自己的交易决策承担全部责任。

数据许可。 所有连接器均读取无需密钥的公开来源；本服务转发经过规范化的事件元数据（标题、时间戳、链接）及其自行计算的衍生评分，绝不批量转发来源内容或实时报价。政府和发行方来源（SEC、Fed、Federal Register、USGS、NOAA、机构新闻稿）均属于公共领域或可免费转发。sources_status 中标记为 尽力而为 的来源使用非官方或受条款限制的端点（Nasdaq 停牌/财报页面、Yahoo 筛选器备用源、CoinGecko 公共 API），并受相应提供方条款约束；这些来源均已隔离，以便在任何来源被移除时服务仍能平稳降级。

致谢

事件来源构想和供应商叠加层概念源自 simplifaisoul 的 OSIRIS（MIT）。本项目与其没有共享代码，也没有共享 UI；它是 OSIRIS 所不具备的数据/Agent 层。

许可证：MIT — © 2026 Marbella Collins LLC / degenscan.io