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 的链上数据仓库(Solana、EVM、Trading 三个链组共 27 个 cube)——在 REST/MCP 端点表达能力不够时好用(跨 cube JOIN、自定义聚合、时间序列、多条件过滤)。默认端点:https://graphql.chainstream.io/graphql。
探索 Schema
执行查询
config set --key apiKey 或 CHAINSTREAM_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。

