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

インストール

以下の例では chainstream <cmd>npx @chainstream-io/cli <cmd> と等価です。環境に合った呼び出し方を選んでください。

認証

CLI は 2 つの認証パスを持ちます。どちらも同じ設定ファイルから REST API、GraphQL、DeFi コマンドへのアクセス権を与えます。
設定は ~/.config/chainstream/config.json に保存され、ウォレットキーは ~/.config/chainstream/keys/ 以下に保存されます。chainstream logout はウォレット設定をクリアしますがキーファイルはディスクに残します。

コマンドグループ

グローバルフラグ:--json は単一行の機械可読 JSON を出力(既定は整形済み JSON)。

最初のコマンド

GraphQL サブコマンド

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

スキーマの探索

クエリの実行

認証は自動です: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 を使うパターン。