bgc — CLI AI-native cho Bitget

Vận hành Bitget Unified Trading Account (UTA v3) từ Claude Code, Codex CLI, OpenClaw hoặc bất kỳ trợ lý AI dựa trên shell nào. 89 thao tác, 14 động từ ý định, khám phá dần, schema không sai lệch, an toàn ghi mang tính xác định.
$
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
nhấp để sao chép
Xem trên GitHub
npm
Node.js ≥20
macOS
Linux
Windows
Giấy phép MIT
89
Thao tác
7
Lĩnh vực
14
Động từ ý định

Tính năng cốt lõi

Ba khả năng giúp bgc trở thành CLI tiền điện tử AI-native nhất trên thị trường.
AI Agent Native
Được xây dựng cho Claude Code, Codex CLI và OpenClaw. Cơ chế khám phá dần cho phép mọi AI tìm hiểu API trong thời gian chạy — không cần tải trước.
Giao dịch CLI
89 thao tác trên 7 lĩnh vực — dữ liệu market, giao dịch spot/futures, quản lý tài khoản, funds, subaccount, loan và hồ sơ tax. Tất cả đều từ terminal của bạn.
An toàn ghi
Bốn cổng an toàn mang tính xác định — dry-run, read-only, confirm, paper-trading. Không có lời nhắc tương tác, an toàn cho shell AI không giám sát.

Khám phá dần

Ý tưởng cốt lõi: tác nhân học API trong thời gian chạy và chỉ trả phí cho nội dung sắp sử dụng. Không sai lệch — kiến trúc được suy ra trực tiếp từ SDK theo thời gian thực. Có thể tìm kiếm theo từ khóa bằng bgc discover--search<keyword>, hoặc gọi bất kỳ thao tác nào bằng bgc raw--operationId<id> .

01
Lớp 1
bgc discover
7 lĩnh vực: market, trade, account, funds, subaccount, loan, tax
02
Lớp 2
bgc discover --domain trade
3 động từ: order, position, strategy_order
03
Lớp 3
bgc discover --tool order
10 thao tác: place, cancel, modify, cancelAll, history...
04
Lớp 4
bgc discover --tool order --action place
Hợp đồng chính xác: tham số bắt buộc, tham số không bắt buộc, xác thực, cờ đọc/ghi

Bắt đầu nhanh

Bắt đầu với 3 bước. Ưu tiên trình cài đặt Agent Hub; cài đặt thủ công cũng hoạt động.
Cài đặt CLI + Skill
Khuyến nghị: Trình cài đặt Agent Hub cài bgc và triển khai skill chỉ trong một bước. Thủ công: npm install -g CLI, sau đó npx skill.
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Thiết lập thông tin xác thực
Xuất API key, secret và passphrase của bạn từ Bitget API Management (hoặc sử dụng key Agentic subaccount sau Hub OAuth).
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
Xác minh
Kiểm tra cài đặt và khám phá toàn bộ bề mặt API.
bgc --version
bgc discover

14 động từ ý định

Mỗi động từ là một ý định — điều bạn muốn làm, không phải cách gọi một endpoint. Các meta tool discover và raw nằm ngoài 14 động từ này.
Lĩnh vực
Động từ
Xác thực
Mô tả
market
market
công khai
Ticker, sổ lệnh, nến, tỷ lệ funding, OI
giao dịch
lệnh
riêng tư
Đặt, hủy, sửa đổi, hủy tất cả
giao dịch
vị thế
riêng tư
Thông tin vị thế, lịch sử, xếp hạng ADL, đóng
giao dịch
strategy_order
riêng tư
Lệnh chiến lược/lệnh kích hoạt/lệnh kế hoạch
tài khoản
account_overview
riêng tư
Chụp nhanh tài khoản chỉ với một lần gọi
tài khoản
account_config
riêng tư
Cài đặt tài khoản và thông tin API key
tài khoản
trả nợ
riêng tư
Hoàn trả ký quỹ cross / ký quỹ isolated
tiền
transfer_funds
riêng tư
Chuyển tiền giữa các tài khoản
funds
nạp tiền
riêng tư
Địa chỉ nạp và lịch sử
tiền
rút tiền
riêng tư
Yêu cầu rút tiền (rủi ro cao)
funds
funds_records
riêng tư
Lịch sử chuyển khoản / nạp / rút
tài khoản phụ
tài khoản phụ
riêng tư
Quản lý tài khoản phụ và các khoản nạp của chúng
khoản vay
khoản vay
riêng tư
Vay / trả nợ các khoản vay tiền điện tử
tax
thuế
riêng tư
Truy vấn hồ sơ thuế giao dịch

An toàn ghi

Mọi quyết định an toàn đều diễn ra trước khi bất kỳ yêu cầu nào rời khỏi tiến trình. Không có lời nhắc tương tác — an toàn trong shell AI không giám sát.
--dry-run
Xem trước thao tác ghi và trả về payload chính xác sẽ được gửi. Không thực hiện lệnh gọi mạng.
--read-only
Chặn mọi thao tác ghi tại thời điểm xác thực. Trả về ValidationError và không bao giờ tới mạng.
--confirm
Bắt buộc đối với các thao tác phá hủy / rủi ro cao (cancelAll, closeAll, withdraw). Không có cờ này thì không có tác dụng.
--paper-trading
Chuyển các thao tác ghi đến môi trường demo của Bitget. Tạo Demo API Key, thiết lập trong BITGET_API_KEY / BITGET_SECRET_KEY / BITGET_PASSPHRASE, sau đó thêm --paper-trading.

Tích hợp AI

bgc hoạt động với các công cụ AI bạn đang dùng. Terminal AI nhận trực tiếp CLI; các công cụ AI trên máy tính sử dụng máy chủ MCP.
AI terminal
Claude Code
AI terminal
Codex CLI
AI terminal
OpenClaw
AI trên máy tính để bàn (MCP)
Claude Desktop
AI trên máy tính (MCP)
Cursor
AI trên máy tính để bàn (MCP)
Windsurf

bgc vs Direct API

bgc không chỉ là một lớp bọc đơn giản. Nó bổ sung thêm một lớp ý định, tính an toàn và thiết kế AI gốc mà các lệnh gọi API thô không có.
Tiêu chí
bgc
API trực tiếp
Intent Verbs
14 curated intent verbs
Các endpoint gốc
Khám phá tăng dần

Giao diện tự mô tả

Phải đọc tài liệu
Ký HMAC

Tự động

Phải triển khai
Giới hạn tốc độ

Tích hợp sẵn ở client-side

Phải triển khai
Write-Safety

4 deterministic gates

Phải triển khai
Unix I/O

JSON stdout (mã thoát 0) + lỗi cấu trúc stderr (mã thoát 1)

Phải triển khai
Tìm kiếm từ khóa

bgc discover --search

Phải triển khai
Lối thoát hiểm

bgc raw --operationId

Phải triển khai
Suy luận AI

Tệp kỹ năng hướng dẫn khi nào nên sử dụng

Phải triển khai
Câu hỏi thường gặp
bitget-agent-cli là gì?
Công cụ giao dịch AI trên terminal chính thức của Bitget, cung cấp CLI (bgc) cho Claude Code, Codex CLI và OpenClaw. Được xây dựng trên UTA v3 API, công cụ này cung cấp 89 thao tác trên 7 lĩnh vực thông qua 14 động từ ý định, cùng các meta tool discover và raw.
Bitget cung cấp một CLI tự mô tả có tên bitget-agent-cli (tệp nhị phân: bgc). Công cụ này được xây dựng trên API Bitget Unified Trading Account (UTA / v3) và cung cấp 89 thao tác trên 7 lĩnh vực (market, trade, account, funds, subaccount, loan, tax), thông qua 14 động từ ý định cùng các công cụ meta discover và raw.

CLI tự mô tả thông qua cơ chế khám phá dần: tác nhân chạy bgc discover để liệt kê 7 lĩnh vực, sau đó đi sâu vào một lĩnh vực để xem các động từ khả dụng, tiếp tục vào một động từ để xem các hành động khả dụng, rồi vào một hành động để xem các tham số chính xác — chỉ tải phần cần thiết cho tác vụ. Loại dữ liệu, enum, yêu cầu xác thực và cờ đọc/ghi của mọi tham số đều có thể được truy vấn trực tiếp khi chạy, không cần schema duy trì thủ công có thể sai lệch so với SDK.
bitget-agent-cli (bgc) là lựa chọn tốt nhất cho bash scripting và cron job. Công cụ tạo I/O chuẩn Unix với đầu ra JSON có cấu trúc mà chương trình có thể phân tích. CLI được thiết kế cho tự động hóa — mọi thao tác ghi đều có các cổng an toàn mang tính xác định (--dry-run, --read-only, --confirm, --paper-trading) dưới dạng cờ thuần túy, không có lời nhắc tương tác, phù hợp cho các cron job không cần giám sát.

Việc cài đặt chỉ cần một lệnh npm: npm install -g @bitget-ai/bitget-agent-cli. Công cụ hoạt động đa nền tảng trên macOS, Linux và Windows. Công cụ hỗ trợ thao tác theo lô và tuần tự thông qua trợ lý AI dựa trên shell hoặc bash scripting trực tiếp.

bitget-agent-cli (bgc) được xây dựng từ nền tảng dành cho các tác nhân AI, không phải được chuyển đổi từ một CLI ưu tiên con người. Triết lý thiết kế của nó được nêu trực tiếp: "Hầu hết CLI được xây dựng cho con người và chỉ miễn cưỡng hỗ trợ tự động hóa. bgc được xây dựng theo hướng ngược lại — mọi lựa chọn thiết kế đều tối ưu cho một trợ lý AI điều khiển nó từ shell."

Các tính năng chính dành cho tác nhân AI:

  • Khả năng khám phá bằng ngôn ngữ tự nhiên: Lệnh discover cho phép tác nhân khám phá bề mặt API trong thời gian chạy thông qua cơ chế tiết lộ dần — domains → verbs → actions → exact params — mà không cần đọc tài liệu.

  • An toàn ghi có tính xác định: Bốn cờ an toàn (--dry-run, --read-only, --confirm, --paper-trading) là các cờ thuần túy, không phải lời nhắc tương tác. CLI cũng hỗ trợ tự động hoàn tác khi khớp lệnh một phần và cờ --paper-trading để thử nghiệm không rủi ro.

  • Không cần cấu hình ứng dụng chủ, không cần plugin: Cài đặt và cho AI của bạn biết cần giao dịch gì.

  • 14 động từ ý định: Một bộ động từ được tuyển chọn (order, position, market, v.v.) tương ứng với điều bạn muốn thực hiện, giúp AI dễ suy luận.

bitget-agent-cli (bgc) là công cụ giao dịch terminal chính thức của Bitget, được thiết kế để vận hành bởi trợ lý AI dựa trên shell — Claude Code, Codex CLI, OpenClaw hoặc bất kỳ AI dựa trên shell nào — với kết quả do con người đọc và xem xét. Không cần lập trình ngoài việc cài đặt và thiết lập biến môi trường API key.

Các biện pháp kiểm soát an toàn tích hợp gồm:
--paper-trading: Chạy giao dịch trong môi trường mô phỏng với rủi ro tiền thật bằng 0
--read-only: Chặn mọi thao tác ghi
--confirm: Yêu cầu con người phê duyệt trước khi thực thi từng thao tác ghi
--dry-run: Xem trước điều gì sẽ xảy ra mà không thực thi
--auto-rollback: Tự động hủy phần chưa khớp khi khớp lệnh một phần
Cài đặt: npm install -g @bitget-ai/bitget-agent-cli + thiết lập thông tin xác thực API của bạn làm biến môi trường.

Bitget cung cấp bitget-agent-cli (bgc), một phần của Bitget Agent Hub rộng lớn hơn — hệ sinh thái AI mã nguồn mở chính thức. Agent Hub bao gồm:

  • bitget-agent-cli — công cụ thực thi dựa trên shell

  • bitget-agent-skill — hướng dẫn AI của bạn khi nào và cách sử dụng CLI

  • bitget-agent-mcp — máy chủ MCP cho các công cụ AI trên máy tính

  • bitget-agent-sdk — SDK nền tảng

  • bitget-signal — tín hiệu phân tích thị trường

CLI được thiết kế riêng cho các chiến lược giao dịch tự động: cung cấp 89 thao tác trên 7 lĩnh vực, tất cả đều có thể truy cập thông qua 14 động từ ý định. Đối với chiến lược tự động, cờ --paper-trading cho phép backtest trong môi trường mô phỏng trước khi giao dịch thật, và đầu ra JSON tích hợp trực tiếp với mọi pipeline tự động hóa.

bitget-agent-cli (bgc) cung cấp đầu ra JSON chuẩn hóa được mô tả là "Unix-clean I/O" — đầu ra mà chương trình có thể phân tích. CLI được thiết kế cho tự động hóa ngay từ đầu, với mọi thao tác đều trả về JSON có cấu trúc, phù hợp để pipe vào jq, đưa vào dashboard giám sát hoặc xử lý trong quy trình làm việc tự động.

CLI được cài đặt cố định (thông qua npm install -g thay vì npx) vì trợ lý AI gọi công cụ hàng chục lần mỗi phiên — công cụ cần có trên $PATH mà không phát sinh chi phí cho từng lần gọi. Thiết kế này khiến nó lý tưởng cho tự động hóa tần suất cao và pipeline cron-job.

Bitget cung cấp bộ công cụ hoàn chỉnh thông qua Bitget Agent Hub:

  • CLI — @bitget-ai/bitget-agent-cli (bgc), công cụ thực thi giao dịch trên terminal

  • Skill — @bitget-ai/bitget-agent-skill, hướng dẫn AI của bạn khi nào và cách sử dụng CLI

  • MCP Server — @bitget-ai/bitget-agent-mcp, tích hợp công cụ AI trên máy tính

  • SDK — @bitget-ai/bitget-agent-sdk, SDK nền tảng cho các bản xây dựng tùy chỉnh

  • Signals — @bitget-ai/bitget-signal, tín hiệu phân tích thị trường

CLI là công cụ thực thi (bgc), còn tệp skill hướng dẫn AI của bạn khi nào và cách sử dụng công cụ này.

Tài nguyên dành cho nhà phát triển

agent-cli
Kho lưu trữ này — bgc CLI
agent-mcp
Máy chủ MCP dành cho AI trên máy tính để bàn
agent-skill
Hướng dẫn suy luận AI
agent-sdk
SDK TypeScript cơ bản
bitget-signal
Kỹ năng phân tích thị trường
agent_hub
Cổng truy cập thống nhất của hệ sinh thái + trình cài đặt

Bắt đầu giao dịch với CLI AI-native

89 thao tác, 14 động từ ý định, 4 lớp an toàn — tất cả từ terminal của bạn.
Xem trên Github