bgc ——Bitget的代理本地CLI

@bitget-ai/bitget-agent-cli

这个 外壳表面 会 议 日 程 和 议 程 位元代理 Hub - 一个 代理第一个 bitget 的命令行 统一交易账户(UTA/v3) API (英语).

大多数CLI都是为人类而建的,只是容忍自动化. bgc 以相反的方式构建: AI助手从外壳里驾驶它 (Claude Code, Codex CLI, OpenClaw),由人阅读结果. 一小组 意图动词页:1 自定义表面 代理在运行时探索,以及 确定性书写安全 这样就能安全地把钥匙交给一个自主的特工.

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

二进制是 bgc。 。 。 .

为什么 npm install -g 没有 npx? 吗? bgc -你的人工智能助理每场都叫几十次 所以你们想开机 $PATH 零拨头费。 其它Bitget AI软件包(@bitget-ai/bitget-agent-skill, (中文(简体) ), @bitget-ai/bitget-signal, (中文(简体) ), @bitget-ai/bitget-agent-mcp, (中文(简体) ), @bitget-ai/bitget-agent-installer)是一发或子进程发射的,因此它们使用 npx。 。 。 .

先决条件: 节点.js 20. 密钥和密码句( B)创建一个——只针对私人(账户/交易)电话;市场数据公开.

为什么是经纪人?

其余的读取器则在每一个上扩展. 初一为心.

逐步披露——核心思想

AI代理有一个有限的上下文窗口. 预装每个Bitget操作 及其参数 浪费预算 并停止 瞬间API 改变. bgc 相反,暴露一个 自定义表面 特工自上而下地走着,只支付它将要使用的东西:

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, cancelAll, open, detail, history, …
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 … */
  ]
}

有了这个,特工就直接把电话召集起来 同一只骆驼 大小写字段名称, 没有翻译层 :

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

有两个属性使这特别适用于特工:

• 自为道行. 每个 discover 答复中包含 hint 字段,用于命名下一个 rung,所以一个代理 零 以前的知识可以从 bgc discover 一个人.
• 零取来. 被披露的"计划"是从SDK的活出——这个回放中没有静态的目录可以脱离同步. 什麽 discover 说,通过建筑, 正是CLI的工作.

而当特工只有模糊的想法时,它可以搜索整个地表:

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

快开始

export BITGET_API_KEY=...
export BITGET_SECRET_KEY=...
export BITGET_PASSPHRASE=...

# Public market data — no auth needed
bgc market --action tickers --category SPOT --symbol BTCUSDT

# Authenticated read — one-call account snapshot
bgc account_overview --coin USDT

# Preview a write without sending it (nothing leaves the process)
bgc order --action place --category SPOT --symbol BTCUSDT \
    --side buy --orderType market --qty 0.001 --dry-run

# Authenticated write — [CAUTION] real order
bgc order --action place --category SPOT --symbol BTCUSDT \
    --side buy --orderType market --qty 0.001

# Destructive write — high-risk, refuses to run without --confirm
bgc order --action cancelAll --category SPOT --symbol BTCUSDT --confirm

# Pretty-print JSON for human eyes
bgc --pretty position --action info --category USDT-FUTURES

语法

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 的精确度 骆驼 Case 字段名称 : --symbol BTCUSDT --side buy --orderType market --qty 0.001价值观自然受到胁迫—— true编号 :false ~布尔,一个从 [编号 :{ • 解析JSON(例如:. --orders '[{...}]'),其他一切都保留了字符串(SDK会强制数字,所以数字ID永远不会被错误地打出.

你脑子里从不需要命令参考 bgc discover 实值 参考文献,它不能停止.

raw - 逃生舱门

14个动词为共同操作前作. 当你需要的时候,他们不会... 或者你已经知道确切的.. operationId - 直接打电话:

bgc raw --operationId getTickers --args '{"category":"SPOT","symbol":"BTCUSDT"}'

降入1:1平面(100+生成操作) --full 当你想要将每个操作作为自己的工具曝光时.

书写安全

bgc 继承 SDK 的分层写安全门 。 每个安全决定都会发生 在此之前 任何请求都会离开进程,每个控制都是一面决定性的旗帜——没有交互的即时——所以在无人注意和AI驱动的弹壳中它是安全的.

# 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 }打印到 静态; 退出代码 0。 。 。 . dryRun 预览和 confirmationRequired 闸口为正常结果(出站、出站) 0这些都不是错误.
• 失败 • 结构化出错的有效载荷({ ok: false, error: { type, category, message, suggestion, retryable }, timestamp }打印到 标准; 退出代码 1。 。 。 .

成功输出为压缩 JSON( 添加) --pretty 2- 空间缩进); 出错的有效载荷总是相当的打印. 拆分为 unix- clean: 管道 stdout to jq,退出代码上的分支,读作 error.retryable 决定是否退后再试.

配置

全球旗帜

--action <name>    Action for an action-routed verb (forwarded as the tool's action)
--modules <list>   Modules to enable (default: all to-C modules); name a hidden one, e.g. --modules broker
--surface <mode>   intent (default) | full (also expose the 1:1 generated operations)
--full             Shorthand for --surface full
--read-only        Block all writes (mutually exclusive with --paper-trading)
--paper-trading    Route writes to the Bitget demo environment (needs demo credentials)
--dry-run          Preview a write without sending it (maps to dryRun)
--confirm          Required to execute destructive (high-risk) writes
--base-url <url>   Override API base URL (else BITGET_API_BASE_URL)
--timeout <ms>     Per-request timeout in ms (else BITGET_TIMEOUT_MS, default 15000)
--pretty           Pretty-print JSON output
--help             Show this help (verb list derived live from the SDK)
--version          Show 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)

证书只从环境中读取——从不登录,从不写入磁盘.

直视动词

默认( E)intent表面暴露 14个意图动词 纵横 7个域 - 13项是按行动路线进行的(选择行动方式是: --action),加上单发 account_overview - 与 discover 编号 : raw 元工具 :

每个行动路线动词的前沿 几个基本的操作通过 --action。隐藏的经纪人/机构贷款模块是选入(--modules broker, (中文(简体) ), --modules inst_loan) (中文(简体) ). 电力用户可以掉到 --full 表面以直接调用生成的 100+ 的 1: 1 操作 .

这里没有手持的目录可以漂移 浏览它所有的生活 bgc discover。 。 。 .

怎么样 bgc 已构建

bgc 是个瘦子, 零业务逻辑 外壳包装器 位元代理 SDK所有路线、验证、写作安全、正常化——以及发现本身——都生活在SDK中。 CLI 只解析 argv, 构建配置的表面, 转发调用, 并打印结果 :

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

由于发现和安全逻辑活在了SDK中,CLI接取了免费的新操作,参数和出入口——一个光谱变化体现在: bgc discover 这里没有代码更改。 每个命令会翻译为单个签名的HTTPS请求. 没有遥测,没有代理,没有远程依赖.

何处 bgc 符合

bgc 存在所以 AI 助手 已经活在你的外壳里 ——克洛德代码(Claude Code),Codex CLI,OpenClaw——在没有额外集成接线的情况下可以驱动Bitget. LLM写道: bgc … 命令,炮弹运行它, JSON 回来.

• 说MCP? (Claude桌面、光标、继续、ChatGPT桌面、Windsurf) @bitget-ai/bitget-agent-mcp 相同意图表面,MCP-形状.

• 让你的助手知道 何时 要达到 bgc 没有教它每个命令? 安装 Bitget 代理技能 顶部 :

  npx @bitget-ai/bitget-agent-skill
  

  那就说 "在Bitget市场购买0.1 BTC" 或者说 "展示我开放的未来位置" 和它组成 右 bgc 引证.

警卫

• 证书只从环境变量读取——从不登录,从不写入磁盘.
• 所有经认证的请求均与 HMAC-SHA256 (韩语) 正在处理中.
• 客户端利率限制可以防止意外的AI回路打入Bitget的API限制.
• 写作由 --dry-run 编号 : --read-only 编号 : --confirm; 破坏性(高风险)行动在没有明确情况下拒绝运行 --confirm。 。 。 .
• --read-only 财务报告和审定财务报表 --paper-trading 是分层安全网,用于将CLI交给AI代理.

许可证

麻省理工学院

_{部分 位元代理 Hub · 贸易堆积.
基金会: 代理服务器 其他地表: 代理服务器- mcp • 妇女 代理技能 市场信号: 位元符号}