SuperAPI AI 工具集

@1365/xfree02

数据与分析

查看项目

更新于 10-16 06:14

技能介绍

用途:让智能体在不申请 Nansen API key 的情况下获取链上情报。Nansen 在 Starchild 市场上以 x402 按次付费方式出售 54 个端点,调用时用钱包签名支付 USDC,网关返回数据。该技能的价值在于说明每个端点该发什么请求体。

主要能力:references/catalog.json 免费列出全部 54 个端点的价格、必填字段和请求体,可用 catalog 命令按关键词或最高价格检索,用 show 查看单个端点。call 命令发起付费请求,输出单个 JSON 对象,含 success、status、paid、network、payer、settlement、body、error。

使用方式:先运行 python3 skills/xfree02/xfree02.py catalog --search "smart money" 查看目录,再用 python3 skills/xfree02/xfree02.py call /api/v1/perp-screener --json '{"date":{"from":"2026-08-01","to":"2026-08-12"}}' 调用;省略 --json 则用目录示例请求体。所有端点为 POST。价格档位为 30 个 $0.01、19 个 $0.05、4 个 $0.25、1 个 $2.00,$2 为 /api/v1/agent/fast。支持 Base eip155:8453、BSC eip155:56、X Layer eip155:196、Solana。费用上限默认等于该端点标价,可用 --max-usd 提高。退出码:0 支付且 2xx;2 预检拦截、未签名;3 缺少 x402 技能;1 其他失败。

依赖与限制:支付委托给 x402 技能(skills/x402/scripts/buy.py),需先执行 bash skills/x402/setup.sh,否则 call 退出码 3;catalog 与 show 为离线读取,不受影响。钱包需在四条链之一持有 USDC,空钱包会导致 402 循环。这是真实花费:会话首次付费调用前须与用户确认,调用 /api/v1/agent/fast 前必须确认,禁止放入循环;定时或批量使用需先计算价格×每日次数并说明月费用。Nansen 会在结算前校验请求体,422 不收费。请求体由 schema 推导,尚未与实时调用核对,首次调用视为验证;5 个请求体为空 {},部分必填对象未标注子字段。10 个端点为文档真实缺口,非解析失败。重建目录需下载 https://docs.nansen.ai/llms-full.txt 并运行 build_catalog.py,该脚本为离线标准库实现。