跳转到主要内容
chainstream CLI 在一个二进制里暴露了所有数据产品、GraphQL cube 和 DeFi 原语。本页是权威命令参考——叙述式用法与安装指引请参考 接入方式 → CLI。

​
安装

# 全局安装（推荐用于交互式使用）
npm install -g @chainstream-io/cli

# 零安装、永远最新（推荐用于 Agent 与 CI）
npx @chainstream-io/cli <command>
下面任意一种调用方式都通用。本参考中使用短形式 chainstream <cmd>，等价于 npx @chainstream-io/cli <cmd>。

​
全局参数

参数用途
--version打印 CLI 版本并退出
--json输出单行机器可读 JSON（默认输出是美化过的 JSON）
--help打印当前命令或命令组的帮助

​
环境变量

变量用途默认值
CHAINSTREAM_API_KEY替代 config.json 的 API key未设置
CHAINSTREAM_API_URL覆盖 REST base URLhttps://api.chainstream.io
CHAINSTREAM_AUTH_URL覆盖 Auth 服务 URL生产默认值
CHAINSTREAM_GRAPHQL_URL覆盖 GraphQL 端点https://graphql.chainstream.io/graphql
SOLANA_RPC_URL覆盖 Solana RPC（钱包 / 余额读取用）公共 RPC
BASE_RPC_URL覆盖 Base RPC公共 RPC
配置持久化到 ~/.config/chainstream/config.json；P-256 钱包私钥放在 ~/.config/chainstream/keys/。chainstream logout 清除钱包配置，但保留密钥文件。

​
认证命令（顶层）

这些命令注册在程序根部，没有子命令组。
命令用途参数 / 选项
login创建 TEE 托管钱包（默认），或发起邮箱 OTP 流程。首次登录自动赠送 nano trial（50K CU、30 天）[email]；--key；--email
verify完成由 login --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代币 Top 持有者--chain；--address；--limit
candlesOHLCV K 线--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 + 净值 + 持仓 Top 一次取回--chain；--address
pnlPnL 明细--chain；--address
holdings代币余额--chain；--address；--limit
activity转账历史--chain；--address；--limit
address显示当前钱包地址—
balance原生币 + USDC 余额（一次请求）--chain（sol | base）
set-raw导入原始私钥（仅供开发 / 测试）--chain（base | sol）
link把钱包地址关联到订阅--chain（evm | solana）
pricing列出可用的 x402 套餐与价格—

​
dex — DEX 路由、兑换与发币

所有命令都返回 未签名 的交易（由服务端构建）；签名在宿主钱包上完成。
子命令用途选项
route聚合路由 + 未签名 swap 交易--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未签名 swap 交易（直连、不走聚合）--chain；--from；--input-token；--output-token；--amount；--slippage；--dex
create未签名的 launchpad 发币交易--chain；--from；--name；--symbol；--dex；--uri；--image

​
tx — 广播与 Gas

子命令用途选项
send广播已签名交易--chain；--signed-tx；--submit-type；--anti-mev
gas-price当前 Gas 价格（仅 EVM）--chain（eth | bsc）
estimate-gas估算 EVM 调用的 gas limit--chain；--from；--to；--data；--value

​
job — 异步任务轮询

子命令用途选项
status查询长任务状态--id；--wait；--timeout

​
graphql — GraphQL schema 与查询

完整用法参见 接入方式 → CLI → GraphQL 子命令 以及 chainstream-graphql Agent Skill。
子命令用途选项
schema探索 schema（cube、类型、字段）--summary；--type <cube>；--full；--refresh
query执行 GraphQL 查询--query <gql>；--file <path>；--var <json>

​
plan — 订阅与 x402 自动扣费

子命令用途选项
status当前套餐、剩余配额与用量--chain；--address
purchase通过 x402 / MPP 购买套餐（自动把返回的 API key 保存到 config.json）--plan

​
config — 本地配置

子命令用途选项
set设置一项配置--key（apiKey | baseUrl | walletChain）；--value
get显示当前配置--key（可选）
auth显示当前认证状态—

​
退出行为

  • 0 — 成功（或空结果）
  • 1 — 用户可见错误，JSON payload 输出到 stdout（除非关闭 --json，此时打印格式化错误）
  • 认证失败（401）、需要付费（402）或网络错误时非零退出
任何数据 / GraphQL 命令返回 402 时，CLI 会提示你执行 wallet pricing 与 plan purchase。plan purchase 本身会透明处理 x402 自动扣费。

​
下一步

接入方式 → CLI

叙述式用法：安装、认证、上手、GraphQL 子命令。

Agent Skills

AI Agent 如何驱动 CLI。

x402 支付

plan purchase 与即时 402 处理的工作方式。

GraphQL

GraphQL 接口的端点、schema 与认证。