メインコンテンツへスキップ
ChainStream CLI は、SDK / REST / GraphQL / WebSocket と同じ データプロダクト にコマンドラインからアクセスするフロントドアです。jq、シェルパイプライン、シェルを駆動する AI エージェントと組み合わせられるよう設計されています。

​
インストール

# オプション A — グローバルインストール（インタラクティブ利用推奨）
npm install -g @chainstream-io/cli

# オプション B — インストール不要・常に最新（エージェントや CI 推奨）
npx @chainstream-io/cli <command>
以下の例では chainstream <cmd> は npx @chainstream-io/cli <cmd> と等価です。環境に合った呼び出し方を選んでください。

​
認証

CLI は 2 つの認証パスを持ちます。どちらも同じ設定ファイルから REST API、GraphQL、DeFi コマンドへのアクセス権を与えます。 
# ホスト内ウォレットを作成し、nano trial（50K CU、30 日間）を自動付与
chainstream login

# …または既存の API Key を明示的に設定
chainstream config set --key apiKey --value <your-api-key>

# スクリプトでは環境変数で渡すこともできます
export CHAINSTREAM_API_KEY=...
設定は ~/.config/chainstream/config.json に保存され、ウォレットキーは ~/.config/chainstream/keys/ 以下に保存されます。chainstream logout はウォレット設定をクリアしますがキーファイルはディスクに残します。

​
コマンドグループ

グループ目的
tokensearch, info, security, holders, candles, pools
markettrending, new, trades
walletprofile, pnl, holdings, activity, address, balance, pricing, sign, set-raw, link
dexroute, swap, create — ホスト管理のウォレットで署名するための未署名トランザクションを構築
txsend, gas-price, estimate-gas
graphqlschema, query — 下記参照
planstatus, purchase — x402 オートペイ、API Key を返却
configset, get, auth
jobstatus
トップレベルlogin, logout, verify, bind-email, bind-email-verify
グローバルフラグ：--json は単一行の機械可読 JSON を出力（既定は整形済み JSON）。

​
最初のコマンド

chainstream token search --chain sol --keyword PUMP --limit 5
chainstream token security --chain sol --address <addr>
chainstream market trending --chain sol --duration 1h --limit 20
chainstream wallet pnl --chain sol --address <wallet>
chainstream dex route --chain sol --from SOL --to USDC --amount 1

​
GraphQL サブコマンド

graphql グループは ChainStream のオンチェーンデータウェアハウス（Solana、EVM、Trading にまたがる 27 キューブ）を公開します — REST／MCP エンドポイントでは表現力が足りないとき（キューブ横断 JOIN、カスタム集計、時系列、多条件フィルタ）に有用です。既定エンドポイント：https://graphql.chainstream.io/graphql。

​
スキーマの探索

chainstream graphql schema --summary              # 全 27 キューブのコンパクトなカタログ
chainstream graphql schema --type DEXTrades       # 1 キューブのフィールドを深掘り
chainstream graphql schema --full                 # 完全リファレンス（エージェントに最適）
chainstream graphql schema --summary --refresh    # キャッシュを無視して再取得

​
クエリの実行

# インラインクエリ
chainstream graphql query \
  --query 'query { Solana { DEXTrades(limit:{count:5}) { Block { Time } } } }' \
  --json

# 変数付きでファイルから
chainstream graphql query --file ./query.graphql --var '{"chain":"sol"}'
認証は自動です：API Key が設定されている場合（config set --key apiKey または CHAINSTREAM_API_KEY）CLI は X-API-KEY で送信します。未設定の場合はホスト内ウォレットから SIWX トークンを署名します。GraphQL は REST API と同じ API Key ＆サブスクリプションプールを共有します — 別途購入は不要です。
402 の場合、graphql query は説明的なエラーを返します。chainstream plan status を実行し、続けて chainstream plan purchase（x402 オートペイを処理し返却された API Key を保存）を実行して再試行してください。

​
使いどころ

  • 手早い探索（「今何が起きているか？」）
  • スクリプト、cron ジョブ、GitHub Actions
  • AI エージェントにシェル実行可能な ChainStream プリミティブを提供する
  • クライアントコードを書かずにカスタム GraphQL 分析を実行する
  • ユーザー管理ウォレットが署名するための未署名 DeFi トランザクションを準備する

​
次へ

CLI リファレンス

すべてのコマンド、フラグ、終了コード。

GraphQL アクセス方法

エンドポイント、スキーマ、クエリパターン。

chainstream-graphql スキル

AI エージェントによる graphql schema / query の使い方。

Agent Skills

AI エージェントが CLI を使うパターン。