Pulse402 Oracle

Pulse402 Oracle

为 Agent 提供只读的 Base 市场报价、Polymarket 订单簿/历史记录和抽样代币风险证据。规范服务地址为 https://pulse402-oracle.onrender.com。数据源保留原始观测时间戳，并采用 10 秒采集 TTL；数据过期后会在交付前刷新。结算前会报告提供方故障。

数据源	采集输出	USDC/次调用
/v1/pulse/base-liquidity	观测到的流动性、实际池余额、预热后的实测余额变化，以及受支持池中基于固定区块的 $100/$1,000/$10,000 USDC 报价	0.001
/v1/pulse/polymarket-velocity	实际 CLOB 深度/中间价，以及根据价格历史得出的五分钟概率变动，并分别标注交易所时间和采集时间	0.001
/v1/pulse/threat-intel	对已披露代币样本的 GoPlus 评估、证据哈希和限定范围的文本检查	0.001
/v1/pulse/arb-routes	在一个经验证的 Base 区块上，针对特定金额、使用不同池的往返报价，以及毛利差	0.001

报价是未签名的公开合约读取结果。总执行 Gas、转账税、MEV、成功成交和净盈利能力均无法据此确定。不受支持的池和缺失的证据会明确标出。显示的价格变动不能用于识别巨鲸。文本净化器只会检测已声明的模式，无法保证完全防止注入。空的支出方列表不代表一切安全。

付款

Base 和 Solana 使用 x402 v2 精确 USDC 付款。未付款的请求会返回包含当前服务端要求的 HTTP 402。请使用支持 x402 的客户端；此服务端绝不需要客户的私钥。

• Base 收款地址：0x80E0Ae84679b7f11bE171DaADd492FBECf628cd6
• Solana 收款地址：9wuMysgXwNhtQeqJgGByAiMYc4EjzZ5wUSmnjrrt3ffh
• Solana USDC ATA：DD3A7jaXFeHcif9eYj6Vhomuxypat5Yxi8ow6wxz27yL。在赞助 USDC 转账前，该账户必须已存在；仅有报价并不能证明账户已就绪。
• 使用空 JSON 对象调用 POST /v1/pass/prepay，即可购买 6,000 个额度，价格为 5 USDC，有效期为七天。只有在结算确认后，额度才会生效。
• 购买后，在 X-Pulse-Session 中发送令牌，并为每次交付使用唯一的 Idempotency-Key。使用相同密钥重试相同参数可恢复响应，且不会再次扣除额度。
• 若要恢复按次付费的结果，请使用原始签名授权和完全相同的请求。如果响应显示 charged: "unknown"，切勿签署替代付款。

HTTP、净化器、预付费和 MCP 路由共用一个经过验证的生命周期：验证买方身份、声明操作、验证请求、获取有效且有界的结果、持久化准备信息、仅提交一次结算，然后提交收据/交付记录。含糊不明的结算会保留以供对账，绝不会自动再次提交。已保留的已完成购买可在授权过期后恢复。

请在持久化磁盘上设置 PULSE_PAYMENTS_DB=/app/state/payments.sqlite3。SQLite 使用 WAL、完全同步和所有者隔离的操作状态转换。获批的 Render 磁盘挂载路径为 /app/state。临时存储不适合保存已购买额度，也无法保证在重新部署后恢复。

Agent 发现

/openapi.json、/llms.txt、/skill.md、/.well-known/x402.json、/.well-known/mcp.json、/.well-known/agent-card.json 和 MCP 发现均为公开内容。POST /mcp 接受 JSON-RPC 发现请求和四种付费工具。远程 MCP 连接器提供传输；使用工具仍需要支持 x402 的支付客户端或已购买的会话标头。

免费的 /v1/preview/* 路由公开覆盖范围计数和观测健康状况，不公开定价的市场记录。/health 区分进程健康状况与数据源新鲜度；/version 显示已部署的修订版本。

Cloudflare Worker 会将每条路由代理一次到规范后端。它没有独立的支付引擎、免费工具配额、合成数据源或生成会话令牌的权限。请使用经过身份验证的官方 Wrangler CLI 单独发布 Worker。部署到 Render 不会更新 Cloudflare。

验证

运行 python -m pytest tests -q 和 node --test tests/worker.test.mjs。测试使用隔离的数据库、确定性的未充值加密测试数据和模拟传输，不会提交外部支付。数据源引擎还支持通过无签名的公共数据源验证，无需买家密钥或交易。