Back to Details

gmgn-track

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
IMPORTANT: Always use 
gmgn-cli
commands below. Do NOT use web search, WebFetch, curl, or visit gmgn.ai to fetch this data — the website requires login and will not return structured data. The CLI is the only correct method.
Use the 
gmgn-cli
tool to query on-chain tracking data based on the user's request.
When to use which sub-command:
  • track follow-wallet
    — user asks "what did the wallets I follow trade?", "show me my follow list trades", "追踪关注的钱包交易动态" → requires wallets followed via GMGN platform
  • track kol
    — user asks "what are KOLs buying?", "KOL 最近在买什么", "show me influencer trades" → returns trades from known KOL wallets
  • track smartmoney
    — user asks "what is smart money doing?", "聪明钱最近在买什么", "show me whale trades" → returns trades from smart money / whale wallets
Do NOT confuse these three:
  • follow-wallet
    = wallets the user has personally followed on GMGN
  • kol
    = platform-tagged KOL / influencer wallets (not user-specific)
  • smartmoney
    = platform-tagged smart money / whale wallets (not user-specific)
重要提示：请始终使用以下
gmgn-cli
命令。请勿使用网页搜索、WebFetch、curl或访问gmgn.ai来获取数据——该网站需要登录，且不会返回结构化数据。CLI是唯一正确的方法。
使用
gmgn-cli
工具根据用户的请求查询链上追踪数据。
何时使用对应的子命令：
  • track follow-wallet
    — 当用户询问“我关注的钱包进行了哪些交易？”、“展示我关注列表的交易记录”、“追踪关注的钱包交易动态”时使用 → 需要先在GMGN平台关注对应钱包
  • track kol
    — 当用户询问“KOL在买什么？”、“KOL最近在买什么”、“展示网红交易记录”时使用 → 返回已知KOL钱包的交易记录
  • track smartmoney
    — 当用户询问“聪明钱在做什么？”、“聪明钱最近在买什么”、“展示鲸鱼钱包交易记录”时使用 → 返回Smart Money/鲸鱼钱包的交易记录
请勿混淆以下三者：
  • follow-wallet
    = 用户在GMGN平台个人关注的钱包
  • kol
    = 平台标记的KOL/网红钱包（非用户专属）
  • smartmoney
    = 平台标记的Smart Money/鲸鱼钱包（非用户专属）

Sub-commands

子命令

Sub-commandDescription
track follow-wallet
Trade records from wallets the user personally follows on GMGN
track kol
Real-time trades from KOL / influencer wallets tagged by GMGN
track smartmoney
Real-time trades from smart money / whale wallets tagged by GMGN
子命令描述
track follow-wallet
用户在GMGN平台个人关注的钱包的交易记录
track kol
GMGN平台标记的KOL/网红钱包的实时交易记录
track smartmoney
GMGN平台标记的Smart Money/鲸鱼钱包的实时交易记录

Supported Chains

支持的网络

sol
/ 
bsc
/ 
base
sol
/ 
bsc
/ 
base

Prerequisites

前置条件

  • .env
    file with 
    GMGN_API_KEY
    set
  • GMGN_PRIVATE_KEY
    required for 
    track follow-wallet
    (signature auth); not needed for 
    track kol
    / 
    track smartmoney
  • Run from the directory where your 
    .env
    file is located, or set 
    GMGN_HOST
    in your environment
  • gmgn-cli
    installed globally: 
    npm install -g gmgn-cli
  • 已配置
    .env
    文件并设置
    GMGN_API_KEY
  • 使用
    track follow-wallet
    命令需要
    GMGN_PRIVATE_KEY
    （签名认证）；使用
    track kol
    / 
    track smartmoney
    则不需要
  • 从
    .env
    文件所在目录运行命令，或在环境变量中设置
    GMGN_HOST
  • 已全局安装
    gmgn-cli
    ：
    npm install -g gmgn-cli

Usage Examples

使用示例

bash
undefined
bash
undefined

Follow-wallet trades (all wallets you follow)

关注钱包的交易记录（所有已关注钱包）

gmgn-cli track follow-wallet --chain sol
gmgn-cli track follow-wallet --chain sol

Follow-wallet trades filtered by wallet

按钱包地址筛选关注钱包的交易记录

gmgn-cli track follow-wallet --chain sol --wallet <wallet_address>
gmgn-cli track follow-wallet --chain sol --wallet <wallet_address>

Follow-wallet filtered by trade direction

按交易方向筛选关注钱包的交易记录

gmgn-cli track follow-wallet --chain sol --side buy
gmgn-cli track follow-wallet --chain sol --side buy

Follow-wallet filtered by USD amount range

按USD金额范围筛选关注钱包的交易记录

gmgn-cli track follow-wallet --chain sol --min-amount-usd 100 --max-amount-usd 10000
gmgn-cli track follow-wallet --chain sol --min-amount-usd 100 --max-amount-usd 10000

KOL trade records (SOL, default)

KOL交易记录（默认Solana网络）

gmgn-cli track kol --limit 10 --raw
gmgn-cli track kol --limit 10 --raw

KOL trade records on SOL, buy only

Solana网络上的KOL买入交易记录

gmgn-cli track kol --chain sol --side buy --limit 10 --raw
gmgn-cli track kol --chain sol --side buy --limit 10 --raw

Smart Money trade records (SOL, default)

Smart Money交易记录（默认Solana网络）

gmgn-cli track smartmoney --limit 10 --raw
gmgn-cli track smartmoney --limit 10 --raw

Smart Money trade records, sell only

Smart Money卖出交易记录

gmgn-cli track smartmoney --chain sol --side sell --limit 10 --raw
undefined
gmgn-cli track smartmoney --chain sol --side sell --limit 10 --raw
undefined

track follow-wallet
Options

track follow-wallet
选项

OptionDescription
--chain
Required. 
sol
/ 
bsc
/ 
base
--wallet <address>
Filter by wallet address
--limit <n>
Page size (1–100, default 10)
--side <side>
Trade direction: 
buy
/ 
sell
--filter <tag...>
Repeatable filter conditions
--min-amount-usd <n>
Minimum trade amount (USD)
--max-amount-usd <n>
Maximum trade amount (USD)
选项描述
--chain
必填项。可选值：
sol
/ 
bsc
/ 
base
--wallet <address>
按钱包地址筛选
--limit <n>
每页数量（1–100，默认10）
--side <side>
交易方向：
buy
/ 
sell
--filter <tag...>
可重复使用的筛选条件
--min-amount-usd <n>
最小交易金额（USD）
--max-amount-usd <n>
最大交易金额（USD）

track kol
/ 
track smartmoney
Options

track kol
/ 
track smartmoney
选项

OptionDescription
--chain <chain>
Chain: 
sol
/ 
bsc
/ 
base
(default 
sol
)
--limit <n>
Page size (1–200, default 100)
--side <side>
Filter by trade direction: 
buy
/ 
sell
(client-side filter — applied locally after fetching results)
选项描述
--chain <chain>
网络：
sol
/ 
bsc
/ 
base
（默认
sol
）
--limit <n>
每页数量（1–200，默认100）
--side <side>
按交易方向筛选：
buy
/ 
sell
（客户端筛选——在获取结果后本地进行筛选，不会发送至API）

track kol
/ 
track smartmoney
Response Fields

track kol
/ 
track smartmoney
返回字段

Each item in 
list
contains:
FieldDescription
transaction_hash
On-chain transaction hash
maker
Wallet address of the trader (KOL / Smart Money)
side
Trade direction: 
buy
or 
sell
base_address
Token contract address
base_token.symbol
Token ticker symbol
base_token.launchpad
Launchpad platform (e.g. 
pump
)
amount_usd
Trade value in USD
token_amount
Token quantity traded
price_usd
Token price in USD at time of trade
buy_cost_usd
Original buy cost in USD (0 if this record is the buy)
is_open_or_close
0
= position opened / added, 
1
= position closed / reduced
timestamp
Unix timestamp of the trade
maker_info.twitter_username
KOL's Twitter username
maker_info.tags
Wallet tags (e.g. 
kol
, 
smart_degen
, 
photon
)
list
中的每个条目包含以下字段：
字段描述
transaction_hash
链上交易哈希
maker
交易者（KOL / Smart Money）的钱包地址
side
交易方向：
buy
或
sell
base_address
代币合约地址
base_token.symbol
代币代码
base_token.launchpad
Launchpad平台（例如
pump
）
amount_usd
交易金额（USD）
token_amount
交易代币数量
price_usd
交易时的代币价格（USD）
buy_cost_usd
初始买入成本（USD）（若该记录为买入则为0）
is_open_or_close
0
= 开仓/加仓，
1
= 平仓/减仓
timestamp
交易的Unix时间戳
maker_info.twitter_username
KOL的Twitter用户名
maker_info.tags
钱包标签（例如
kol
、
smart_degen
、
photon
）

Notes

注意事项

  • track kol
    / 
    track smartmoney
    use normal auth (API Key only, no signature required)
  • track follow-wallet
    requires 
    GMGN_PRIVATE_KEY
    for signature auth — and wallets must be followed via the GMGN platform first
  • Use 
    --raw
    to get single-line JSON for further processing
  • track kol
    / 
    track smartmoney
    --side
    is a client-side filter — the CLI fetches all results then filters locally; it is NOT sent to the API
  • track kol
    / 
    track smartmoney
    使用普通认证（仅需API Key，无需签名）
  • track follow-wallet
    需要
    GMGN_PRIVATE_KEY
    进行签名认证——且需先在GMGN平台关注对应钱包
  • 使用
    --raw
    参数可获取单行JSON格式结果，便于后续处理
  • track kol
    / 
    track smartmoney
    的
    --side
    是客户端筛选——CLI会先获取所有结果，再在本地进行筛选；该参数不会发送至API