关于 nansen-mpp-payment
此技能介绍如何通过独立的 Tempo CLI 使用 MPP 付费调用 Nansen API，适合已使用 Tempo 或不想配置 Base、Solana 钱包的用户。
主要功能
- 01设置 Tempo CLI 钱包
- 02通过 tempo request 调用 Nansen API
- 03处理 MPP 挑战与响应
- 04查询付费端点支持情况
适用场景
- 01无 API 密钥调用 Nansen
- 02通过 Tempo 为 Nansen 微支付
- 03检查端点是否支持 MPP
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/nansen-mpp-payment确认已加载。
详细介绍
MPP / Tempo
Nansen API 支持三种付费访问方式：API 密钥、x402（由 nansen-cli 处理）和通过 Tempo 实现的 MPP（由单独的 tempo CLI 处理）。本技能介绍第三种方式。
nansen-cli 不会为 MPP 凭证签名。当用户想通过 tempo request 调用 Nansen API 时，可使用本技能：例如用户已经在使用 tempo、想要进行小额支付但不想自行管理钱包密钥，或不想为 Base/Solana USDC 钱包充值。
如需使用 API 密钥进行身份验证，请参阅 nansen-wallet-manager。如需使用本地钱包进行 x402 小额支付，请参阅 nansen-trading / nansen-wallet-manager。
何时使用本技能
- 用户提到“MPP”、“tempo”、“Authorization: Payment”或“Payment-Receipt”。
- 用户没有 Nansen API 密钥，也不想设置 Base/Solana 钱包。
- 用户已经通过 tempo 为其他 API 付费，并想通过同一种方式使用 Nansen。
一次性设置
# 1. Install the tempo CLI
curl -fsSL https://tempo.xyz/install | bash
# 2. Log in (creates / unlocks the tempo wallet)
tempo wallet login
# 3. Fund it with USDC on the chain tempo selects for your environment
tempo wallet fund
# 4. Confirm the wallet is ready
tempo wallet whoami
调用 Nansen API
tempo request 会处理完整的 MPP 挑战/响应流程：发送请求；当 API 返回 402 + WWW-Authenticate: Payment ... 时，为 Authorization: Payment 凭证签名；随后重试，并在成功时公开 Payment-Receipt 标头。
# Smart Money netflow
tempo request POST https://api.nansen.ai/api/v1/smart-money/netflow \
--json '{"chains":["solana"],"pagination":{"page":1,"page_size":10}}'
# TGM holders
tempo request POST https://api.nansen.ai/api/v1/tgm/holders \
--json '{"token_address":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","chain":"solana"}'
端点路径和请求格式与 Nansen API 的其他接口相同——运行 nansen schema <command>（无需 API 密钥）查询请求体格式，然后通过 tempo request 调用对应的 /api/v1/... 路径。
发现付费端点
curl https://api.nansen.ai/.well-known/x402
返回 paymentProtocols: ["x402", "mpp"]（当服务端启用了 MPP 时）以及付费资源列表。
MPP 与 x402 的区别
| x402（nansen-cli 原生支持） | 通过 tempo 使用 MPP（本技能） | |
|---|---|---|
| 重试时发送的标头 | Payment-Signature: <base64> | Authorization: Payment <credential> |
| 402 挑战标头 | Payment-Required: <base64> | WWW-Authenticate: Payment ... |
| 成功标头 | (无) | Payment-Receipt: <base64> |
| 钱包 | 本地钱包、Privy 或 WalletConnect——由 nansen-cli 管理 | 由 tempo 管理（单独的 CLI） |
| 链 | Base USDC、Solana SPL USDC、X Layer USDT0 | Tempo 链（生产环境使用主网 USDC，开发环境使用 moderato pathUSD） |
| nansen-cli 代码路径 | src/x402.js 在遇到 402 时自动签名 | 不处理——请直接通过 tempo request 调用 |
注意事项
- MPP 默认不在服务端启用。如果
tempo request返回 402，但没有WWW-Authenticate: Payment，则该端点或环境未启用 MPP——请改用 API 密钥或 x402。 - 不要尝试向
nansen-cli添加--mpp-*标志——受支持的集成方式是“单独使用 tempo”。如果用户要求更紧密的集成，请引导他们查看本技能，并在添加代码前确认需求。 - 每次请求的价格与 x402 相同（1 个积分 ≈ $0.001，含 10 倍加价，例如 1 积分的端点费用为 $0.01）。