@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:=value | Raw 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_ID | API 密钥标识 |
COINBASE_KEY_SECRET | API 密钥 |
COINBASE_URL | 基础 URL 覆盖 |
COINBASE_NO_HISTORY | 设定为 1 以禁用请求历史 |
COINBASE_CONFIG_DIR | 配置目录( 默认 ): ~/.config/coinbase, (中文(简体) ), %APPDATA%\coinbase 在窗口上) |
密钥和状态存储于 config.json 在配置目录中.
捐款
见 捐款额。 。 。 .
警卫
见 警卫。 。 。 .