> ## Documentation Index > Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt > Use this file to discover all available pages before exploring further. # CLI > `chainstream` コマンドラインインターフェース — すべてのデータプロダクト、GraphQL、DeFi プリミティブへのシェルネイティブアクセス。 ChainStream CLI は、SDK / REST / GraphQL / WebSocket と同じ [データプロダクト](/jp/docs/data-products/overview) にコマンドラインからアクセスするフロントドアです。`jq`、シェルパイプライン、シェルを駆動する AI エージェントと組み合わせられるよう設計されています。 ## インストール ```bash theme={null} # オプション A — グローバルインストール（インタラクティブ利用推奨） npm install -g @chainstream-io/cli # オプション B — インストール不要・常に最新（エージェントや CI 推奨） npx @chainstream-io/cli ``` 以下の例では `chainstream ` は `npx @chainstream-io/cli ` と等価です。環境に合った呼び出し方を選んでください。 ## 認証 CLI は 2 つの認証パスを持ちます。どちらも同じ設定ファイルから REST API、GraphQL、DeFi コマンドへのアクセス権を与えます。 ```bash theme={null} # ホスト内ウォレットを作成し、nano trial（50K CU、30 日間）を自動付与 chainstream login # …または既存の API Key を明示的に設定 chainstream config set --key apiKey --value # スクリプトでは環境変数で渡すこともできます export CHAINSTREAM_API_KEY=... ``` 設定は `~/.config/chainstream/config.json` に保存され、ウォレットキーは `~/.config/chainstream/keys/` 以下に保存されます。`chainstream logout` はウォレット設定をクリアしますがキーファイルはディスクに残します。 ## コマンドグループ | グループ | 目的 | | --------- | ---------------------------------------------------------------------------------------------------- | | `token` | `search`, `info`, `security`, `holders`, `candles`, `pools` | | `market` | `trending`, `new`, `trades` | | `wallet` | `profile`, `pnl`, `holdings`, `activity`, `address`, `balance`, `pricing`, `sign`, `set-raw`, `link` | | `dex` | `route`, `swap`, `create` — ホスト管理のウォレットで署名するための**未署名**トランザクションを構築 | | `tx` | `send`, `gas-price`, `estimate-gas` | | `graphql` | `schema`, `query` — 下記参照 | | `plan` | `status`, `purchase` — x402 オートペイ、API Key を返却 | | `config` | `set`, `get`, `auth` | | `job` | `status` | | トップレベル | `login`, `logout`, `verify`, `bind-email`, `bind-email-verify` | グローバルフラグ：`--json` は単一行の機械可読 JSON を出力（既定は整形済み JSON）。 ## 最初のコマンド ```bash theme={null} chainstream token search --chain sol --keyword PUMP --limit 5 chainstream token security --chain sol --address chainstream market trending --chain sol --duration 1h --limit 20 chainstream wallet pnl --chain sol --address 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`。 ### スキーマの探索 ```bash theme={null} chainstream graphql schema --summary # 全 27 キューブのコンパクトなカタログ chainstream graphql schema --type DEXTrades # 1 キューブのフィールドを深掘り chainstream graphql schema --full # 完全リファレンス（エージェントに最適） chainstream graphql schema --summary --refresh # キャッシュを無視して再取得 ``` ### クエリの実行 ```bash theme={null} # インラインクエリ 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 トランザクションを準備する ## 次へ すべてのコマンド、フラグ、終了コード。 エンドポイント、スキーマ、クエリパターン。 AI エージェントによる `graphql schema` / `query` の使い方。 AI エージェントが CLI を使うパターン。