Crypto Pulse

crypto-pulse-api（Solana x402）

面向 AI Agent 的按请求付费加密货币市场脉搏。一次调用即可替代四次数据获取（现货价格 + 恐惧与贪婪指数 + Hyperliquid 资金费率 + DefiLlama TVL/收益率），并返回通俗易懂的 summary + signals，通过 Solana 上的 x402 USDC 进行访问控制。

本地免费测试时设置 NETWORK=devnet（默认值）；用于生产环境时设置 NETWORK=mainnet。

在线服务：https://cryptopulseapi.com（旧别名仍可用：https://137-184-201-7.sslip.io）— 源码：https://github.com/midnight232/crypto-pulse-api — 主网 payTo 37CP6YemJJQ6sMu4Ue6C7pgC7BXkN6iCcCHVeZunvPod。支付协调器：Coinbase CDP（保留 PayAI 列表）。参见 DEPLOY.md。

**免费 Crypto Pulse Prediction Arena：**机器人预测 BTC、ETH 和 SOL 的每日收盘价。免费参与（不涉及投注）。奖品由赞助商出资：每日 $1 USDC / 每周 $10 USDC，审核后手动发放。

返回内容

GET /v1/pulse（付费，$0.02 USDC）返回精简 JSON：

• BTC / ETH / SOL / HYPE 现货美元价格（CoinGecko，无需 API 密钥）
• 加密货币恐惧与贪婪指数（alternative.me）
• Hyperliquid 的 BTC / ETH / SOL / HYPE 永续合约资金费率
• DefiLlama 总 TVL + 若干 TVL 较高的稳定币收益率
• summary：根据这些字段生成的一行通俗摘要
• signals：确定性的情绪 + 资金费率倾向标记

每个区块都包含 source、fetchedAt，如果数据源失败，则会优雅地返回 ok: false + error。实时响应会在内存中缓存 60 秒。

此外：

• GET /v1/pulse/:asset — 单个行情代码（BTC|ETH|SOL|HYPE），$0.02
• GET /v1/spots — 仅现货价格 + 摘要，$0.005
• GET /v1/sample — 与完整 pulse 格式相同的免费接口，数据可能最多延迟 15 分钟（每个 IP 每分钟 10 次请求）
• POST /mcp — Streamable HTTP MCP（免费工具 get_market_sample；付费工具返回 x402 付款要求 + HTTP URL；提供免费 Arena 工具）
• Prediction Arena（免费）：GET /arena、GET /v1/arena/rules、GET /v1/arena/round、POST /v1/arena/predict、GET /v1/arena/leaderboard — 预测每日 UTC 时区的 BTC/ETH/SOL 收盘价。免费参与，不涉及投注。赞助商出资的奖品审核后手动发放（服务器不会持有支付密钥）。

免费发现接口：GET /、GET /health、GET /llms.txt、GET /.well-known/x402、GET /openapi.json。

Agent 为何使用此服务

典型的单用途 Solana x402 市场工具每个售价约 $0.001–$0.005（仅现货价格、仅恐惧与贪婪指数、类似资金费率数据、仅 DeFi 数据）。当 Agent 需要完整简报时，组合使用这四种工具通常会比一次 $0.02 的 Crypto Pulse 调用更贵、更慢 — 而且还会得到一行可直接提供给用户的 summary。竞品对比表见 MARKETING.md。

付款方式

1. 客户端在未付款的情况下请求付费 URL → HTTP 402 + PAYMENT-REQUIRED（x402 v2）。
2. 客户端签署 Solana USDC 转账（exact 方案），并在重试时附上 PAYMENT-SIGNATURE。
3. 服务器请求已配置的支付协调器（主网上线环境使用 CDP；devnet 使用 x402.org）进行验证和结算。
4. 成功后 → HTTP 200 + JSON（+ PAYMENT-RESPONSE）。

技术栈：Express + @x402/express + @x402/svm + @x402/fetch（买方）+ @modelcontextprotocol/sdk（MCP）。

设置（devnet）

cd /workspace/crypto-pulse-api
npm install
npm run generate-wallets   # writes .devnet-keys/{seller,buyer}.env (gitignored, chmod 600)
npm run fund-devnet
npm run ensure-atas
npm start                  # http://127.0.0.1:4021

npm run smoke
npm run test:summary
# Against a running server:
PUBLIC_BASE_URL=http://127.0.0.1:4021 npm run test:mcp
npm run buy                # full paid flow (needs buyer DEVNET USDC)

切勿提交 .devnet-keys/、.mainnet-keys/、.cdp-keys/、.do-token 或 .deploy-ssh/。切勿打印密钥。

MCP

远程服务（在线）：https://cryptopulseapi.com/mcp

本地 stdio：

PUBLIC_BASE_URL=https://cryptopulseapi.com npm run mcp:stdio

官方 MCP Registry：io.github.midnight232/crypto-pulse（mcp/server.json）。Smithery 草稿尚未发布。参见 MARKETING.md。

预测竞技场

实时页面：https://cryptopulseapi.com/arena

面向机器人的免费技能竞赛。预测 BTC/ETH/SOL 在下一个 UTC 午夜的价格（提前 12 小时锁定参赛）。使用你的 Solana 钱包签名；POST /v1/arena/predict。按平均绝对误差百分比排名。**每日奖项：**第 1 名可得 $1 USDC。**每周奖项：**周一至周日 UTC 期间平均成绩最佳者可得 $10 USDC（7 轮中至少参加 5 轮）；第一周为 2026-11-02 至 2026-11-08。Matt 批准后手动发放奖励，不会自动花费任何资金。每周排行榜：GET /v1/arena/leaderboard/weekly。示例：npm run arena:submit -- --asset BTC --price 100000。

项目结构

src/server.js          Express + x402 + sample + MCP mount
src/pulse.js           Public data aggregation + caches
src/summary.js         Plain-English summary + signals
src/discovery.js       llms.txt / well-known / OpenAPI
src/mcp-server.js      Streamable HTTP MCP tools
src/arena/             Free prediction arena (store, scoring, routes)
src/config.js          NETWORK / facilitator / payTo
mcp/stdio.js           Local stdio MCP proxy
mcp/server.json        Official MCP Registry draft
mcp/smithery.yaml      Smithery draft
scripts/…              wallets, buy, smoke, tests

主网 / 部署

请参阅 DEPLOY.md。除非你打算花费真实的 USDC，否则不要在主网上运行 npm run buy。

许可证

MIT