跳转到主要内容
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 的链上数据仓库(SolanaEVMTrading 三个链组共 27 个 cube)——在 REST/MCP 端点表达能力不够时好用(跨 cube JOIN、自定义聚合、时间序列、多条件过滤)。默认端点:https://graphql.chainstream.io/graphql

探索 Schema

执行查询

认证自动完成:若配置了 API Key(config set --key apiKeyCHAINSTREAM_API_KEY),CLI 通过 X-API-KEY 发送;否则用宿主钱包签出一个 SIWX token 发送。GraphQL 与 REST API 共用同一个 API Key 和订阅池——无需单独购买。
返回 402 时,graphql query 会返回一条描述性错误。执行 chainstream plan status,然后 chainstream plan purchase(它会自动处理 x402 扣费并把返回的 API Key 保存下来),再重试即可。

什么时候用

  • 快速探索(“现在发生什么?”)
  • 脚本、cron、GitHub Actions
  • 给 AI Agent 一套可执行的 ChainStream 原语
  • 不写客户端代码就做自定义 GraphQL 分析
  • 为用户控制的钱包准备未签名的 DeFi 交易

下一步

CLI 参考

所有命令、参数与退出码。

GraphQL 接入方式

端点、schema、查询范式。

chainstream-graphql skill

AI Agent 如何使用 graphql schema / query

Agent Skills

AI Agent 如何使用 CLI。