macro-pulse-x402

Macro Pulse — x402 付费 API

一个受 x402 保护的端点，可为 AI Agent 提供各国计算得出的“经济动能分数”。完全基于免费的公有领域世界银行数据 (https://data.worldbank.org) 构建，不会重新打包任何需要授权或付费的数据源。

功能

GET /macro-pulse/{country_code}（例如 /macro-pulse/US）— 价格：每次调用 $0.02

从世界银行 API 获取 GDP 增长、通胀和失业趋势数据，并综合计算出单一的方向性“动能”分数和标签 （改善／稳定／恶化），同时提供原始指标历史数据以确保透明度。

已在本地测试——确认未附加付款时，支付关卡会正确返回 HTTP 402 和有效的支付要求（scheme=exact、asset=USDC、network=Base），底层数据和评分逻辑也能返回正确的世界银行数据。

要想通过此服务赚取真金白银，你需要先完成以下事项

1. 获取一个 Base 钱包地址（Coinbase Wallet 或配置为使用 Base 的 MetaMask）。USDC 付款会转入此地址。将其设为 PAY_TO_ADDRESS。 切勿向任何人（包括我）透露你的私钥／助记词。

2. 选择测试网还是主网：

   • 测试网（Base Sepolia，NETWORK=eip155:84532）——当前的配置。可安全使用虚拟 USDC 进行测试，不存在真实资金风险。
   • 主网（NETWORK=eip155:8453）——涉及真实资金。要在主网上结算，你需要使用支持主网的 Facilitator。公共的 https://x402.org/facilitator 仅支持测试网——若要使用主网，请注册免费的 Coinbase Developer Platform (CDP) 账户 (https://portal.cdp.coinbase.com)，并使用他们托管的 Facilitator 和 API 密钥。

3. 将其部署到可公开访问的位置（真实的域名／URL，而不是 localhost），这样 Agent 和市场就能找到它——确定钱包和网络选项后，我很乐意协助完成部署。

4. 将其列入发现层——https://www.x402scan.com 或 https://x402.org 的 Bazaar，让 Agent 能自动找到并付费使用。还要添加一个 /.well-known/x402 清单，以支持自动发现。

实际预期

每次调用收费 $0.02，需要达到相当大的调用量（数百到数千次）才能积累出可观的收入。请把它当作一个需要慢慢发展的副业，而不是快速致富的办法——有关切合实际的收入范围，请参阅之前的讨论。

文件

• app.py — 完整的 FastAPI 服务，包含 x402 支付中间件