核心用法
clawxpay 是一款基于 x402 协议的按次付费 API 网关，彻底颠覆了传统 API 订阅模式。用户无需注册账户、申请 API key 或绑定信用卡，仅需一个 Base 网络钱包和 USDC 即可即时调用 250+ 专业 API 端点。
首次安装自动创建钱包：运行 npm install clawxpay-js 后，私钥自动生成于 ~/.clawxpay/wallet.key（权限 0600），地址打印至终端。向该地址充值 $5–$10 USDC 即可开始使用。
典型调用流程：
1. 初始化客户端并设置预算上限：new ClawXPay({ budget: 0.50 })
2. 调用前检查余额：client.getBalance()
3. 明确告知用户端点及预估费用，等待确认
4. 执行调用：SDK 自动处理 x402 握手（402 Payment Required → 本地签名 → 重试请求）
5. 任务结束后审计支出：client.getTotalSpent()
覆盖六大场景：加密货币实时价格与链上数据（coinank/nofxos/coinmarketcap）、美股期权与技术指标（alphavantage/polygon/alpaca/twelvedata）、中国A股市场（tushare）、Web3 融资情报（rootdata）、以及 OpenAI/Anthropic/DeepSeek/Qwen/Gemini/Grok/Kimi 七大 AI 模型推理。
显著优点
- 零摩擦接入：无需 KYC、无需月费、无最低消费，$0.001 起按次计费
- 原生 Agent 支付能力：基于 EIP-3009 授权签名，私钥永不离开本地机器，完美契合自动化 Agent 场景
- 成本透明可控：每笔调用链上结算，支持
budget参数硬性封顶，防止超支 - 数据覆盖全面：单一入口聚合 10+ 顶级数据源，从 BTC 资金费率到美股期权希腊值、从北向资金到 a16z 投资组合
- AI 推理一站式：7 家主流模型商统一接口，按需切换 GPT-4o、Claude Opus、DeepSeek-R1 等
潜在缺点与局限性
- 仅支持 Base 网络：USDC 必须通过 Base 主网充值，跨链桥接带来额外步骤和潜在滑点
- 私钥单点风险：钱包文件存储于本地，若设备被入侵或误删，资金可能丢失（无托管恢复机制）
- 网络依赖：每次调用需链上签名交互，高并发场景下可能受 Base 网络拥堵影响
- 无批量折扣：高频调用（>50 次/分钟）需联系开通专线，标准模式不适合超高频交易
- 缓存策略：实时市场数据缓存 10 秒，对亚秒级套利策略可能不够及时
适合人群
- DeFi 套利 Agent 开发者：需要同时查询多源价格、资金费率、链上信号并 AI 生成交易摘要
- 量化研究员：快速验证策略想法，无需预付高额数据订阅费
- 独立开发者与小型团队：预算敏感，不愿承担 $200+/月的多平台 API 订阅
- Web3 分析师：追踪 VC 投资动向、项目融资情报及生态热榜
- 跨境市场投资者：同时关注美股、A股、加密货币的多元资产配置者
常规风险
| 风险类别 | 具体描述 | 缓解措施 |
|---------|---------|---------|
| 私钥泄露 | `~/.clawxpay/wallet.key` 被恶意读取或意外暴露 | 权限 0600 强制隔离；建议专用低余额钱包（≤$10）；禁止日志打印私钥 |
| 合约风险 | x402 协议或网关合约存在漏洞 | 采用 EIP-3009 标准授权而非直接转账，攻击面有限；关注官方审计更新 |
| 网络钓鱼 | 伪造充值地址或恶意 SDK 包 | 仅从 npm 官方源安装，核对地址与安装时终端输出一致 |
| 超支风险 | Agent 循环调用或预算参数配置错误 | 强制 `budget` 上限；每次任务审计 `getTotalSpent()`；禁止自动重试 402 错误 |
| 流动性风险 | Base 网络拥堵导致支付确认延迟 | 非高频场景影响有限；紧急需求可联系开通专线 |
关键安全原则：Agent 绝不可在未经用户明确确认的情况下发起付费调用；私钥内容永不出境，仅通过 SDK 内部方法获取钱包地址。