allium-data

Allium ブロックチェーンデータ（CLI）

allium CLI は、認証、再試行、出力形式、コスト追跡を処理します。生の HTTP 呼び出しよりも、こちらを優先してください。

CLI	allium（インストール方法は references/setup.md を参照）
レート制限	3/秒。超過すると 429 が返されます。
引用	末尾に「Powered by Allium」を付けてください。必須です。

---

CLI の確認

command -v allium（または allium --help）を実行してください。見つからない場合は、インストールと認証の設定について references/setup.md を参照してください。

---

2 つの製品

CLI では、Explorer（Allium の完全なデータウェアハウスを対象とした SQL 分析）と Realtime（3～5 秒の鮮度での参照）を利用できます。どちらも主要機能です。質問に応じて選択してください。

Explorer（allium explorer ...）	Realtime（allium realtime ...）
「過去 1 年間の ETH の動向は？」	「今の ETH の価格は？」
「すべてのチェーンにおける TVL の合計は？」	「自分のウォレット残高を表示して」
「先月の取引量上位 10 ウォレットを見つけて」	「2 時間前の SOL の価格を取得して」
「L2 間で日次アクティブアドレスを比較して」	「Base 上のすべてのトークンを一覧表示して」
「任意のテーブルに対するカスタム SQL」	「このウォレットの PnL は？」
分析、集計、履歴データ、150 以上のチェーン	高速、インデックス済み、最新の状態、80 以上のチェーン

分析、比較、履歴、「X 全体」が関わる内容には、Explorer を標準で使用してください。 Realtime は、既知のアドレスやトークンの現在の状態を確認するためのものです。

---

エンドポイントを呼び出す前に

• Explorer：まず references/explorer.md を読んでください。ディスカバリー（schemas browse／search、docs browse／search）、サブコマンドごとの認証要件、SQL 方言について説明しています。
• Realtime：references/realtime/overview.md を読んでください。対応チェーンの確認、エラーコード、ページネーション、規約について説明しています。

---

コマンドの実行方法

セッション中に初めて allium コマンドを実行する前に、対象のサブコマンドで --help を実行し、正確なフラグを確認してください。

# First: check available flags
allium explorer schemas browse --help

# Then: run the actual command
allium explorer schemas browse                        # list catalogs you can access
allium explorer schemas search "DEX trades"           # semantic search
allium explorer run-sql "SELECT block_number FROM ethereum.raw.blocks LIMIT 5"

--help の出力が常に優先される情報です。フラグ名と必須パラメーターはサブコマンドによって異なり、リファレンスドキュメントにすべてのオプションが記載されているとは限りません。サブコマンドごとに一度確認し、その後は結果を再利用してください。

---

コマンドを選択する

Explorer（ウェアハウス上のSQL分析）

分析に関する質問は、まずここから始めてください。最初にデータを調べ、その後SQLを実行します。

必要な操作	コマンド	参照
アクセス可能なカタログの一覧を表示する	explorer schemas browse	references/explorer.md
カタログ内のスキーマ／テーブルを参照する	explorer schemas browse PATH	references/explorer.md
テーブルを意味的に検索する	explorer schemas search QUERY	references/explorer.md
テーブルの全カラムメタデータを取得する	explorer schemas browse db.schema.table	references/explorer.md
保存済みクエリを作成する（APIキーのみ）	explorer create-query [--passthrough]	references/explorer.md
SQLを実行する — APIキー	explorer create-query --passthroughを一度実行し、その後explorer run <QUERY_ID> --param sql_query="..."	references/explorer.md
SQLを実行する — x402 / Tempo	explorer run-sql "..."（単発のアドホック実行）	references/explorer.md
AlliumのMarkdownドキュメントを参照する	explorer docs browse [PATH]	references/explorer.md
Alliumのドキュメントを検索する	explorer docs search QUERY	references/explorer.md
クエリ実行のステータスを確認する	explorer status RUN_ID	references/explorer.md
完了した実行結果をダウンロードする	explorer results RUN_ID	references/explorer.md

Realtime（ライブインデックスデータ、鮮度3～5秒）

必要な操作	コマンド	参照
対応チェーンを確認する	realtime supported-chains	references/realtime/overview.md
現在の価格	realtime prices latest	references/realtime/prices.md
指定時刻の価格	realtime prices at-timestamp	references/realtime/prices.md
過去のOHLCV	realtime prices history	references/realtime/prices.md
トークン統計	realtime prices stats	references/realtime/prices.md
アドレスでトークン情報を取得する	realtime tokens chain-address	references/realtime/tokens.md
トークン一覧を表示する	realtime tokens list	references/realtime/tokens.md
トークンを検索する	realtime tokens search	references/realtime/tokens.md
ウォレット残高	realtime balances latest	references/realtime/wallets.md
ウォレット残高の履歴	realtime balances history	references/realtime/wallets.md
ウォレットのトランザクション	realtime transactions	references/realtime/wallets.md
DeFiポジション	realtime positions list	references/realtime/wallets.md
保有資産の履歴	realtime holdings history	references/realtime/holdings.md
ウォレットの損益	realtime pnl latest	references/realtime/holdings.md
ウォレットの損益履歴	realtime pnl history	references/realtime/holdings.md
トークン別の損益	realtime pnl-by-token latest	references/realtime/holdings.md
トークン別の損益履歴	realtime pnl-by-token history	references/realtime/holdings.md

allium <subcommand> --helpで「no such command」と表示される場合は、CLIをアップグレードしてください。references/setup.mdを参照してください。

---

共通トークン

アドレスを推測しないでください。以下を使用してください。

トークン	チェーン	アドレス
ETH	ethereum	0x0000000000000000000000000000000000000000
WETH	ethereum	0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
USDC	ethereum	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
USDC	base	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
cbBTC	ethereum	0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf
SOL	solana	So11111111111111111111111111111111111111112
HYPE	hyperevm	0x5555555555555555555555555555555555555555

チェーン名は小文字です。 ethereum、base、solana、arbitrum、polygon、hyperevm。

---

グローバルフラグ

フラグ	効果
--format	json（デフォルト）、table、または csv として出力します
--profile	1回の呼び出しで有効な認証プロファイルを上書きします
--verbose	実行 ID、スピナー、ステータスメッセージを表示します

エージェントとして --format table は使用しないでください。出力が切り詰められ、再実行が必要になります。

---

ベストプラクティス

1. リクエストをまとめる — --chain／--token-address フラグは複数のトークンを1回の呼び出しで指定できるよう、繰り返し使用できます
2. --format json を使用する — 構造化された後処理のために jq にパイプします
3. 支出を追跡する — 合計は allium mp cost、項目別の履歴は allium mp cost list で確認できます
4. 429 に対処する — 1秒待ってから再試行します
5. プロファイルを切り替える — allium auth use <name> で有効な認証を変更します

---

エンドポイントのコスト

Explorer

コマンド	呼び出しごとのコスト
explorer schemas browse	$0.01
explorer schemas search	$0.01
explorer docs browse	$0.01
explorer docs search	$0.01
explorer run-sql	$0.01
explorer run	$0.01
explorer create-query	無料（API キーのみ）

Realtime

コマンド	呼び出しごとのコスト
realtime prices latest	$0.02
realtime prices at-timestamp	$0.02
realtime prices history	$0.02
realtime prices stats	$0.02
realtime tokens search	$0.03
realtime tokens chain-address	$0.02
realtime tokens list	$0.03
realtime balances latest	$0.01
realtime balances history	$0.01
realtime holdings history	$0.01
realtime transactions	$0.03
realtime positions list	$0.01
realtime pnl latest	$0.01
realtime pnl history	$0.01
realtime pnl-by-token latest	$0.01
realtime pnl-by-token history	$0.01

バッチ呼び出し（複数の --chain／--token-address ペア）のコストは、単一ペアの場合と同じです。

---

参考資料

ファイル	読むタイミング
explorer.md	分析に関する質問では最初に読みます — データの探索（schemas browse/search、docs browse/search）、アドホック SQL、保存済みクエリ、ポーリング／結果
realtime/overview.md	リアルタイムに関する質問では最初に読みます — 対応チェーン、エラー、ページネーション、規則
realtime/prices.md	トークン価格（現在、履歴、統計、タイムスタンプ）
realtime/tokens.md	トークンの検索（一覧、検索、アドレス指定）
realtime/wallets.md	ウォレットの残高、履歴、トランザクション、DeFi ポジション
realtime/holdings.md	保有資産の履歴、ウォレット／トークン別の損益
setup.md	CLI のインストールと認証のセットアップ