glassnode-cli

Glassnode CLI（gn）

Glassnode API 的命令行界面。

设置

如果无法使用 gn 命令，则需要安装 CLI。有关安装和设置选项，请参阅 README 中的安装部分。

快速开始：

gn asset list
gn metric get market/price_usd_close --asset BTC --since 30d

命令

列出资产

gn asset list
gn asset list --filter "asset.semantic_tags.exists(tag,tag=='stablecoin')"
gn asset list --filter "asset.id=='BTC'"
# Prune to specific fields (returns array of objects)
gn asset list --prune id -o json
gn asset list -p id,symbol -o json

描述资产

gn asset describe BTC

列出指标

gn metric list
gn metric list --asset BTC
gn metric list -a BTC -e binance -i 24h
gn metric list --assets BTC --assets ETH
gn metric list --from-exchange binance --to-exchange coinbase

可使用任意元数据查询参数进行筛选：--currency、--exchange、--interval、--from-exchange、--to-exchange、--miner、--maturity、--network、--period、--quote-symbol，或多个 --assets。

描述指标（发现有效参数）

gn metric describe market/price_usd_close
gn metric describe market/price_usd_close --asset BTC

获取指标数据

gn metric get market/price_usd_close --asset BTC --interval 24h
gn metric get market/price_usd_close --asset BTC --since 2024-01-01 --until 2024-02-01
gn metric get market/price_usd_close --asset BTC --since 30d
gn metric get indicators/sopr --asset BTC --interval 24h --since 30d
gn metric get distribution/balance_exchanges --asset BTC --exchange binance --currency usd

批量获取（多个资产）

在指标路径后追加 /bulk。为每个资产重复使用 -a（或 --asset），也可以使用 -a '*' 获取全部资产：

gn metric get market/marketcap_usd/bulk -a BTC -a ETH -a SOL -s 1d
gn metric get market/marketcap_usd/bulk -a '*' --interval 24h --since 30d

API 额度使用情况（gn user credits）

显示账户当前的 API 使用情况。

gn user credits

JSON 输出示例：

{
  "creditsLeft": integer,
  "creditsPerMonth": integer,
  "creditsUsed": integer
}

设置 / 获取配置

gn config set api-key=your-key
gn config set output=csv
gn config get api-key
gn config get all

全局标志

标志	简写	描述
--api-key		Glassnode API 密钥
--output	-o	输出格式：json（默认）、csv、table
--dry-run		打印请求 URL，但不执行请求
--timestamp-format		输出中的时间戳格式

最佳实践

• 在运行 gn metric get 之前，始终先运行 gn metric describe <path>，以发现指标的有效参数、资产、交易所和间隔。
• 使用 --output json（默认值）生成适合通过管道传递给 jq 的结构化输出。
• 使用 --dry-run 预览 API 请求 URL，但不执行请求：gn metric get market/price_usd_close --asset BTC --since 30d --dry-run。
• 对于批量指标（路径以 /bulk 结尾），使用 -a 指定资产，或使用 -a '*' 获取全部资产。
• --since 和 --until 支持相对时间值，例如：30d、7d、1h。

输出格式

• --output json（默认）——JSON，适合使用 jq 处理
• --output csv——CSV 格式，适合电子表格
• --output table——易于阅读的 ASCII 表格

# Pipe JSON to jq
gn metric get market/price_usd_close -a BTC --since 7d | jq '.[].v'

# Export to CSV
gn metric get market/price_usd_close -a BTC --since 30d -o csv > prices.csv

# Quick look in the terminal
gn metric get market/price_usd_close -a BTC --since 7d -o table