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>を呼び出してください。
• jqにパイプで渡せる構造化出力には、--output json（デフォルト）を使用してください。
• API リクエスト URL を実行せずに確認するには、--dry-runを使用してください：gn metric get market/price_usd_close --asset BTC --since 30d --dry-run。
• 一括メトリクス（パスが/bulkで終わるもの）には、特定のアセットを指定する-aまたはすべてのアセットを対象にする-a '*'を使用してください。
• --sinceと--untilでは相対時間を指定できます（例：30d、7d、1h）。

出力形式

• --output json（デフォルト）— jqでの処理に適した JSON
• --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