メインコンテンツへスキップ
chainstream CLI は、すべてのデータプロダクト、GraphQL キューブ、DeFi プリミティブを単一のバイナリから公開します。このページは正式なコマンドリファレンスです — インストールや使い方の解説は アクセス方法 → CLI を参照してください。

インストール

# グローバルインストール(インタラクティブ利用推奨)
npm install -g @chainstream-io/cli

# インストール不要・常に最新(エージェントや CI 推奨)
npx @chainstream-io/cli <command>
どちらの呼び出し方でもこのリファレンスに掲載のコマンドは同様に動作します。以下の説明では短縮形 chainstream <cmd> を使用しますが、これは npx @chainstream-io/cli <cmd> と等価です。

グローバルフラグ

フラグ目的
--versionCLI のバージョンを表示して終了
--json単一行の機械可読 JSON を出力(既定出力は整形済み JSON)
--help現在のコマンドまたはグループのヘルプを表示

環境変数

変数目的既定値
CHAINSTREAM_API_KEYconfig.json の代わりに使用する API キー未設定
CHAINSTREAM_API_URLREST ベース URL を上書きhttps://api.chainstream.io
CHAINSTREAM_AUTH_URLAuth サービス URL を上書き本番既定値
CHAINSTREAM_GRAPHQL_URLGraphQL エンドポイントを上書きhttps://graphql.chainstream.io/graphql
SOLANA_RPC_URLウォレット/残高読み取り用の Solana RPC を上書きパブリック RPC
BASE_RPC_URLBase RPC を上書きパブリック RPC
設定は ~/.config/chainstream/config.json に保存され、P-256 ウォレットキーは ~/.config/chainstream/keys/ に保存されます。chainstream logout はウォレット設定をクリアしますがキーは残します。

認証コマンド(トップレベル)

以下のコマンドはプログラムのルートに登録されています(サブグループなし)。
コマンド目的引数/オプション
loginTEE バックエンドのウォレットを作成(既定)、またはメール OTP フローを開始。初回ログイン時に nano trial(50K CU、30 日間)を自動付与[email]; --key; --email
verifylogin --email で開始したメール OTP ログインを完了--otp-id; --code; --email
logoutセッションをクリア(キーはディスクに残す)
bind-email既存ウォレットにメールを紐づけ[email]
bind-email-verifyメール紐づけの OTP フローを非対話で完了--otp-id; --code; --email

token — トークン情報と分析

サブコマンド目的オプション
searchキーワードでトークンを検索--keyword(必須); --chain(必須); --limit
infoトークンの詳細を取得--chain; --address
securityセキュリティレポート(honeypot、mint authority、freeze authority など)--chain; --address
holders上位保有者--chain; --address; --limit
candlesOHLCV ローソク足--chain; --address; --resolution; --from; --to; --limit
poolsトークンの流動性プール--chain; --address

market — マーケットデータとディスカバリ

サブコマンド目的オプション
trendingウィンドウ別のホット/トレンドトークン--chain; --duration; --limit
new新規作成されたトークン--chain; --limit
trades直近の取引(トークンでフィルタ可)--chain; --token; --limit

wallet — ウォレット分析、管理、署名

サブコマンド目的オプション
signホスト内ウォレットでシリアライズ済みトランザクションに署名--chain; --tx
profilePnL +純資産+トップ保有を 1 回で取得--chain; --address
pnlPnL 詳細--chain; --address
holdingsトークン残高--chain; --address; --limit
activity送受信履歴--chain; --address; --limit
address現在のウォレットアドレスを表示
balanceネイティブ+ USDC 残高(1 リクエスト)--chainsol | base
set-raw生の秘密鍵をインポート(開発/テストのみ)--chainbase | sol
linkウォレットアドレスをサブスクリプションにリンク--chainevm | solana
pricing利用可能な x402 プランと料金を一覧表示

dex — DEX ルート、スワップ、トークン作成

すべてのコマンドは未署名トランザクションをサーバー側で構築して返します。署名はホストのウォレットで行います。
サブコマンド目的オプション
routeアグリゲートルート+未署名スワップトランザクション--chain; --from; --input-token; --output-token; --amount; --slippage; --dex; --recipient; --anti-mev; --gas-price; --gas-limit; --max-fee-per-gas; --max-priority-fee-per-gas
swap未署名のスワップトランザクション(直接、アグリゲートなし)--chain; --from; --input-token; --output-token; --amount; --slippage; --dex
create未署名の launchpad トークン作成トランザクション--chain; --from; --name; --symbol; --dex; --uri; --image

tx — ブロードキャストとガス

サブコマンド目的オプション
send署名済みトランザクションをブロードキャスト--chain; --signed-tx; --submit-type; --anti-mev
gas-price現在のガス価格(EVM のみ)--chaineth | bsc
estimate-gasEVM 呼び出しのガスリミットを見積もり--chain; --from; --to; --data; --value

job — 非同期ジョブのポーリング

サブコマンド目的オプション
status長時間実行ジョブのステータスを確認--id; --wait; --timeout

graphql — GraphQL スキーマとクエリ

詳しい使い方は アクセス方法 → CLI → GraphQL サブコマンド および chainstream-graphql の Agent Skill を参照してください。
サブコマンド目的オプション
schemaスキーマ(キューブ、型、フィールド)を探索--summary; --type <cube>; --full; --refresh
queryGraphQL クエリを実行--query <gql>; --file <path>; --var <json>

plan — サブスクリプションと x402 オートペイ

サブコマンド目的オプション
status現在のプラン、残りクォータ、使用量--chain; --address
purchasex402 / MPP でプランを購入(返却された API キーを config.json に自動保存)--plan

config — ローカル設定

サブコマンド目的オプション
set設定値を設定--keyapiKey | baseUrl | walletChain); --value
get現在の設定を表示--key(省略可)
auth現在の認証状態を表示

終了挙動

  • 0 — 成功(または空の結果)
  • 1 — ユーザー向けエラー。stdout に JSON ペイロードを出力(--json オフの場合は整形されたエラーを出力)
  • 認証失敗(401)、支払い必要(402)、ネットワークエラーの場合は非ゼロで終了
データ/GraphQL コマンドで 402 が返った場合、CLI は wallet pricingplan purchase への案内を表示します。plan purchase 自体は x402 オートペイを透過的に処理します。

次へ

アクセス方法 → CLI

解説:インストール、認証、最初のコマンド、GraphQL サブコマンド。

Agent Skills

AI エージェントが CLI をどう駆動すべきか。

x402 ペイメント

plan purchase と都度の 402 ハンドリングのしくみ。

GraphQL

GraphQL 表面のエンドポイント、スキーマ、認証。