@coinbase/coinbase-cli

中文文档
0.0.11发布于 2026/10/31MITES Module零依赖近 30 天下载 3545

代理商的Coinbase——用于交易、钱包、支付和跨Coinbase平台的CLI和MCP服务器

中文使用文档
文档目录13 节
  1. 安装
  2. 快开始
  3. 图标
  4. coinbase env ——管理 API 密钥
  5. coinbase <resource> <action> ——API业务
  6. 流动( --watch 编号 : --until (中文(简体) )
  7. coinbase history - 请求历史
  8. coinbase skills - 工作流程技能
  9. Claude 代码/ MCP
  10. 配置
  11. 捐款
  12. 警卫
  13. 许可证

@coinbase/coinbase-cli (英语)

代理的Coinbase — CLI和MCP服务器 货币基础平台认证一次,从终端或AI代理访问每个API.

零运行时间依赖性——仅Node.js 22+.

安装

npm install -g @coinbase/coinbase-cli

快开始

# 1. Set up your API key (get one at coinbase.com/settings/api)
coinbase env live --key-id <id> --key-secret <secret>

# 2. Make a request
coinbase products list

# 3. Explore available commands
coinbase --help

图标

coinbase env ——管理 API 密钥

配置 API 密钥一次; 所有后续的命令自动认证 .

coinbase env                                           # list environments
coinbase env live --key-id <id> --key-secret <secret>  # configure inline
coinbase env live --remove                             # remove an environment

多个 API 密钥 — 前缀 live 以不同的密钥继承其 URL :

coinbase env live-team-a --key-id <id> --key-secret <secret>  # inherits live URL
coinbase env live                                              # switch back to live
coinbase products list -e live-team-a                          # one-off override

自定义环境名称, 不从 live 需求 --url数字 :

coinbase env custom --key-id <id> --key-secret <secret> --url https://api.coinbase.com

coinbase <resource> <action> ——API业务

命令来自 API spec 。 运行 coinbase --help * 查看现有资源和行动.

coinbase products list
coinbase products get product_id=BTC-USD
coinbase orders list
coinbase orders create product_id=BTC-USD side=BUY ...
coinbase balance
coinbase products ticker BTC-USDC \
  --until "price BTC-USDC >= 65000"   # block on a live stream until true, then exit 0

使用 --template 在写入前查看预期的请求形状,以及 --dry-run 预览而不发送 :

coinbase orders create --template    # print request body template
coinbase orders create --dry-run     # preview the assembled request

字段语法 :

语法含义
key=value字符串正体字段
key:=valueRaw JSON 身体场
key==value查询参数
a.b.c=value嵌入体场
@file.json文件正文
-尸体从 stdin
Header:value自定义 HTTP 页眉

资源旗:

旗帜行为
--template将请求体模板打印为 JSON
--dry-run不发送打印请求
--edit打开请求正文 $EDITOR
--jq <expr>过滤 JSON 响应( 需要) 强克(中文(简体) )
--paginate完整结果自动跟踪标记
--watch由 WebSocket 流提供实时终端表面
--until <predicate>屏蔽在一条活溪上,直到上游是真的,然后退出
--until-timeout <seconds>船长多久 --until 等待然后放弃
-e <env>使用特定环境

流动(--watch 编号 : --until(中文(简体) )

读取命令如 products ticker, (中文(简体) ), products book,以及 orders list 可以订阅一个活的WebSocket feed,而不是提出一发请求.

--watch 做一个活的终端表面. --until 块直到上游变为真实,将匹配事件打印为 JSON,然后退出 —— 与 &&数字 :

# Live ticker surface
coinbase products ticker BTC-USDC ETH-USDC --watch

# Block until BTC crosses 65k, then place an order
coinbase products ticker BTC-USDC --until "price BTC-USDC >= 65000" --until-timeout 3600 \
  && coinbase orders create product_id=BTC-USDC side=SELL ...

# Wait for an order to fill
coinbase orders list --until "status == FILLED"

退出代码 : 0 上游对应, 124 超时, 2 永久流失败 .

coinbase history - 请求历史

通过 CLI 查看和管理最近 API 请求的日志 .

coinbase history        # show recent requests
coinbase history clear  # clear request history

coinbase skills - 工作流程技能

管理可重复使用的工作流程技能(即时模板)来扩展MCP服务器.

coinbase skills list                # list available skills
coinbase skills add                 # install/update all bundled skills
coinbase skills add --dir <path>    # install to a specific directory
coinbase skills remove              # remove all installed skills

Claude 代码/ MCP

coinbase mcp 启动一个 MCP 磁共振 服务器,可以让每个 Coinbase API 端点的 AI 代理输入工具访问。 工具由光谱生成——CLI更新时会自动出现新的端点.

除了API工具外,MCP服务器还披露了用于环境和工作流程管理的元工具:

工具目的
coinbase_set_env切换活动 API 环境
coinbase_env显示当前环境和密钥信息
coinbase_help获取 CLI 命令的使用帮助

如果您在全球安装了 CLI :

claude mcp add --scope user --transport stdio coinbase -- coinbase mcp

仅限 MCP (无需全局安装) npx:

claude mcp add --scope user --transport stdio coinbase -- npx -y @coinbase/coinbase-cli mcp

如果您同时使用 CLI 和 MCP, 请在全球安装, 这样它们共享相同的版本和光谱 .

或增加你的项目 .mcp.json数字 :

{
  "mcpServers": {
    "coinbase": { "transport": "stdio", "command": "coinbase", "args": ["mcp"] }
  }
}

自动核准读取操作 内 .claude/settings.json数字 :

{
  "permissions": {
    "allow": [
      "mcp__coinbase__coinbase_env",
      "mcp__coinbase__coinbase_help",
      "mcp__coinbase__coinbase_*_list",
      "mcp__coinbase__coinbase_*_get"
    ]
  }
}

配置

环境变量覆盖配置文件值 :

变量目的
COINBASE_ENV活动环境名称
COINBASE_KEY_IDAPI 密钥标识
COINBASE_KEY_SECRETAPI 密钥
COINBASE_URL基础 URL 覆盖
COINBASE_NO_HISTORY设定为 1 以禁用请求历史
COINBASE_CONFIG_DIR配置目录( 默认 ): ~/.config/coinbase, (中文(简体) ), %APPDATA%\coinbase 在窗口上)

密钥和状态存储于 config.json 在配置目录中.

捐款

见 捐款额。 。 。 .

警卫

见 警卫。 。 。 .

许可证

麻省理工学院

版本与发布记录

@coinbase/coinbase-cli 共发布 12 个版本,首次发布于 2026/05/19;过去 12 个月发布了 12 个版本。

版本发布日期距今
0.0.11latest2026/10/3110 天前
0.0.102026/10/011 个月前
0.0.92026/09/231 个月前
0.0.82026/09/221 个月前
0.0.72026/09/012 个月前
0.0.62026/08/192 个月前

其他发布通道:placeholder → 0.0.0。

关于 @coinbase/coinbase-cli 的常见问题

@coinbase/coinbase-cli 是什么?

代理商的Coinbase——用于交易、钱包、支付和跨Coinbase平台的CLI和MCP服务器

如何安装 @coinbase/coinbase-cli?

在项目目录运行 npm install @coinbase/coinbase-cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 coinbase,可以用 npx coinbase 直接运行。

@coinbase/coinbase-cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/coinbase__coinbase-cli 是否存在。

@coinbase/coinbase-cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@coinbase/coinbase-cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@coinbase/coinbase-cli 可以商用吗?

@coinbase/coinbase-cli 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@coinbase/coinbase-cli 的下载量有多少?

根据 npm 官方下载统计,@coinbase/coinbase-cli 在 2026/10/11 – 2026/11/09 这 30 天内被下载 3,545 次,日均约 118 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@coinbase/coinbase-cli 还在维护吗?

最新版本 0.0.11 发布于 2026/10/31(10 天前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/05/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。