nansen-agent-guide

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Agent vs CLI Routing

Agent与CLI路由选择

Need a...Use
take (analysis, interpretation)
nansen agent
table (raw data, specific metrics)Direct CLI commands
report (both)Agent for narrative + CLI for data
需要...使用
分析解读
nansen agent
表格数据(原始数据、特定指标)直接CLI命令
报告(兼具两者)Agent生成叙述内容 + CLI获取数据

Use
nansen agent
when

使用
nansen agent
的场景

  • Question requires interpretation or synthesis across multiple data sources
  • Open-ended research: "analyse this wallet", "what's happening with ETH smart money?"
bash
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)
  • 问题需要跨多个数据源进行解读或综合分析
  • 开放式研究问题:“分析这个钱包”、“ETH聪明资金的动向如何?”
bash
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
成本:200积分(快速分析)/750积分(专家级分析)

Use direct CLI commands when

使用直接CLI命令的场景

  • 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
bash
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
  • 你需要特定的结构化数据——价格、交易量、持有者、资金流向
  • 确定性问题:“以太坊上资金净流入Top10代币”
  • 需要管道输出或构建数据表
bash
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
成本:每次调用5-50积分

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
  • 不要用
    nansen agent
    进行简单数据获取——成本高40倍
  • 不要用原生CLI处理开放式分析——仅返回数据,不提供解读
  • 不要串联3次以上Agent调用——先通过CLI获取原始数据,再调用一次Agent进行综合分析