Bitget Agent Hub

Bitget Agent Hub — Bitget 官方 AI 交易与市场数据生态系统

官方开源工具包，可将 Claude、Cursor、Codex、ChatGPT 及任何兼容 MCP 的 AI Agent 连接到你的 Bitget 账户和市场数据。

快速开始 · 生态系统 · 安装程序 · 交易工具 · 市场工具 · 架构 · 安全 · 常见问题

---

概述

Bitget Agent Hub 是 Bitget 官方的 AI Agent 工具包，涵盖加密货币和代币化美股交易，可将 89 项 Bitget UTA v3 交易与市场分析操作带给 Claude、Cursor、Codex、ChatGPT 及其他 AI Agent。

专为个人交易者、量化开发者，以及任何希望通过自然语言操作加密货币交易所的人打造。

此代码库是整个生态系统的中央入口。详细文档请参阅各个软件包的代码库。

---

快速开始

你想做什么？

What do you want to do with AI?
|
+-- Let an AI Agent trade on Bitget for me
|     |
|     +-- Terminal AI (Claude Code / Codex CLI / OpenClaw)
|     |   -> install agent-cli + agent-skill
|     |
|     +-- Desktop AI (Claude Desktop / Cursor / Continue)
|         -> install agent-mcp
|
+-- Let an AI Agent monitor and analyze the market for me
|     -> install bitget-signal (no account, no API key)
|
+-- I'm a developer building my own Bitget AI tool
      -> install bitget-agent-sdk

使用你的 AI 安装

上面的用例树会告诉你需要哪个软件包。要一次性设置终端工具，请将以下内容粘贴到你的终端 AI（Claude Code、Codex、OpenClaw）中：

Please run `npx @bitget-ai/bitget-agent-installer upgrade-all --target all` to set up the Bitget Agent Hub terminal tools (requires Node.js 20+), then help me verify the install.

此操作会安装 bgc CLI、交易和市场信号技能，并将这些技能部署到 Claude Code、Codex 和 OpenClaw。桌面 AI（Cursor、Claude Desktop、ChatGPT）使用 bitget-agent-mcp，详见交易工具。各软件包的命令、回滚方法和标志详见下方的安装程序。

---

生态系统

Bitget Agent Hub 由 5 个核心软件包组成，每个软件包各司其职。此代码库还提供 bitget-agent-installer 元工具，可一并安装和升级这些软件包。

交易工具（需要 API 密钥）

软件包	适用对象	功能
bitget-agent-sdk	开发者	基础 TypeScript SDK，提供 89 项 UTA v3 操作
bitget-agent-cli	终端 AI	为 Claude Code、Codex、OpenClaw 提供 bgc 命令行工具
bitget-agent-mcp	桌面 AI	为 Claude Desktop、Cursor、Windsurf、ChatGPT 提供 MCP 服务
bitget-agent-skill	终端 AI	AI 推理指南，教你如何正确使用 bgc

市场工具（无需账户）

软件包	功能
bitget-signal	5 项市场分析技能 — 宏观、链上、情绪、技术、新闻

所有软件包均采用 MIT 许可证，可免费使用。它们可以并行安装，互不冲突。

安装器

@bitget-ai/bitget-agent-installer 是整个生态系统的元工具。只需一条命令，即可将 Bitget Agent Hub 软件包安装、升级、回滚并部署到你的 AI 工具中，无需逐个安装软件包，也无需手动运行每个技能的设置流程。

npx @bitget-ai/bitget-agent-installer

不带参数运行即可打开交互式菜单，也可以直接传入命令（见下文）。

管理内容

软件包	作用
bitget-agent-cli	终端交易 CLI bgc
bitget-agent-skill	面向终端 AI 的交易推理指南
bitget-signal	市场分析技能（无需 API 密钥）

桌面 AI 使用 bitget-agent-mcp，需在 MCP 客户端的配置中注册，而不是全局安装——请直接通过 MCP 软件包进行设置。bitget-agent-sdk 是库依赖，无需单独安装。

使用理由

• 一条命令管理整个生态系统 — 一起安装、升级或回滚所有软件包。
• 始终保持最新 — 自动获取每个软件包最新发布的版本；无需固定版本，不同软件包使用不同版本也能正常工作。
• 内置技能部署 — 通过 --target 将技能直接接入 Claude Code、Codex 和 OpenClaw。
• 可逆操作 — 将任何软件包回滚到此前发布的版本。
• 可安全预览 — --dry-run 会打印所有命令，但不会执行。
• 轻量 — 通过 npx 运行单个无依赖脚本；自动检测 npm 或 pnpm。

命令

命令	功能
(无参数)	交互式菜单 — 升级、回滚或部署技能
upgrade-all [--target <tools>]	将所有受管理的软件包安装或更新到最新版本
upgrade <pkg> [--target <tools>]	将一个软件包安装或更新到最新版本
rollback <pkg> --to <version>	将软件包切换到指定的已发布版本
install [pkg] [--target <tools>]	将已安装软件包的技能部署到你的 AI 工具

标志

• --target <tools> — 技能部署目标：claude、codex、openclaw、all（逗号分隔；默认值为 claude）
• --dry-run — 预览命令但不执行
• --version · --help

示例

# Install everything and deploy skills to every supported AI tool
npx @bitget-ai/bitget-agent-installer upgrade-all --target all

# Update just the CLI to the latest version
npx @bitget-ai/bitget-agent-installer upgrade @bitget-ai/bitget-agent-cli

# Roll the CLI back to the pre-v3 release
npx @bitget-ai/bitget-agent-installer rollback @bitget-ai/bitget-agent-cli --to 1.2.0

# Deploy already-installed market-signal skills into Claude Code and Codex
npx @bitget-ai/bitget-agent-installer install @bitget-ai/bitget-signal --target claude,codex

# Preview an upgrade without changing anything
npx @bitget-ai/bitget-agent-installer upgrade-all --target all --dry-run

---

交易工具

让 AI Agent 自动为你交易 Bitget

Bitget Agent Hub 的交易工具通过 14 个精心设计的意图动词提供 89 项 UTA v3 操作：

向 AI 提问	功能
“以市价买入 0.1 BTC”	现货市价单
“开一个 BTC 多头仓位，10 倍杠杆”	期货仓位
“查看我的余额”	账户概览
“将 USDT 转到期货账户”	内部资金划转
“取消所有未完成订单”	批量撤单

选择你的 AI 环境

AI 所在环境…	已安装的软件包
终端 AI：Claude Code、Codex CLI、OpenClaw	bitget-agent-cli + bitget-agent-skill
桌面 AI：Claude Desktop、Cursor、Continue、Windsurf、ChatGPT Desktop	bitget-agent-mcp

开始使用

1. 在 bitget.com/api-management 创建 Bitget API 密钥
2. 运行安装器向导或参阅各软件包的文档
3. 向你的 AI 提问 “有哪些 Bitget 工具可用？”，以验证安装

首次使用？请创建一个演示 API 密钥，并使用 --paper-trading 进行练习，再操作真实资金。

---

市场工具

让 AI Agent 实时监控和分析市场

bitget-signal 添加了 5 项市场分析技能——无需 Bitget 账户，也无需 API 密钥：

向 AI 提问	技能
“美联储政策如何影响 BTC？”	macro-analyst
“巨鲸正在链上转移资产吗？”	market-intel
“市场情绪是恐惧还是贪婪？”	sentiment-analyst
“BTC 的 RSI 是否已超买？”	technical-analysis
“今天加密货币领域有哪些重要消息？”	news-briefing

开始使用

npx @bitget-ai/bitget-signal --target all

重启你的 AI 工具，然后询问市场状况。

即将推出

Bitget 独家信号：

• top-trader-flow：顶级跟单交易员持仓情况
• derivatives-structure：永续合约基差和期限结构
• large-flow-detect：鲸鱼级别订单检测

---

架构

graph TD
    subgraph Surfaces
        A[bitget-agent-cli<br/>Terminal AI]
        B[bitget-agent-mcp<br/>Desktop AI MCP]
        C[bitget-agent-skill<br/>AI Reasoning Guide]
    end
    
    subgraph Foundation
        D[bitget-agent-sdk<br/>TypeScript SDK]
    end
    
    subgraph MarketAnalysis
        E[bitget-signal<br/>5 Analysis Skills]
    end
    
    A --> D
    B --> D
    C --> A
    D --> F[Bitget UTA v3 API]
    E --> G[Public Market-Data MCP<br/>no API key]
    
    style D fill:#f9f,stroke:#333,stroke-width:2px
    style F fill:#bbf,stroke:#333,stroke-width:2px

工作原理：

1. SDK（bitget-agent-sdk）：基础层，提供 89 项操作、HMAC 签名和速率限制
2. CLI（bitget-agent-cli）：基于 SDK 构建的终端命令行工具
3. MCP（bitget-agent-mcp）：基于 SDK 构建的桌面 AI 服务
4. Skill（bitget-agent-skill）：教会终端 AI 如何正确使用 CLI
5. Signal（bitget-signal）：通过公开、无需密钥的市场数据 MCP 服务进行独立市场分析

---

支持的操作

基于 Bitget UTA v3 API，通过 14 个精选意图动词提供 89 项操作：

模块	默认启用	意图动词	需要 API 密钥
market	✅	market	否（公开数据）
trade	✅	order、position、strategy_order	是
account	✅	account_overview、transfer_funds、…	是
strategy	—	通过 raw	是
cryptoloans	—	loan	是
tax	—	tax	是

strategy_order 由 trade 模块控制——下达策略订单属于交易能力，只要启用了交易，Agent 就会期待具备这项能力；strategy 模块的其他操作仍可通过 raw 使用。

此外还有元工具：discover（探索操作）和 raw（通过 operationId 调用任意操作）。

随时使用 bgc discover（或在任何界面中使用 discover）浏览实时目录。

---

安全性

凭据保护

• ✅ 绝不会离开你的设备：API 密钥仅从环境变量中读取
• ✅ 本地签名：所有经过身份验证的请求都在进程内使用 HMAC-SHA256 签名
• ✅ 不解析 .env：工具不会读取 .env 文件，以防止凭据泄漏
• ✅ 不使用代理：直接连接 Bitget 官方 API

安全模式

• --read-only：启动时移除所有写入工具——AI 无法下单或转账
• --paper-trading：请求路由至 Bitget 的 Demo 环境——不涉及真实资金
• 速率限制：内置客户端限流机制，防止 API 滥用

最佳实践

1. 首先使用 Demo API Key 进行测试
2. 先以 --read-only 模式启动，验证查询
3. 切勿将凭据提交到版本控制系统
4. 每 90 天轮换一次 API 密钥

---

文档

主题	文档
入门指南	docs/getting-started.md
生态系统架构	docs/architecture.md

各软件包的参考文档——CLI 标志、MCP 客户端配置、SDK API、信号技能——位于各自的软件包仓库中（参见上方的生态系统表格）。始终可以使用 bgc discover（或在任何界面中使用 discover）浏览实时工具界面。

---

链接

• Bitget：bitget.com
• API 文档：bitget.com/api-doc
• Model Context Protocol：modelcontextprotocol.io
• 所有 Bitget AI 仓库：github.com/Bitget-AI

---

常见问题

什么是 Bitget Agent Hub？

Bitget Agent Hub 是 Bitget 官方开源 AI Agent 生态系统。它将 Bitget 的加密货币交易能力和实时市场数据接入 Claude、Cursor、Codex 和 ChatGPT 等 AI Agent，涵盖通过 14 个精选意图动词提供的 89 项 UTA v3 操作，以及无需账户的市场分析技能。

如何确定要安装哪个软件包？

这取决于你使用的 AI 工具：

• 终端 AI（Claude Code、Codex）→ bitget-agent-cli + bitget-agent-skill
• 桌面 AI（Claude Desktop、Cursor）→ bitget-agent-mcp
• 仅需市场分析 → bitget-signal（无需 API 密钥）
• 开发自定义工具 → bitget-agent-sdk

我可以使用 AI 自动交易加密货币吗？

可以。安装后，你可以让支持的 AI 工具“买入 0.1 BTC”或“以 10 倍杠杆开立 BTC 多头仓位”，AI 就会直接在你的 Bitget 账户中执行。使用 --paper-trading 模式安全地进行演练。

连接我的 API 密钥安全吗？

安全。凭据：

• 仅从环境变量读取
• 从不通过任何服务器代理
• 在本地使用 HMAC-SHA256 签名
• 从不记录日志或写入磁盘

如何防止意外下单？

启动时添加 --read-only。所有写入工具都会被完全移除——AI 无法看到或调用它们。

支持哪些 AI 工具？

Claude Desktop、Claude Code、Cursor、Codex CLI、Continue、Windsurf、ChatGPT Desktop、OpenClaw，以及任何兼容 MCP 的客户端。

免费吗？

所有软件包均采用 MIT 许可，可免费使用。bitget-signal 由 Bitget 维护，可免费使用——无需 API 密钥或账户。

如何更新所有内容？

运行 npx @bitget-ai/bitget-agent-installer 并选择升级，或者：

npx @bitget-ai/bitget-agent-installer upgrade-all --target all

---

贡献

欢迎提交问题和拉取请求。

• 报告错误或请求功能：GitHub Issues
• 安全问题：发送邮件至 [email protected]（请勿公开发布）

---

许可证

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

---

_{⚠️ 风险免责声明：交易加密货币和代币化股票存在重大风险。对于 AI Agent 代表你下达的任何订单，责任完全由你承担。上线实盘前，请务必使用 --read-only 和 --paper-trading 模式安全地进行演练。}

_{Bitget Agent Hub 是 Bitget 官方开源项目 · 属于 Bitget AI 生态系统 · 为交易者、开发者和 AI 爱好者打造}