mcpField
B
bitget

bitget

github.com/bitget-ai其他23362 次安装17 周前更新
代码仓库

关于 bitget

bitget 是面向 Bitget 交易操作的技能，通过 bgc CLI 查询行情、管理账户并执行交易；覆盖现货、合约及多种账户服务，并强调写入操作确认与交易安全。

主要功能

  1. 01通过 bgc CLI 调用 Bitget
  2. 02查询现货与合约市场数据
  3. 03管理账户、保证金及资金划转
  4. 04执行交易、跟单与理财操作
  5. 05提供演示交易及操作安全指引

适用场景

  1. 01查询行情、订单与持仓
  2. 02在确认后下单或调整杠杆
  3. 03查看余额并处理资金划转
  4. 04使用模拟模式练习交易

MCP 相关

README 提及 MCP 工具可用于操作，演示交易需在 MCP 服务启动时启用 --paper-trading。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bitget-ai/agent_hub --skill bitget

安装后在 Claude Code 中输入/bitget确认已加载。

详细介绍

Bitget Skill

你可以通过 bgc CLI 工具访问 Bitget 交易所的全部功能，包括现货、期货、账户、保证金、跟单交易、闪兑、赚币、P2P 和经纪商操作。

步骤 1：检查前置条件

bgc --version

如果未找到 → 告知用户：npm install -g bitget-client

对于私有端点（账户信息、交易、转账）：必须设置凭据。 参见 ~/.claude/skills/bitget-skill/references/auth-setup.md。

步骤 2：运行命令

bgc <module> <tool_name> [--param value ...]

所有输出均为 JSON。响应始终包含：

  • data — 实际结果
  • endpoint — 调用的 API
  • requestTime — 请求时间戳

如需查看工具和参数的完整列表，请阅读： ~/.claude/skills/bitget-skill/references/commands.md

其中包含目录，可直接跳转到相关模块部分。

对于交易接口，包含完整参数说明、用例和示例的详细参考文档位于： ~/.claude/skills/bitget-skill/references/trading/

文件内容
trading/spot-place-order.md现货限价单／市价单／批量订单、止盈／止损预设
trading/spot-cancel-orders.md撤销单笔、批量或所有现货订单
trading/spot-modify-order.md修改（撤销并替换）现货订单
trading/spot-get-orders.md查询未成交／历史现货订单
trading/spot-plan-orders.md现货触发／计划委托（止损、突破）
trading/futures-place-order.md期货订单、单向／双向持仓模式、止盈／止损
trading/futures-modify-order.md修改待成交期货订单：调整止盈／止损、价格、数量
trading/futures-cancel-orders.md撤销期货订单
trading/futures-get-orders.md查询期货订单和成交记录
trading/futures-positions.md当前／历史持仓、盈亏、强平价格
trading/futures-leverage-config.md设置杠杆、保证金模式、持仓模式

构建交易命令前，务必先阅读相关交易参考文档。

期货：平仓与止盈／止损速查规则

下任何期货平仓或止盈／止损订单前，先检查持仓：

bgc futures futures_get_positions --productType USDT-FUTURES --symbol BTCUSDT

注意：holdSide（多／空）和 posMode（one_way_mode／hedge_mode）。

平仓方向规则（最常见的错误）
持仓平仓用的 side额外参数
多头（单向持仓模式）sellreduceOnly: "YES"
空头（单向持仓模式）buyreduceOnly: "YES"
多头（双向持仓模式）selltradeSide: "close"
空头（双向持仓模式）buytradeSide: "close"

卖出平空是错误的——这会增加空头持仓。

止盈／止损选项
  1. 开仓时预设：在开仓订单中设置 presetStopSurplusPrice / presetStopLossPrice
  2. 开仓后添加／修改：使用 futures_modify_order，并设置 newPresetStopSurplusPrice / newPresetStopLossPrice——不会取消订单；传入 "0" 可删除预设
  3. 手动限价单 + reduceOnly：在目标价格下单独下达限价平仓单（作为备用方案）

使用 futures_modify_order 前，请阅读 trading/futures-modify-order.md。

模块速查

模块用途
spot现货价格、订单簿、K 线、现货订单
futures永续合约价格、持仓、期货订单、杠杆
account余额、充值、提现、转账、子账户
margin保证金资产、借款／还款、保证金订单
copytrading跟随交易员、复制持仓。**注意：**复制持仓与常规期货持仓相互独立——请使用 copy_get_positions 和 copy_close_position 管理，不要使用 futures_place_order
convert将一种币兑换为另一种币。**必须分两步操作：**先调用 convert_get_quote（返回报价 ID 和汇率，有效期约 10 秒），然后调用 convert_execute。执行前务必向用户展示报价汇率
earn储蓄／质押产品、申购／赎回
p2pP2P 商家和订单
broker经纪商子账户和 API 密钥

写入操作：务必先确认

运行任何标记为 写入操作：是 的命令前，请先总结该命令将执行的操作，并征求用户确认。 这包括：下单、撤单、转账、提现、设置杠杆、借款、赎回理财产品。

确认示例：

“这将在 BTCUSDT 上以 70,000 美元的价格下达一笔 0.01 BTC 的限价买单。确认吗？”

绝不允许未经确认就执行写入操作。

提现安全： 确认提示中务必显示链名称和目标地址。选错链无法撤销；如果用户尚未指定链，请列出可用链并在继续操作前征求确认。

市价买入数量： 对于现货市价买入，size 的单位是计价币（USDT），而不是基础币。构建市价买单前，请确认用户的意图，以避免静默执行几乎为零的订单。

错误处理

如果 bgc 返回 "ok": false，请读取 error.suggestion 中的恢复操作。 常见解决方法：~/.claude/skills/bitget-skill/references/error-codes.md

如果缺少凭据（AUTH_MISSING），请准确告知用户需要设置哪些环境变量。

输出展示

  • 对于价格/行情代码：以清晰易读的摘要显示交易对、最新价格、24 小时涨跌幅和成交量
  • 对于订单列表：使用表格格式，列出 orderId、交易对、方向、价格、数量和状态
  • 对于余额：列出币种及可用和冻结金额；跳过小额余额（< 0.0001）
  • 对于期货持仓：务必显示交易对、方向（多/空）、数量、开仓价格、标记价格、未实现盈亏、强平价格和杠杆。绝不能省略强平价格
  • 对于资金费率：显示当前费率、年化费率和下次结算时间
  • 对于用户未要求查看的原始数据：只做摘要，不要倾倒完整 JSON

使用示例

# Public market data (no credentials needed)
bgc spot spot_get_ticker --symbol BTCUSDT
bgc futures futures_get_ticker --productType USDT-FUTURES --symbol BTCUSDT
bgc futures futures_get_funding_rate --productType USDT-FUTURES --symbol BTCUSDT

# Account queries (requires credentials)
bgc account get_account_assets
bgc spot spot_get_orders --status open
bgc futures futures_get_positions --productType USDT-FUTURES

# Write operations (confirm before running)
bgc spot spot_place_order --orders '[{"symbol":"BTCUSDT","side":"buy","orderType":"limit","price":"70000","size":"0.01"}]'
bgc futures futures_set_leverage --productType USDT-FUTURES --symbol BTCUSDT --marginCoin USDT --leverage 10
bgc account transfer --fromAccountType spot --toAccountType futures_usdt --coin USDT --amount 100

模拟交易模式

当用户想练习交易、测试策略，或明确提到“demo”“paper trading”或“simulated trading”时，请使用模拟模式。

设置： 用户需要 Bitget Demo API Key。完整设置步骤请参阅 ~/.claude/skills/bitget-skill/references/demo-trading.md。

对于 bgc CLI： 在 bgc 后添加 --paper-trading，并将其作为第一个标志：

bgc --paper-trading spot spot_get_ticker --symbol BTCUSDT
bgc --paper-trading futures futures_get_positions --productType USDT-FUTURES
bgc --paper-trading account get_account_assets

对于 MCP 工具： MCP 服务必须使用 --paper-trading 启动。如果用户要求通过 MCP 使用模拟模式，但服务启动时未使用该标志，请告知用户需要使用 --paper-trading 重启服务。

关键规则： 在模拟模式下，本次会话中的每条 bgc 命令都必须添加 --paper-trading。绝不要在同一会话中混用模拟交易命令和实盘命令。

评论

支持 Markdown