nansen-agent-guide

该 Skill 是一份路由指南，帮助在 Nansen 工具之间做选择：开放式解读与综合类研究问题使用 nansen agent（快速 200 积分、专家 750 积分），需要价格、持仓、资金流等具体结构化数据时使用直接 CLI 命令（每次 5–50 积分），报告类需求则用代理写叙述、CLI 取数据。内容还涉及 API 密钥或浏览器会话认证、登录范围与常见反模式。

nansen-devops

热度 56.45

最近更新 2026-09-29 11:12:33

分类：数据依赖：代码执行 / 第三方 API / 联网浏览搜索应用场景：研究 / 市场分析 / 报告撰写 / 财务

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add nansen-agent-guide

Metadata

name: nansen-agent-guide
description: Routing guide -- when to use `nansen agent` (AI research) vs direct CLI data commands. Use when deciding how to answer a user's research question with Nansen tools.
metadata: {"openclaw":{"requires":{"bins":["nansen"]},"primaryEnv":"NANSEN_API_KEY","install":[{"kind":"node","package":"nansen-cli","bins":["nansen"]}]}}
allowed-tools: Bash(nansen:*)

Authentication

Nansen account API calls accept a selected nansen:api browser session or conventional API key with the same permissions. NANSEN_API_KEY takes precedence; optional primaryEnv preserves configured-key injection. Run nansen auth status for offline selection. Cached access expiry alone permits automatic renewal during an authorized task. Stop on anonymous selection, invalid state, blocked/uncertain renewal or actual auth failure; never drop a credential or fall back to anonymous x402 payment. Browser login does not grant wallet signing, privileged service identity or a persistent MCP integration key. Preserve all confirmation, signing, sanctions and geographic checks below. Browser login is available in CLI 2.0.0 within the macOS arm64 preview scope.

Agent vs CLI Routing

Public agent fast/expert and direct API commands accept the selected nansen:api browser session or conventional API key under the same account permissions.

Need a...	Use
take (analysis, interpretation)	`nansen agent`
table (raw data, specific metrics)	Direct CLI commands
report (both)	Agent for narrative + CLI for data

Use `nansen agent` when

Question requires interpretation or synthesis across multiple data sources
Open-ended research: "analyse this wallet", "what's happening with ETH smart money?"

nansen agent "What are top smart money tokens on Solana today and why?"
nansen agent "Analyse wallet 0x123... -- is this a smart trader?"
nansen agent "..." --expert   # deeper analysis, 750 credits

Cost: 200 credits (fast) / 750 credits (expert)

Use direct CLI commands when

You need specific structured data -- prices, volumes, holders, flows
Deterministic question: "top 10 tokens by netflow on ethereum"
Piping output or building a data table

nansen research token screener --chain ethereum --smart-money --limit 10
nansen research smart-money netflow --chain solana
nansen research profiler balance --address 0x123... --chain ethereum

Cost: 5-50 credits per call

Anti-patterns

Don't use nansen agent for simple data fetches -- 40x more expensive
Don't use raw CLI for open-ended analysis -- returns data, not interpretation
Don't chain 3+ agent calls -- get raw data via CLI, call agent once for synthesis

Browser session scope

Plain nansen login requests fresh browser approval; --no-browser prints the link/code for approval on another device and keeps the same native-storage requirements. NANSEN_API_KEY overrides the single saved credential. Use nansen auth status for offline cached/unverified selection details and nansen account for a free live check. Explicit login --human or login --api-key retains legacy key setup. Selected browser sessions renew automatically; uncertain renewal requires fresh login without replay or fallback to another account/payment.

Browser nansen:api grants have API-key-equivalent account permissions, subject to enabled admission and the same endpoint restrictions. Internal service identity and wallet signing are not granted. Browser sessions cannot authorize wallet signing or be exported as MCP keys. CLI 2.0.0 is published; the preview platform limits above still apply.