nansen-wallet-profiler

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Wallet Profiler

Wallet Profiler（钱包分析工具）

All commands:

nansen research profiler <sub> [options]

--address

and

--chain

required for most commands.

所有命令：

nansen research profiler <sub> [options]

大多数命令需要指定

--address

和

--chain

参数。

Balance & Identity

余额与身份信息

bash

nansen research profiler balance --address <addr> --chain ethereum
nansen research profiler labels --address <addr> --chain ethereum
nansen research profiler search --query "Vitalik"

bash

nansen research profiler balance --address <addr> --chain ethereum
nansen research profiler labels --address <addr> --chain ethereum
nansen research profiler search --query "Vitalik"

PnL

盈亏（PnL）

bash

nansen research profiler pnl --address <addr> --chain ethereum --days 30
nansen research profiler pnl-summary --address <addr> --chain ethereum

bash

nansen research profiler pnl --address <addr> --chain ethereum --days 30
nansen research profiler pnl-summary --address <addr> --chain ethereum

Transactions & History

交易与历史记录

bash

nansen research profiler transactions --address <addr> --chain ethereum --limit 20
nansen research profiler historical-balances --address <addr> --chain solana --days 30

bash

nansen research profiler transactions --address <addr> --chain ethereum --limit 20
nansen research profiler historical-balances --address <addr> --chain solana --days 30

Relationships

关联关系

bash

nansen research profiler related-wallets --address <addr> --chain ethereum
nansen research profiler counterparties --address <addr> --chain ethereum --days 30

bash

nansen research profiler related-wallets --address <addr> --chain ethereum
nansen research profiler counterparties --address <addr> --chain ethereum --days 30

Perps (no --chain)

永续合约（无需指定--chain）

bash

nansen research profiler perp-positions --address <addr>
nansen research profiler perp-trades --address <addr> --days 7

bash

nansen research profiler perp-positions --address <addr>
nansen research profiler perp-trades --address <addr> --days 7

Batch, Trace & Compare

批量处理、追踪与对比

bash

undefined

bash

undefined

Batch — profile multiple wallets at once

批量处理——同时分析多个钱包

nansen research profiler batch
--addresses "0xabc,0xdef" --chain ethereum
--include labels,balance,pnl

Trace — BFS multi-hop counterparty trace (makes N*width API calls)

追踪——多跳交易对手广度优先搜索追踪（会产生N*width次API调用）

nansen research profiler trace --address <addr> --chain ethereum --depth 2 --width 5

Compare — shared counterparties and tokens between two wallets

对比——查看两个钱包的共同交易对手和代币

nansen research profiler compare --addresses "0xabc,0xdef" --chain ethereum

undefined

nansen research profiler compare --addresses "0xabc,0xdef" --chain ethereum

undefined

Flags

参数说明

Flag	Purpose
`--address`	Wallet address (required)
`--chain`	Required except for perps and search
`--days`	Lookback period (default 30)
`--limit`	Number of results
`--include`	Batch fields: `labels,balance,pnl`
`--depth`	Trace depth 1-5 (default 2)
`--width`	Trace width — keep low to save credits
`--fields`	Select specific fields
`--table`	Human-readable table output
`--format csv`	CSV export

参数	用途
`--address`	钱包地址（必填）
`--chain`	必填（永续合约和搜索命令除外）
`--days`	回溯周期（默认30天）
`--limit`	结果数量限制
`--include`	批量处理的字段： `labels,balance,pnl`
`--depth`	追踪深度（1-5，默认2）
`--width`	追踪广度——设置较小值以节省调用额度
`--fields`	选择特定字段
`--table`	输出人类易读的表格格式
`--format csv`	导出为CSV格式

Notes

注意事项

```
pnl-summary
```
has no pagination support (returns aggregate stats, not a list).
```
perp-positions
```
has no pagination support.
```
labels
```
has no pagination support — the API ignores
```
per_page
```
and always returns all labels for the address.
```
--limit
```
is not available for this sub-command.
```
transactions
```
caps at per_page=100 (API limit).
```
trace
```
makes many API calls — use
```
--width
```
conservatively.
```
batch
```
accepts
```
--file <path>
```
with one address per line as alternative to
```
--addresses
```
.

```
pnl-summary
```
不支持分页（返回聚合统计数据，而非列表）。
```
perp-positions
```
不支持分页。
```
labels
```
不支持分页——API会忽略
```
per_page
```
参数，始终返回该地址的所有标签。此子命令不支持
```
--limit
```
参数。
```
transactions
```
的单页结果上限为100条（API限制）。
```
trace
```
会发起大量API调用——请谨慎设置
```
--width
```
参数。
```
batch
```
命令除了使用
```
--addresses
```
参数外，还支持通过
```
--file <path>
```
指定文件，文件中每行一个钱包地址。