Nansen Mpp Payment

MPP / Tempo Nansen API 提供三种付费访问方式：API key、x402（由 nansen-cli 处理）以及通过 Tempo 的 MPP（由独立的 tempo CLI 处理）。本技能介绍第三种。nansen-cli 不会为 MPP 凭证签名。 当用户因已使用 tempo、希望使用微支付且无需自行管理钱包私钥，或不想为 Base/Solana USDC 钱包充值而想调用 Nansen API 时，请使用本技能。 API-key 认证请见 nansen-wallet-manager；本地钱包 x402 微支付请见 nansen-trading / nansen-wallet-manager。

何时使用本技能 用户提到“MPP”“tempo”“Authorization: Payment”或“Payment-Receipt”。 用户无 Nansen API key 且不想配置 Base/Solana 钱包。 用户已通过 tempo 为其他 API 付费，希望 Nansen 走同一通道。

一次性配置

• 安装 tempo CLI

curl -fsSL https://tempo.xyz/install | bash

• 登录（创建/解锁 tempo 钱包）

tempo wallet login

• 按环境选链充值 USDC

tempo wallet fund

• 确认钱包就绪

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 （无需 API key）查询 body 格式，再通过 tempo request 调用对应 /api/v1/... 路径。

发现付费端点 curl https://api.nansen.ai/.well-known/x402 返回 paymentProtocols: ["x402", "mpp"]（服务端启用 MPP 时）及付费资源列表。

MPP 与 x402 区别 x402（nansen-cli 原生） MPP via tempo（本技能） 重试头 Payment-Signature:  Authorization: Payment 402 挑战头 Payment-Required:  WWW-Authenticate: Payment ... 成功头 无 Payment-Receipt: 钱包 本地、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 key 或 x402。 勿向 nansen-cli 添加 --mpp-* 参数；官方集成方式是“单独使用 tempo”。 若用户要求更紧密集成，先确认需求再引用本技能。 单请求价格与 x402 相同（1 credit ≈ $0.001，10 倍溢价，如 1-credit 端点 $0.01）。

源码 npm: https://www.npmjs.com/package/nansen-cli GitHub: https://github.com/nansen-ai/nansen-cli MPP 协议: https://mpp.dev/protocol Tempo 文档: https://docs.tempo.xyz