nansen-ai/nansen-cli

nansen-mpp-payment

Pay-per-call access to the Nansen API via MPP (Tempo).

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-mpp-payment

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

MPP / Tempo

The Nansen API supports three paid-access rails: API key, x402 (handled by nansen-cli), and MPP via Tempo (handled by the separate tempo CLI). This skill covers the third.

nansen-cli does not sign MPP credentials. Use this skill when the user wants to call the Nansen API through tempo request because they already use tempo, want micropayments without managing wallet keys themselves, or don't want to fund a Base/Solana USDC wallet.

For API-key auth, see nansen-wallet-manager. For x402 micropayment with a local wallet, see nansen-trading / nansen-wallet-manager.

When to use this skill

  • User says "MPP", "tempo", "Authorization: Payment", or "Payment-Receipt".
  • User has no Nansen API key and doesn't want to set up a Base/Solana wallet.
  • User is already paying for other APIs through tempo and wants Nansen on the same rail.

One-time setup

bash
# 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

Calling the Nansen API

tempo request handles the full MPP challenge/response: it sends the request, signs the Authorization: Payment credential when the API responds 402 + WWW-Authenticate: Payment ..., retries, and exposes the Payment-Receipt header on success.

bash
# 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"}'

Endpoint paths and request shapes are the same as the rest of the Nansen API — run nansen schema <command> (no API key required) to look up the body shape, then call the matching /api/v1/... path through tempo request.

Discovering paid endpoints

bash
curl https://api.nansen.ai/.well-known/x402

Returns paymentProtocols: ["x402", "mpp"] (when MPP is enabled server-side) and the list of paid resources.

How MPP differs from x402

x402 (nansen-cli native)MPP via tempo (this skill)
Header sent on retryPayment-Signature: <base64>Authorization: Payment <credential>
402 challenge headerPayment-Required: <base64>WWW-Authenticate: Payment ...
Success header(none)Payment-Receipt: <base64>
Walletlocal, Privy, or WalletConnect — managed by nansen-clitempo-managed (separate CLI)
ChainsBase USDC, Solana SPL USDC, X Layer USDT0Tempo's chain (mainnet USDC in prod, moderato pathUSD in dev)
nansen-cli code pathsrc/x402.js auto-signs on 402not handled — call via tempo request directly

Notes

  • MPP is server-side opt-in. If tempo request returns a 402 without WWW-Authenticate: Payment, MPP isn't enabled for that endpoint/environment — fall back to an API key or x402.
  • Don't try to add --mpp-* flags to nansen-cli — the supported integration is "use tempo separately". If the user asks for tighter integration, point them at this skill and confirm the requirement before adding code.
  • Per-request price is the same as x402 (1 credit ≈ $0.001 with 10x markup, e.g. 1-credit endpoints cost $0.01).

Source

  • npm: https://www.npmjs.com/package/nansen-cli
  • GitHub: https://github.com/nansen-ai/nansen-cli
  • MPP protocol: https://mpp.dev/protocol
  • Tempo docs: https://docs.tempo.xyz

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills