Agent Hub

不用打开交易所，说一句话，AI 帮你直接在 Claude、Cursor、Codex 里操作你的 Bitget 账户交易美股和加密货币。

以本地进程方式运行在你的设备上 · API Key 经 HMAC-SHA256 在本机签名，不经任何第三方服务器 · MIT 开源

GitHub · API 文档 · 获取 API Key · Telegram 社群

文档目录

Code
Bitget AgentHub
│
├── 能做什么
├── 选择安装路径
│
├── 具体的安装指南
│   ├── MCP Server    ← Claude Desktop / Cursor / Windsurf / Codex，OAuth 一键连接
│   ├── CLI · bgc     ← Claude Code / Codex CLI / OpenClaw
│   ├── Skill         ← 配合 CLI，教 AI 何时调用、如何调用
│   ├── Signal        ← 实时数据获取 + AI 分析，无需账户
│   ├── bitget-mcp-server  ← 美股、ETF 与分析师数据，无需账户
│   └── SDK           ← 开发者自建集成
│
├── 安全须知
└── FAQ

能做什么

用 AI 做交易这件事，最麻烦的不是策略，是要在 AI 和交易所之间反复切换——问完 AI 再去手动下单，看完行情再回来对话。AgentHub 把这两步合并：你只需要在 AI 里说一句话，剩下的它来做。

选择你的安装路径

根据你用的 AI 工具选择：

Code
请阅读【https://www.bitget.com/support/articles/12560603894122】完成 Bitget Agentic 账户授权，并运行 npx @bitget-ai/bitget-agent-installer upgrade-all --target all。

前置条件：Node.js ≥ 20（运行 node -v 确认版本）

Agentic 账户

Agentic 账户是通过 OAuth 授权连接的独立交易账户，与主账户资金分开。授权后，MCP/CLI 工具即获得该账户下的交易权限，无需你手填 Key。

把下面这段话直接粘贴给你的 AI，它会引导你完成浏览器 OAuth 并安装好对应工具：

Code
请阅读【https://www.bitget.com/support/articles/12560603894122】完成 Bitget Agentic 账户授权和对应MCP的安装。

MCP Server

以下安装步骤对所有工具通用，核心命令 npx -y @bitget-ai/bitget-agent-mcp 不变。唯一的区别是配置文件的位置——在 Step 1 的表格里找到你用的工具对应的路径即可。

让 AI 帮你配置（推荐）

把下面这段话直接粘贴给你的 AI，它会自动完成配置：

Code
请阅读【https://www.bitget.com/support/articles/12560603894122】完成 Bitget Agentic 账户授权和对应MCP的安装。

关于这次授权

交易前需先在 Web 端把资金从主账户划转到 Agentic 账户，Agent 无法代办划转和提币。凭证落盘后交易工具即可用，无需重启 Agent；断链或凭证失效时需重新走一遍 OAuth。

手动配置

Step 1 — 打开你的 AI 工具配置文件：

Step 2 — 将以下内容添加到配置文件中。注意不需要填写任何 API Key：启动后首次使用交易类工具时，AI 会自动引导你完成浏览器 OAuth 授权，凭证由 Bitget 服务端签发并自动保存在本地：

Code
{
  "mcpServers": {
    "bitget": {
      "command": "npx",
      "args": ["-y", "@bitget-ai/bitget-agent-mcp"]
    }
  }
}

Step 3 — 完全退出并重启 AI 工具。

Step 4 — 在 AI 对话里输入「BTC 现价是多少？」，收到行情数据说明基础配置成功。再问一句需要交易权限的话（比如「查一下我的账户余额」），AI 会自动打开浏览器引导你完成 OAuth 授权——详见上方"关于这次授权"。

按需调整模式

在 args 里追加参数切换：

示例——只读模式：

Code
"args": ["-y", "@bitget-ai/bitget-agent-mcp", "--read-only"]

代理配置

如果你需要通过 VPN 或代理访问网络，在 MCP 配置里加入 env 块（仅用于代理网络配置，与账户授权无关，填入你自己的代理地址）：

Code
"env": {
  "HTTPS_PROXY": "你的代理地址，例如 http://127.0.0.1:端口号",
  "NODE_USE_ENV_PROXY": "1"
}

装完后 AI 能做什么

加载额外模块："args": ["-y", "@bitget-ai/bitget-agent-mcp", "--modules", "all"]

试试这几句话

Code
BTC 现价是多少？
查一下我的 USDT 余额，再看看有哪些合约持仓
帮我在模拟盘开一个 BTC 多仓，10 倍杠杆，0.01 BTC
先看一下 BTC 现价，再帮我挂一个比现价低 2% 的限价买单

CLI · bgc

以下安装步骤对所有工具通用，安装命令运行后会自动检测你已安装的工具并分别部署，无需为每个工具单独操作。

一键安装

把下面这段话粘贴给你的终端 AI，或直接在终端运行：

Code
请执行以下命令安装 Bitget Agent Hub 终端工具（需要 Node.js 20+）：
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
安装完成后帮我验证：运行 `bgc --version` 和 `bgc discover`，把结果告诉我。

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

这条命令会安装 bgc CLI、交易 Skill 和市场分析 Skill，并自动部署到 Claude Code / Codex / OpenClaw。

配置 API Key

想要 OAuth 免手配 Key 的方式？可以改用上方的 MCP Server 安装路径，通过浏览器 OAuth 一键连接，无需手动创建和保存 Key。bgc 目前仍需手动配置 API Key：还没有 API Key？前往 API 管理页面 → 创建 API Key，勾选 Read + Trade 权限，保存好 API Key、Secret Key、Passphrase 三个值。建议先创建 Demo Key 配合 --paper-trading 练手，再切换实盘。

Code
export BITGET_API_KEY="你的 API Key"
export BITGET_SECRET_KEY="你的 Secret Key"
export BITGET_PASSPHRASE="你的 Passphrase"

验证安装

Code
bgc --version         # 查看版本号
bgc discover          # 查看所有可用操作

完整工具列表

bgc 通过 12 个意图动词覆盖所有操作：

常用命令

Code
# 查看账户余额
bgc account_overview --coin USDT

# 预览下单（加 --dry-run 不会真正发单）
bgc order --action place --category SPOT --symbol BTCUSDT \
  --side buy --orderType market --qty 0.001 --dry-run

# 查看合约持仓
bgc position --category linear

# 预览资金划转
bgc transfer_funds --action transfer --fromType spot --toType mix_usdt \
  --amount 100 --coin USDT --dry-run

安全标志：

代理配置

如果你需要通过 VPN 或代理访问网络，可在环境变量中设置（填入你自己的代理地址）：

Code
export HTTPS_PROXY="你的代理地址"

或在命令中指定 API 基础地址：

Code
export BITGET_API_BASE_URL="https://api.bitget.com"

试试这几句话

Code
BTC 现价是多少？
查一下我的 USDT 余额，把 500 USDT 划转到合约账户
在模拟盘开一个 BTC 多仓，10 倍杠杆，0.01 BTC
查一下我的 BTC 持仓，如果没有就在模拟盘开一个 10 倍多仓

Signal（无需账户）

不需要 Bitget 账户，也不需要 API Key。安装后会在本地部署 5 个 Skill 文件，并注册一个远程公开 MCP 数据服务（https://datahub.noxiaohao.com/mcp）作为数据源——AI 的分析基于这个服务实时返回的真实数据，不是凭空生成。

五个数据方向：

安装

粘贴给你的 AI，或直接在终端运行：

Code
请执行 `npx @bitget-ai/bitget-signal --target all`（需要 Node.js 20+），
安装 Bitget 市场分析 Skill，完成后提醒我重启 AI 工具。

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

安装完成后重启 AI 工具，然后直接提问即可。

Code
pip install pandas numpy

bitget-mcp-server（新增）

bitget-mcp-server 是独立的只读数据服务，覆盖美股/ETF行情与公司数据；和 Signal（加密货币宏观/情绪/技术面/新闻）是两个不同产品，不共用数据源或凭证，同样不需要 Bitget 账户或 API Key。

Code
claude mcp add bitget-mcp-server --transport http https://agent.bitget.com/mcp

Skill

Skill 是一份装进 AI 工具里的说明文件，告诉 AI 什么时候该调用 bgc、怎么拼命令、写操作前如何提示你确认。没有 Skill，AI 有工具但不知道怎么用。

使用 CLI 一键安装时（upgrade-all）已自动包含，无需单独安装。如需单独部署：

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

部署完成后重启 AI 工具生效。

SDK（开发者）

安装

Code
npm install @bitget-ai/bitget-agent-sdk

环境要求：Node.js ≥ 20 · ESM only · 零运行时依赖 · 包含 TypeScript 类型

快速上手

Code
import { loadConfig, buildTools, BitgetRestClient, safeInvoke } from "@bitget-ai/bitget-agent-sdk";

// 从只读开始，安全的默认值
const config = loadConfig({ modules: "all", readOnly: true });
const client = new BitgetRestClient(config);
const tools = buildTools(config);
const ctx = { config, client };

// 查询公开行情，无需 API Key
const market = tools.find((t) => t.name === "market")!;
const res = await safeInvoke(market, { action: "tickers", category: "SPOT", symbol: "BTCUSDT" }, ctx);

if (res.ok) console.log(res.data);
else console.error(res.error);

配置选项

运行时探索

不需要提前背操作列表，用 discover 在运行时查看可用工具和参数：

Code
const discover = tools.find((t) => t.name === "discover")!;

await safeInvoke(discover, {}, ctx);                                     // 列出所有域和工具数量
await safeInvoke(discover, { domain: "trade" }, ctx);                    // 查看 trade 域下的工具
await safeInvoke(discover, { tool: "market", action: "tickers" }, ctx);  // 查看具体操作的参数契约
await safeInvoke(discover, { search: "funding" }, ctx);                  // 关键词搜索

错误处理

推荐用 safeInvoke，永不抛出异常：

Code
const res = await safeInvoke(tool, args, ctx);
if (res.ok) {
  // res.data
} else {
  // res.error — 可直接作为 LLM 工具调用的错误响应
}

需要精细控制时，使用类型化错误：

Code
import { BitgetApiError, RateLimitError, ConfigError } from "@bitget-ai/bitget-agent-sdk";

try {
  await tool.handler(args, ctx);
} catch (err) {
  if (err instanceof RateLimitError) { /* 退避重试 */ }
  else if (err instanceof BitgetApiError) { console.error(err.code, err.message); }
  else if (err instanceof ConfigError) { /* 凭证缺失或无效 */ }
}

集成测试

SDK 内置 MockServer，无需调用真实 API：

Code
import { MockServer } from "@bitget-ai/bitget-agent-sdk/testing";
import { loadConfig, BitgetRestClient } from "@bitget-ai/bitget-agent-sdk";

const mock = new MockServer();
await mock.start();

const config = loadConfig({ modules: "market", baseUrl: mock.baseUrl, apiKey: "test", secretKey: "test", passphrase: "test" });
const client = new BitgetRestClient(config);

// 针对 client 编写测试 ...

await mock.stop();

更多：agent-sdk

安全须知

AgentHub 在设计上保证你的凭证不离开本机：API Key 只从环境变量读取，所有请求在本地完成 HMAC-SHA256 签名后直连 api.bitget.com，没有中间层，没有遥测，没有日志上传。Agentic 账户的凭证遵循同样原则：OAuth 完成后由 MCP/SDK 在本地保存，AI 不会手动填写或粘贴它。

AgentHub 内置了四层保护机制：

建议从模拟盘开始，验证行为符合预期后再切换实盘。创建 API Key 时按最小权限原则，不需要提现就不要开启。

FAQ

Q: 我的 AI 工具不在列表里，能用吗？

A: 支持 MCP 协议的客户端都可以接入，方式与桌面端 AI 相同；支持调用外部命令的终端 AI 可以使用 bgc 命令行。

Q: 查行情需要 API Key 吗？

A: 不需要。只有跨账户（查余额、下单、划转）的操作才需要 Key。

Q: API Key 会暴露给 AI 吗？

A: 不会。Key 只从本地环境变量读取，不会出现在对话上下文里，也不上传任何服务器。

Q: 手配 API Key 和 Agentic 账户有什么区别？

A: 手配 API Key 是你在 Web 创建、自己管理的，共用主账户余额；Agentic 账户是通过 OAuth 连接、进入独立资金域，凭证在你完成授权后由 MCP/SDK 自动管理。

Q: Agentic 账户能提现吗？

A: 不能。提现和主账户相关操作必须始终在 Web 端手动完成。

Q: bitget-mcp-server 和 Signal 是一个东西吗？

A: 不是。它们是两个独立的 MCP 服务器。Signal 覆盖加密货币的宏观 / 情绪 / 技术面 / 新闻数据；bitget-mcp-server 覆盖美股上市公司及相关基本面 / 分析师数据。

Q: Cursor 里 Bitget 工具没加载全？

A: Cursor 有约 40 个工具的总数限制。可以关闭其他 MCP，或在启动参数里加 --modules market 只加载行情模块。

Q: AI 下单前会让我确认吗？

A: 会。Skill 会在执行写操作前显示 [CAUTION] 提示并等待你确认。提现等高风险操作还需要额外加 --confirm 标志。

Q: 收费吗？

A: AgentHub 本身 MIT 开源免费。交易产生的手续费按你的 Bitget 账户等级计算。

Q: 遇到问题去哪反馈？

A: GitHub Issues · 安全漏洞请发邮件至 [email protected]，不要在公开渠道发布。

相关链接