mcpField
B
Bitget Agent CLI

Bitget Agent CLI

本地服务
npmjs.com金融数据18 周前更新

关于 Bitget Agent CLI

Bitget Agent CLI(bgc)是供基于 Shell 的 AI 助手及其用户使用的终端交易 CLI。它为 Bitget UTA / v3 API 提供可自描述的接口,支持渐进式发现和明确的写操作控制。

主要功能

  1. 01访问 Bitget 七个领域的 API
  2. 02运行时发现操作和参数
  3. 03基于意图的命令动词
  4. 04试运行与只读安全控制
  5. 05JSON 输出与结构化错误

适用场景

  1. 01通过 AI 助手查询 Bitget 市场数据
  2. 02使用写操作安全标志检查或提交交易
  3. 03查找特定操作的 API 参数

MCP 相关

这是 CLI 而非 MCP 服务。它面向 Claude Code、Codex CLI 和 OpenClaw 等基于 Shell 的 AI 助手,用于调用 Bitget UTA / v3 API。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Bitget Agent CLI — 面向 Claude Code、Codex CLI 和 OpenClaw 的终端原生交易工具

bitget-agent-cli — Bitget 的 Agent 原生 CLI

Bitget Agent Hub 的 Shell 入口。通过一组精简的意图动词,以及 Agent 可在运行时探索的自描述界面,让 Claude Code、Codex CLI、OpenClaw 或任何基于 Shell 的 AI 助手调用 Bitget 的统一交易账户(UTA / v3)API。

Bitget Agent CLI 持续集成构建状态 @bitget-ai/bitget-agent-cli 的 npm 软件包版本 @bitget-ai/bitget-agent-cli 的 npm 月下载量 需要 Node.js 20 或更高版本 跨平台:macOS、Linux、Windows MIT 许可证

快速开始 · 为何采用 Agent 原生设计 · 渐进式披露 · 安装 · 命令 · 写入安全 · 安全 · 故障排除 · 常见问题


概述

bitget-agent-cli(二进制文件:bgc)是 Bitget 的官方终端交易工具,专为由基于 Shell 的 AI 助手驱动而构建——无论是 Claude Code、Codex CLI、OpenClaw,还是任何其他运行在终端中的工具——并由人类查看结果。

大多数 CLI 面向人类构建,只是勉强支持自动化。bgc 则反其道而行:每一项设计都围绕由 AI 助手通过 Shell 驱动进行优化。它提供一组精简的意图动词、一套 Agent 可在运行时探索的自描述界面,以及确定性的写入安全机制,让你可以放心地将操作权限交给自主 Agent。

bgc 基于 Bitget 统一交易账户(UTA / v3)API 构建,提供 7 个领域的 89 项操作(market、trade、account、funds、subaccount、loan、tax),由 14 个意图动词以及 discover / raw 元工具提供入口。无需配置宿主应用,也无需插件:安装后,告诉 AI 你要交易什么即可。

更多信息请访问 bitget-agent-cli 产品页面。

隶属于 Bitget Agent Hub——官方开源 AI 生态系统。请访问 Hub,了解桌面 AI 工具(MCP)、基础 SDK 和市场分析技能。


快速开始

前置条件
  • Node.js ≥ 20(下载)
  • Bitget API Key(在此创建)——启用 Read + Trade 权限。仅私有调用(账户 / 交易)需要 API Key;市场数据为公开数据。
一行安装
npm install -g @bitget-ai/bitget-agent-cli
npx @bitget-ai/bitget-agent-skill --target all

然后设置凭据:

export BITGET_API_KEY="your-api-key"
export BITGET_SECRET_KEY="your-secret-key"
export BITGET_PASSPHRASE="your-passphrase"

为什么要同时安装两者? bitget-agent-cli 是执行工具(bgc);bitget-agent-skill 则教你的 AI 何时以及如何使用它。没有技能文件,你的 AI 虽然有工具,却缺少调用它的判断能力。没有 CLI,技能就没有可调用的对象。两者缺一不可。

为什么用 npm install -g,而不是 npx? bgc 是一个常驻 CLI——你的 AI 助手每次会话都会调用它数十次,因此你需要让它位于 $PATH 中,避免每次调用都产生开销。其他 Bitget AI 软件包(bitget-agent-skill、bitget-signal、bitget-agent-mcp)只需运行一次或通过子进程启动,因此使用 npx。

验证安装
bgc --version
bgc discover

预期结果:discover 会列出 7 个领域(market、trade、account、funds、subaccount、loan、tax),以及 raw / discover 元工具。


为什么它适合 Agent

AI Agent 的需求bgc 的解决方式
在运行时了解 API——大模型无法读取你的文档,而且包含 100 项操作的目录无法全部放入上下文通过 discover 渐进式披露:逐层深入领域 → 动词 → 操作 → 精确参数,只加载任务所需的部分
便于推理的接口14 个意图动词(order、position、market……)对应你想做什么;策划动词之外的任何操作,都可以通过一次 raw / --full 调用获取
无需猜测即可组装的调用每个参数的类型、枚举值、认证要求和读写标记都可实时查询——无需维护可能与 SDK 不一致的静态架构
无人值守运行时的安全保障确定性防护开关——--dry-run、--read-only、--confirm、--paper-trading 都是纯标志,不会触发交互式提示
程序可解析的输出符合 Unix 规范的输入输出——JSON 结果写入 stdout(退出码 0),结构化错误写入 stderr(退出码 1);可通过管道传给 jq,并根据退出码进行分支处理

本 README 的其余部分将逐项展开说明。第一项是核心所在。


渐进式披露——核心理念

AI Agent 的上下文窗口有限。预先加载 Bitget 的所有操作及其参数会浪费上下文预算,而且 API 一旦变更就会过时。bgc 则提供一个自描述接口,由 Agent 自上而下逐层探索,只为即将使用的内容付出成本:

bgc discover                               →  7 domains          market, trade, account, funds, subaccount, loan, tax
bgc discover --domain trade                →  3 verbs            order, position, strategy_order
bgc discover --tool order                  → 10 actions          place, cancel, modify, cancelAll, countdownCancel, open, detail, history, fills, maxOpen
bgc discover --tool order --action place   →  the exact contract  required + optional params · types · enums · auth · read/write

最后一层才是重点——它给出了某个操作精确、机器可读的契约:

bgc discover --tool order --action place --pretty
{
  "tool": "order", "action": "place",
  "operationId": "placeOrder", "method": "POST", "path": "/api/v3/trade/place-order",
  "auth": "private", "isWrite": true,
  "required": [
    { "name": "category",  "type": "string", "enum": ["SPOT","MARGIN","USDT-FUTURES","COIN-FUTURES","USDC-FUTURES"] },
    { "name": "symbol",    "type": "string" },
    { "name": "side",      "type": "string", "enum": ["buy","sell"] },
    { "name": "orderType", "type": "string", "enum": ["limit","market"] },
    { "name": "qty",       "type": "string" }
  ],
  "optional": [
    { "name": "price", "type": "string" },
    { "name": "timeInForce", "type": "string", "enum": ["ioc","fok","gtc","post_only"] },
    { "name": "clientOid", "type": "string" },
    { "name": "takeProfit", "type": "string" }, { "name": "stopLoss", "type": "string" }
    /* … tp/sl trigger & limit params … */
  ]
}

有了这些信息,Agent 就能直接组装调用——使用相同的 camelCase 字段名,无需转换层:

bgc order --action place --category SPOT --symbol BTCUSDT \
    --side buy --orderType market --qty 0.001 --dry-run

两个特性让它特别适合 Agent:

  • 自我引导。 每个 discover 响应都包含一个 hint 字段,指出下一层的入口,因此即使 Agent 事先一无所知,也能仅凭 bgc discover 探索整个接口。
  • 零偏移。 披露的架构直接从 SDK 实时生成——此仓库中没有可能过时的静态目录。因此,discover 给出的内容在设计上与 CLI 的实际行为完全一致。

如果 Agent 只有模糊的想法,还可以通过关键词搜索整个接口:

bgc discover --search funding
# → matches: market (actions: fundingRate, fundingRateHistory), account_overview, …

安装

步骤 1 — 安装 CLI
npm install -g @bitget-ai/bitget-agent-cli

这会将 bgc 添加到系统 PATH 中。

步骤 2 — 部署技能文件
npx @bitget-ai/bitget-agent-skill --target all

同时部署到 Claude Code、Codex 和 OpenClaw。要指定单个工具,请使用 --target claude 或 --target codex。

步骤 3 — 设置凭据
# Add to ~/.bashrc, ~/.zshrc, or similar
export BITGET_API_KEY="your-api-key"
export BITGET_SECRET_KEY="your-secret-key"
export BITGET_PASSPHRASE="your-passphrase"

重新加载 shell:

source ~/.bashrc  # or source ~/.zshrc
步骤 4 — 测试连接
# Public data (no auth needed)
bgc market --action tickers --category SPOT --symbol BTCUSDT

# Private data (requires auth)
bgc account_overview --coin USDT

命令

语法
bgc <tool> [--action <name>] [--<param> <value> ...] [global flags]
bgc discover [--domain <d> | --tool <t> [--action <a>] | --search <q>]
bgc raw --operationId <id> [--args '<json>']
  • <tool> 是一个意图动词(market、order、position 等)、元工具 discover / raw 之一,或在使用 --full 时的任意一个 1:1 生成的操作。
  • --action <name> 用于指定操作路由动词对应的操作(例如 order --action place、order --action cancelAll),并原样转发给 SDK。(account_overview、discover 和 raw 不接受 --action。)
  • 业务参数使用 SDK 完全一致的 camelCase 字段名原样转发:--symbol BTCUSDT --side buy --orderType market --qty 0.001。值会根据类型自然转换——true / false → 布尔值,以 [ / { 开头的值 → 解析为 JSON(例如 --orders '[{...}]'),其他值均保持为字符串(SDK 会转换数值,因此数值 ID 不会被误判为其他类型)。

你不必记住命令参考——bgc discover 就是 参考,而且它不会过时。

意图动词(14 个,涵盖 7 个领域)

默认的(intent)接口提供14 个意图动词,涵盖 7 个领域——其中 13 个采用操作路由(通过 --action 选择操作),另有一个单次调用的 account_overview——以及元工具 discover / raw。

领域动词身份验证描述示例
marketmarket公开行情、订单簿、K 线、资金费率、未平仓合约、近期成交bgc market --action tickers --symbol BTCUSDT
tradeorder私有下单、取消、修改、cancelAll、倒计时、未结订单 / 详情 / 历史 / 成交bgc order --action place --side buy --qty 0.1
tradeposition私有持仓信息、历史、ADL 排名、平仓、全部平仓bgc position --action info --category USDT-FUTURES
tradestrategy_order私有策略(触发 / 计划)订单:下单、取消、修改、未结订单、历史bgc strategy_order --action open
accountaccount_overview私有一次调用获取账户快照(资产 + 设置 + 资金资产 + 持仓 + 手续费)bgc account_overview --coin USDT
accountaccount_config私有账户设置和 API 密钥信息bgc account_config --action info
accountrepayment私有全仓 / 逐仓还款bgc repayment --action repay --coin USDT
fundstransfer_funds私有在账户间转移资金bgc transfer_funds --fromAccountType spot --toAccountType futures --amount 100
fundsdeposit私有充值地址和记录bgc deposit --action address --coin USDT
fundswithdraw私有提交提现申请(高风险,需使用 --confirm)bgc withdraw --action submit --coin USDT --amount 100
fundsfunds_records私有划转 / 充值 / 提现历史bgc funds_records --action list
subaccountsubaccount私有管理子账户及其充值bgc subaccount --action list
loanloan私有借入 / 偿还加密货币贷款bgc loan --action borrow --coin USDT
taxtax私有查询交易税记录bgc tax --action history --year 2024

对于精选动词未涵盖的操作,请使用 raw --operationId <id>。

全局标志
标志用途示例
--action <name>对按操作路由的动词执行操作bgc order --action place
--modules <list>要启用的模块(默认:所有 to-C 模块)bgc --modules account,trade ...
--surface <mode>intent(默认)| full(同时公开一对一操作)bgc --surface full discover
--full--surface full 的简写bgc --full discover
--read-only阻止所有写入(与 --paper-trading 互斥)bgc --read-only market ...
--paper-trading将写入路由到 Bitget 的模拟环境(需要模拟环境凭据)bgc --paper-trading order ...
--dry-run预览写入操作,但不发送bgc order --action place ... --dry-run
--confirm执行破坏性(高风险)写入操作时必需bgc order --action cancelAll ... --confirm
--base-url <url>覆盖 API 基础 URL(否则使用 BITGET_API_BASE_URL)
--timeout <ms>每个请求的超时时间,单位为毫秒(否则使用 BITGET_TIMEOUT_MS,默认值为 15000)
--pretty美化打印 JSON 输出bgc market ... --pretty
--help显示帮助(动词列表从 SDK 实时获取)bgc --help
--version显示版本bgc --version
环境变量
BITGET_API_KEY        API key      ┐
BITGET_SECRET_KEY     API secret   ├─ required only for private (account / trade) calls
BITGET_PASSPHRASE     passphrase   ┘
BITGET_API_BASE_URL   override the API base URL (else --base-url, else Bitget default)
BITGET_TIMEOUT_MS     per-request timeout in ms (else --timeout, default 15000)

凭据仅从环境中读取——绝不记录日志,也绝不写入磁盘。

实际示例
# Get BTC live price (no auth)
bgc market --action tickers --category SPOT --symbol BTCUSDT

# Check USDT balance (one-call snapshot)
bgc account_overview --coin USDT

# Preview a limit buy (dry run — nothing leaves the process)
bgc order --action place --category SPOT --symbol BTCUSDT \
  --side buy --orderType limit --price 60000 --qty 0.001 --dry-run

# Execute the order
bgc order --action place --category SPOT --symbol BTCUSDT \
  --side buy --orderType limit --price 60000 --qty 0.001

# Cancel a specific order
bgc order --action cancel --category SPOT --orderId 123456789

# Check futures positions
bgc position --action info --category USDT-FUTURES

# Set leverage to 10x
bgc position --action setLeverage --category USDT-FUTURES \
  --symbol BTCUSDT --leverage 10 --marginCoin USDT

# High-risk: cancel all orders (requires confirmation)
bgc order --action cancelAll --category SPOT --symbol BTCUSDT --confirm

# Pipe to jq for processing
bgc market --action tickers --category SPOT --symbol BTCUSDT | jq '.data[0].lastPr'

# Explore available actions for a tool
bgc discover --tool order --action place

# Escape hatch: call any operation by ID
bgc raw --operationId getTickers --args '{"category":"SPOT","symbol":"BTCUSDT"}'

写入安全

bgc 继承了 SDK 的分层写入安全机制。每项安全决策都在请求离开进程之前作出,并且所有控制项都是确定性标志——不会弹出交互式提示——因此可安全地用于无人值守和 AI 驱动的 shell。

控制项效果
--dry-run预览写入操作并返回原本将要发送的确切负载(data.dryRun: true)。不会发起网络调用。
--read-only在验证阶段阻止所有写入——写入动词会返回 ValidationError,且绝不会访问网络。
--confirm执行破坏性/高风险操作时必需(order --action cancelAll、position --action closeAll、withdraw --action submit,……)。如果未提供,该调用会返回 data.confirmationRequired: true,并且不执行任何操作。
--paper-trading将写入路由到 Bitget 的模拟环境(需要模拟环境凭据)。与 --read-only 互斥。
# Dry-run: see what would be sent, send nothing
bgc order --action place --category SPOT --symbol BTCUSDT \
    --side buy --orderType market --qty 0.001 --dry-run

# Read-only: writes are refused before the network
bgc --read-only order --action place --category SPOT --symbol BTCUSDT --side buy ...
# → ValidationError: Operation "placeOrder" is a write and readOnly mode is enabled.

# High-risk gate: cancelAll does nothing until you confirm
bgc order --action cancelAll --category SPOT --symbol BTCUSDT
# → { data: { confirmationRequired: true, ... } }     (stdout, exit 0 — not an error)
bgc order --action cancelAll --category SPOT --symbol BTCUSDT --confirm
# → executes

输出约定

  • 成功 → 打印解析后的 ToolResult({ endpoint, requestTime, data })到 stdout;退出代码为 0。dryRun 预览和 confirmationRequired 门控属于正常结果(stdout,退出代码为 0)——它们不是错误。
  • 失败 → 打印结构化错误负载({ ok: false, error: { type, category, message, suggestion, retryable }, timestamp })到 stderr;退出代码为 1。

成功输出为紧凑 JSON(添加 --pretty 可使用 2 个空格缩进);错误负载始终以美化格式打印。该输出拆分符合 Unix 惯例:将 stdout 传递给 jq,根据退出代码分支,并读取 error.retryable 来决定是否退避后重试。


bgc 的构建方式

bgc 是围绕 Bitget Agent SDK 构建的轻量、零业务逻辑 shell 包装器。所有路由、验证、写入安全、规范化——以及发现界面本身——都由 SDK 负责。CLI 只解析 argv、构建配置好的界面、转发调用并打印结果:

Terminal AI (Claude Code / Codex / OpenClaw)
        │  natural language → bgc … command
        ▼
bgc CLI  (argv → tool call → JSON on stdout / error on stderr)
        │
        ▼
@bitget-ai/bitget-agent-sdk  (intent verbs, action dispatch, progressive
        │                      discovery, write-safety, REST client, HMAC
        │                      signing, rate limiting)
        ▼
Bitget UTA (v3) REST API   (api.bitget.com)

由于发现和安全逻辑都位于 SDK 中,CLI 可以自动获得新增操作、参数和门控——规范变更会反映在 bgc discover 中,无需在此处修改代码。每条命令都会转换为一个经过签名的 HTTPS 请求。没有遥测、没有代理,也没有远程依赖。


bgc 的定位

bgc 旨在让已在你的 shell 中运行的 AI 助手(Claude Code、Codex CLI、OpenClaw)无需额外配置集成,即可操作 Bitget。大模型编写 bgc … 命令,shell 执行命令,然后返回 JSON。

  • 想使用 MCP?(Claude Desktop、Cursor、Continue、ChatGPT Desktop、Windsurf)→ @bitget-ai/bitget-agent-mcp — 提供相同的意图接口,采用 MCP 形式。

  • 希望助手无需逐条学习命令,就能知道何时调用 bgc? 在此基础上安装 Bitget Agent Skill:

    npx @bitget-ai/bitget-agent-skill --target all
    

    然后说 “在 Bitget 上以市价买入 0.1 BTC” 或 “显示我未平仓的期货仓位”,它就会组合出正确的 bgc 调用。


安全性

凭据保护
  • ✅ 仅使用环境变量:从 BITGET_API_KEY、BITGET_SECRET_KEY、BITGET_PASSPHRASE 读取 API 密钥——不会解析 .env 文件、不会记录日志,也不会写入磁盘。
  • ✅ 本地签名:所有经过身份验证的请求都会在进程内使用 HMAC-SHA256 签名,然后才发送至 Bitget API。
  • ✅ 无遥测、无代理:每条命令都会直接转换为发送至 api.bitget.com 的单个已签名 HTTPS 请求,不涉及任何第三方服务。
安全功能
  • --read-only 模式:在验证时移除所有写入工具。写入操作会返回 ValidationError,且不会发出网络请求——AI 既无法查看,也无法调用下单、转账或取消操作。
  • --dry-run:预览将要发送的确切负载,不会发出网络请求。
  • --confirm 确认门槛:高风险操作(cancelAll、closeAll、withdraw 等)会返回 confirmationRequired: true,只有传入 --confirm 才会执行。
  • --paper-trading:将写入操作路由至 Bitget 的演示环境。
  • 客户端限流:防止 AI 意外陷入循环,触发 Bitget API 限制。
最佳实践
  1. 先使用 Demo API Key — 在 bitget.com/api-management 创建,并使用 --paper-trading 测试。
  2. 从 --read-only 开始 — 在启用写入操作前,先确认查询正常。
  3. 切勿提交凭据 — 将 BITGET_* 变量添加到仓库之外的 shell 配置文件中,或使用密钥管理器。不要将它们放入提交到项目中的 .env 文件。
  4. 定期轮换密钥 — 每 90 天重新生成 API 密钥。

故障排除

“bgc: command not found”

原因:CLI 未全局安装,或 npm 的全局 bin 目录不在 $PATH 中。

解决方法:

npm install -g @bitget-ai/bitget-agent-cli
which bgc

如果仍然找不到,请将 npm 的全局 bin 目录添加到 PATH:

# macOS / Linux
export PATH="$(npm config get prefix)/bin:$PATH"
# Add to ~/.bashrc or ~/.zshrc
“Authentication failed” 或 “Invalid signature”

可能原因:

  1. API 密钥权限不足(私有请求需要 Read + Trade 权限)。
  2. Passphrase 不正确(请准确复制,区分大小写)。
  3. 系统时钟不同步(HMAC 需要准确的时间戳)。

解决方法:

  • 在 bitget.com/api-management 确认已授予 Read + Trade 权限。
  • 仔细检查全部三项凭据。
  • 同步系统时钟:sudo sntp -sS pool.ntp.org(macOS)/ sudo ntpdate -s pool.ntp.org(Linux)。
“Skill not recognized by AI”

原因:未部署 skill 文件,或部署后未重启 AI 工具。

解决方法:

  1. 重新部署 skill:npx @bitget-ai/bitget-agent-skill --target all
  2. 重启 AI 工具(Claude Code / Codex CLI)。
  3. 向 AI 提问:“有哪些 Bitget 交易模块可用?” — 它应列出 bgc discover 报告的各个领域。
“Rate limit exceeded”

原因:API 调用过于频繁。CLI 会在客户端进行限流,但仍可能触发 Bitget 服务端的限制。

解决方法:等待 60 秒后重试。避免要求 AI 在短时间内循环执行数百笔订单。

“Module not loaded” 错误

原因:尝试使用当前配置中未启用的模块。

解决方法:

# Load specific modules
bgc --modules account,trade,market ...

# Or load every module
bgc --modules all ...

更新

更新到最新版本:

npm install -g @bitget-ai/bitget-agent-cli@latest
npx @bitget-ai/bitget-agent-skill@latest --target all

请参阅 CHANGELOG.md 了解发布历史。


相关项目

软件包用途最适合
bitget-agent-cli(本仓库)Shell 命令行工具(bgc)——通过 14 个意图动词执行 89 项 UTA v3 操作Claude Code、Codex CLI、OpenClaw
bitget-agent-mcpMCP 服务——提供相同的意图接口,采用 MCP 形式Claude Desktop、Cursor、Continue、Windsurf
bitget-agent-skillAI 推理指南——教 AI 何时使用 bgc与 bgc 或 MCP 服务搭配使用
bitget-agent-sdkTypeScript 基础 SDK构建自定义集成的开发者
bitget-signal市场分析技能(宏观、链上、情绪)无需 API 密钥
agent_hub生态系统中央入口了解所有 Bitget AI 工具

常见问题

什么是 bitget-agent-cli?

bitget-agent-cli 是 Bitget 的官方终端 AI 交易工具,为 Claude Code、Codex CLI、OpenClaw 和其他基于 Shell 的 AI 助手提供命令行界面(bgc),用于操作 Bitget 账户。它基于 Bitget Unified Trading Account(UTA / v3)API 构建,通过 14 个意图动词提供涵盖市场数据、现货/期货交易、账户、资金、子账户、借贷和税务的 7 个领域共 89 项操作。

我需要同时使用 bitget-agent-cli 和 bitget-agent-skill 吗?

需要。 终端 AI 用户应同时安装两者:

  • bitget-agent-cli 是执行工具——它负责签署请求并将其发送到 Bitget API。
  • bitget-agent-skill 是 AI 的操作手册——它会告诉 AI 何时以及如何组合正确的 bgc 调用。

没有该技能,AI 虽然有工具,却无法可靠地调用它。没有命令行工具,该技能也无从调用。

我使用 Claude Desktop / Cursor——应该安装这个吗?

不需要。 Claude Desktop 和 Cursor 是桌面 AI 工具。请改为安装 bitget-agent-mcp。bitget-agent-cli 专为终端 AI(Claude Code、Codex CLI、OpenClaw)设计。

如何确认技能已正确加载?

询问你的 AI:“bitget-agent-cli 支持哪些 Bitget 交易模块?” 如果它列出的领域与 bgc discover 报告的一致(market、trade、account、funds、subaccount、loan、tax),则说明技能已启用。你也可以直接运行 bgc discover 查看当前可用接口。

如何防止 AI 误下订单?

添加 --read-only:

bgc --read-only market --action tickers --symbol BTCUSDT

写入操作会在验证阶段被拦截——写入动词会返回 ValidationError,不会发送到网络。

我的 API 密钥安全吗?

安全。凭据:

  • 仅从环境变量读取——不会从 .env 文件解析、不会记录日志,也不会写入磁盘。
  • 在本地使用 HMAC-SHA256 签名。
  • 直接发送到 api.bitget.com——没有第三方代理,也没有遥测。
我可以在不冒真实资金风险的情况下练习吗?

可以。请使用模拟交易:

  1. 在 Bitget 创建 Demo API Key。
  2. 将 Demo 凭据设为环境变量。
  3. 在 bgc 调用中添加 --paper-trading。

所有写入操作都会发送到 Bitget 的沙盒环境。

这与直接调用 Bitget API 有什么区别?

bgc 提供:

  • 14 个精选意图动词,而不是原始端点。
  • 通过 discover 实现渐进式披露——Agent 无需加载整个目录,就能了解某项操作的准确契约。
  • 自动 HMAC 签名和客户端限流。
  • 通过技能文件实现自然语言集成。
  • 确定性的写入安全机制(--dry-run、--read-only、--confirm、--paper-trading)——无需交互式提示,适合无人值守的 Shell。
  • 符合 Unix 规范的 I/O——JSON 输出到 stdout(退出码为 0),结构化错误输出到 stderr(退出码为 1)。

你可以直接调用 API,但需要自行实现以上所有功能。

bgc discover 有什么用途?

它是自描述接口。运行 bgc discover 可列出领域,运行 bgc discover --domain trade 可列出某个领域的动词,运行 bgc discover --tool order 可列出某个动词的操作,运行 bgc discover --tool order --action place 可查看某项操作的准确必需/可选参数。该架构实时派生自 SDK——discover 所显示的内容必然与 CLI 的实际行为完全一致。

它免费吗?

是的。采用 MIT 许可,可免费使用。由 Bitget 免费维护。

如何更新?

请参阅上文的更新。


贡献

欢迎提交问题和拉取请求!提交之前,请阅读我们的贡献指南。


许可证

MIT License — 可免费用于个人和商业用途。欢迎注明出处,但并非必须。


⚠️ 风险免责声明:加密货币交易具有重大风险。你需对 AI Agent 代表你下达的任何订单独自承担责任。请务必先使用 --read-only 和 --paper-trading 安全演练,再进行实盘交易。过往业绩不代表未来表现。

属于 Bitget Agent Hub 生态系统 · 交易技术栈 · 接口。
基础: agent-sdk · 其他接口:agent-mcp · agent-skill · 市场信号:bitget-signal

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。