跳轉到主要內容
ChainStream CLI 是訪問 資料產品 的命令列入口,覆蓋與 SDK、REST、GraphQL、WebSocket 同樣的目錄。它被設計為與 jq、shell 管道和驅動 shell 的 AI Agent 無縫組合。

安裝

下文示例中的 chainstream <cmd> 等價於 npx @chainstream-io/cli <cmd>,按環境選擇即可。

鑑權

CLI 有兩條鑑權路徑。兩者都能讓 REST API、GraphQL 和 DeFi 命令從同一份配置檔案取到憑證。
配置位於 ~/.config/chainstream/config.json;錢包金鑰位於 ~/.config/chainstream/keys/chainstream logout 只清除錢包配置,保留磁碟上的金鑰檔案。

命令分組

全域性開關:--json 輸出單行機讀 JSON(預設輸出格式化 JSON)。

首發命令

GraphQL 子命令

graphql 分組暴露 ChainStream 的鏈上資料倉儲(27 個 cube,分佈在 SolanaEVMTrading 三個鏈組)——在 REST / MCP 端點不夠靈活時派上用場(跨 cube JOIN、自定義聚合、時間序列、多條件過濾)。預設端點:https://graphql.chainstream.io/graphql

發現 schema

執行查詢

鑑權自動處理:若已設 API Key(透過 config set --key apiKeyCHAINSTREAM_API_KEY),CLI 會走 X-API-KEY;否則會用宿主錢包簽出 SIWX 令牌。GraphQL 與 REST API 共享同一套 API Key 與訂閱池——無需單獨購買
遇到 402,graphql query 會返回帶說明的錯誤。跑 chainstream plan status,然後 chainstream plan purchase(處理 x402 自動付費並儲存 API Key),再重試。

何時使用

  • 快速探索(“現在正發生什麼?”)
  • 指令碼、定時任務、GitHub Actions
  • 給 AI Agent 提供可在 shell 裡執行的 ChainStream 原語
  • 不想寫任何客戶端程式碼就做自定義 GraphQL 分析
  • 為使用者控制的錢包準備未簽名 DeFi 交易

下一步

CLI 參考

所有命令、開關與退出碼

GraphQL 訪問方式

端點、schema、查詢正規化

chainstream-graphql 技能

AI Agent 如何使用 graphql schema / query

Agent Skills

AI Agent 如何使用 CLI