关于 Bitget Agent CLI
Bitget Agent CLI(bgc)是供基于 Shell 的 AI 助手及其用户使用的终端交易 CLI。它为 Bitget UTA / v3 API 提供可自描述的接口,支持渐进式发现和明确的写操作控制。
主要功能
- 01访问 Bitget 七个领域的 API
- 02运行时发现操作和参数
- 03基于意图的命令动词
- 04试运行与只读安全控制
- 05JSON 输出与结构化错误
适用场景
- 01通过 AI 助手查询 Bitget 市场数据
- 02使用写操作安全标志检查或提交交易
- 03查找特定操作的 API 参数
MCP 相关
这是 CLI 而非 MCP 服务。它面向 Claude Code、Codex CLI 和 OpenClaw 等基于 Shell 的 AI 助手,用于调用 Bitget UTA / v3 API。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
bitget-agent-cli — Bitget 的 Agent 原生 CLI
Bitget Agent Hub 的 Shell 入口。通过一组精简的意图动词,以及 Agent 可在运行时探索的自描述界面,让 Claude Code、Codex CLI、OpenClaw 或任何基于 Shell 的 AI 助手调用 Bitget 的统一交易账户(UTA / v3)API。
快速开始 · 为何采用 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 和市场分析技能。
快速开始
前置条件
一行安装
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。
| 领域 | 动词 | 身份验证 | 描述 | 示例 |
|---|---|---|---|---|
market | market | 公开 | 行情、订单簿、K 线、资金费率、未平仓合约、近期成交 | bgc market --action tickers --symbol BTCUSDT |
trade | order | 私有 | 下单、取消、修改、cancelAll、倒计时、未结订单 / 详情 / 历史 / 成交 | bgc order --action place --side buy --qty 0.1 |
trade | position | 私有 | 持仓信息、历史、ADL 排名、平仓、全部平仓 | bgc position --action info --category USDT-FUTURES |
trade | strategy_order | 私有 | 策略(触发 / 计划)订单:下单、取消、修改、未结订单、历史 | bgc strategy_order --action open |
account | account_overview | 私有 | 一次调用获取账户快照(资产 + 设置 + 资金资产 + 持仓 + 手续费) | bgc account_overview --coin USDT |
account | account_config | 私有 | 账户设置和 API 密钥信息 | bgc account_config --action info |
account | repayment | 私有 | 全仓 / 逐仓还款 | bgc repayment --action repay --coin USDT |
funds | transfer_funds | 私有 | 在账户间转移资金 | bgc transfer_funds --fromAccountType spot --toAccountType futures --amount 100 |
funds | deposit | 私有 | 充值地址和记录 | bgc deposit --action address --coin USDT |
funds | withdraw | 私有 | 提交提现申请(高风险,需使用 --confirm) | bgc withdraw --action submit --coin USDT --amount 100 |
funds | funds_records | 私有 | 划转 / 充值 / 提现历史 | bgc funds_records --action list |
subaccount | subaccount | 私有 | 管理子账户及其充值 | bgc subaccount --action list |
loan | loan | 私有 | 借入 / 偿还加密货币贷款 | bgc loan --action borrow --coin USDT |
tax | tax | 私有 | 查询交易税记录 | 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 限制。
最佳实践
- 先使用 Demo API Key — 在 bitget.com/api-management 创建,并使用
--paper-trading测试。 - 从
--read-only开始 — 在启用写入操作前,先确认查询正常。 - 切勿提交凭据 — 将
BITGET_*变量添加到仓库之外的 shell 配置文件中,或使用密钥管理器。不要将它们放入提交到项目中的.env文件。 - 定期轮换密钥 — 每 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”
可能原因:
- API 密钥权限不足(私有请求需要 Read + Trade 权限)。
- Passphrase 不正确(请准确复制,区分大小写)。
- 系统时钟不同步(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 工具。
解决方法:
- 重新部署 skill:
npx @bitget-ai/bitget-agent-skill --target all - 重启 AI 工具(Claude Code / Codex CLI)。
- 向 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-mcp | MCP 服务——提供相同的意图接口,采用 MCP 形式 | Claude Desktop、Cursor、Continue、Windsurf |
| bitget-agent-skill | AI 推理指南——教 AI 何时使用 bgc | 与 bgc 或 MCP 服务搭配使用 |
| bitget-agent-sdk | TypeScript 基础 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——没有第三方代理,也没有遥测。
我可以在不冒真实资金风险的情况下练习吗?
可以。请使用模拟交易:
- 在 Bitget 创建 Demo API Key。
- 将 Demo 凭据设为环境变量。
- 在
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 免费维护。
如何更新?
请参阅上文的更新。
贡献
欢迎提交问题和拉取请求!提交之前,请阅读我们的贡献指南。
- 报告错误:GitHub Issues
- 请求新功能:GitHub Discussions
- 安全问题:发送邮件至 [email protected](请勿公开发布)
许可证
MIT License — 可免费用于个人和商业用途。欢迎注明出处,但并非必须。
⚠️ 风险免责声明:加密货币交易具有重大风险。你需对 AI Agent 代表你下达的任何订单独自承担责任。请务必先使用 --read-only 和 --paper-trading 安全演练,再进行实盘交易。过往业绩不代表未来表现。
属于 Bitget Agent Hub 生态系统 · 交易技术栈 · 接口。
基础: agent-sdk · 其他接口:agent-mcp · agent-skill · 市场信号:bitget-signal
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。