Hướng dẫn bắt đầu nhanh cho người dùng AI coding assistant.
Tổng quan
Tài liệu này tổng hợp các Skill API BingX dành cho AI coding assistant, bao gồm 15 mô-đun skill, hỗ trợ các mảng giao dịch Hợp đồng Vĩnh viễn, Spot, Sao chép và quản lý tài khoản.
Sau khi cài đặt, bạn có thể tương tác trực tiếp bằng ngôn ngữ tự nhiên với AI để truy vấn dữ liệu thị trường, đặt lệnh và quản lý tài khoản mà không cần phải tự tay viết code yêu cầu API.
AI Assistant được hỗ trợ: Claude Code, Cursor và các AI coding assistant khác hỗ trợ cơ chế Skill.
Cài đặt
- Cài đặt chung (Claude Code / Cursor / Khác)
| npx skills add BingX-API/api-ai-skills |
- Cài đặt riêng cho Claude Code (hỗ trợ tự động cập nhật)
| /plugin add BingX-API/api-ai-skills |
Xem hướng dẫn cài đặt chi tiết tại README.md
Tổng quan về Skill
- Vĩnh viễn USDT-M
| Tên Skill | Mục đích | Yêu cầu cấp quyền |
| bingx-swap-market | Dữ liệu thị trường: Giá, độ sâu, biểu đồ nến, tỷ lệ tài trợ, khối lượng mở, v.v. | Không bắt buộc |
| bingx-swap-trade | Thao tác giao dịch: Đặt lệnh, hủy lệnh, thiết lập đòn bẩy, chế độ tài sản, v.v. | Có |
| bingx-swap-account | Thông tin tài khoản: Số dư, vị thế hiện tại, lệ phí, dòng vốn, v.v. | Có |
- Spot
| Tên Skill | Mục đích | Yêu cầu cấp quyền |
| bingx-spot-market | Dữ liệu thị trường: Giá, độ sâu, biểu đồ nến, lịch sử giao dịch, v.v. | Không bắt buộc |
| bingx-spot-trade | Thao tác giao dịch: Đặt lệnh, hủy lệnh, truy vấn lệnh, lệnh OCO, v.v. | Có |
| bingx-spot-account | Thông tin tài khoản: Số dư, tổng quan tài sản, chuyển tài sản, v.v. | Có |
| bingx-spot-wallet | Thao tác ví: Nạp, rút, lịch sử chuyển khoản, v.v. | Có |
- Giao dịch Sao chép
| Tên Skill | Mục đích | Yêu cầu cấp quyền |
| bingx-copytrade-spot | Giao dịch Sao chép Spot: Đóng vị thế sao chép, truy vấn lợi nhuận, v.v. | Có |
| bingx-copytrade-swap | Giao dịch Sao chép Hợp đồng: Đóng vị thế, cài đặt C.Lãi/D.Lỗ, thiết lập phí hoa hồng, v.v. | Có |
- Quản lý tài khoản
| Tên Skill | Mục đích | Yêu cầu cấp quyền |
| bingx-fund-account | Tài khoản Quỹ: Truy vấn số dư, tổng quan tài sản, chuyển khoản nội bộ, v.v. | Có |
| bingx-sub-account | Quản lý tài khoản phụ: Tạo/phong tỏa tài khoản phụ, quản lý API key, v.v. | Có |
| bingx-agent | Đối tác/Broker: Mời người dùng, truy vấn phí hoa hồng và kiểm tra dữ liệu đối tác, v.v. | Có |
- Hợp đồng Tiêu chuẩn
| Tên Skill | Mục đích | Yêu cầu cấp quyền |
| bingx-standard-trade | Hợp đồng Tiêu chuẩn: Truy vấn vị thế, lịch sử đặt lệnh, số dư, v.v. | Có |
Giải thích về việc cấp quyền
- Skill không yêu cầu cấp quyền
Các skill dữ liệu thị trường dưới đây có thể sử dụng trực tiếp mà không cần thiết lập API Key :
- bingx-swap-market (dữ liệu thị trường Hợp đồng Vĩnh viễn)
- bingx-spot-market (dữ liệu thị trường Spot)
- Skill cần cấp quyền
Tất cả các skill khác liên quan đến giao dịch và tài khoản đều yêu cầu thiết lập các biến môi trường sau:
- BINGX_API_KEY — API key của bạn
- BINGX_SECRET_KEY — Secret key của bạn
API Key được tạo trong phần Trung tâm người dùng BingX → Quản lý API .
- Môi trường vận hành
| Môi trường | Mô tả | URL gốc |
| prod-live | Môi trường thật | https://open-api.bingx.com |
| prod-vst | Môi trường demo (không mất phí) | https://open-api-vst.bingx.com |
Chi tiết kỹ thuật về chữ ký xác thực, vui lòng xem skills/references/authentication.md
Cơ chế bảo mật
- Xác nhận thao tác ghi
Trong môi trường prod-live (thực tế), tất cả các thao tác ghi (đặt lệnh, hủy lệnh, chuyển khoản, v.v.) đều yêu cầu người dùng nhập CONFIRM (xác nhận) trước khi thực thi. Môi trường demo không cần xác nhận.
- Ẩn key
AI sẽ tự động che key khi hiển thị:
- API Key: Chỉ hiển thị 5 ký tự đầu và 4 ký tự cuối, ví dụ: su1Qc...8akf
- Secret key: Che hoàn toàn, chỉ hiển thị 5 ký tự cuối, ví dụ: ***...aws1
Các tình huống sử dụng thường gặp
Sau khi cài đặt xong, bạn có thể tương tác trực tiếp với AI bằng ngôn ngữ tự nhiên. Dưới đây là một số ví dụ điển hình:
- Truy vấn dữ liệu thị trường
| Truy vấn giá hiện tại của BTC-USDT |
| Xem dữ liệu nến của ETH-USDT trong 1 giờ qua |
| Tỷ lệ tài trợ hiện tại của BTC-USDT là bao nhiêu? |
- Thao tác giao dịch
| Đặt lệnh mua market cho BTC-USDT với khối lượng 0.01 |
| Đặt lệnh bán limit cho ETH ở mức giá 4,000 USDT với khối lượng 0.1 |
| Hủy toàn bộ lệnh mở cho BTC-USDT |
- Quản lý tài khoản
| Xem số dư tài khoản hợp đồng và các vị thế hiện tại |
| Truy vấn số dư tài khoản Spot |
| Chuyển 100 USDT từ tài khoản Spot sang tài khoản Hợp đồng |
- Các thao tác khác
| Xem danh sách tài khoản phụ |
| Truy vấn danh sách giới thiệu đối tác |
Quy trình làm việc đa skill
Bạn có thể kết hợp nhiều skill để thực hiện trọn vẹn quy trình giao dịch:
- Quy trình giao dịch Hợp đồng
| swap-market (xem dữ liệu thị trường và độ sâu của BTC-USDT) ↓ swap-account (kiểm tra số dư tài khoản và ký quỹ khả dụng) ↓ swap-trade (đặt lệnh) |
- Quy trình quản lý vị thế
| swap-account (xem các vị thế hiện tại và Lãi Lỗ) ↓ swap-market (xem giá cuối) ↓ swap-trade (đóng hoặc điều chỉnh vị thế) ↓ swap-account (xác nhận kết quả đóng) |
- Quy trình giao dịch Spot
| spot-market (truy vấn giá Spot và độ sâu) ↓ spot-account (kiểm tra số dư tài khoản Spot) ↓ spot-trade (đặt lệnh mua hoặc bán) |
- Chuyển tài sản giữa các tài khoản
| spot-account (xem số dư Spot) ↓ spot-account / fund-account (chuyển tài sản sang tài khoản Hợp đồng) ↓ swap-trade (giao dịch Hợp đồng bằng số vốn đã chuyển) |
Cấu trúc tệp
Mỗi mô-đun skill gồm có 2 tệp:
| skills/<skill-name>/ ├── SKILL.md # Mô tả cách sử dụng dành cho Agent └── api-reference.md # Tài liệu API đầy đủ |
- SKILL.md: Định nghĩa mục tiêu của skill, bảng tra cứu nhanh, code sample TypeScript, các rule tương tác cho agent (cơ chế xác thực, xác nhận, v.v.)
- api-reference.md: Tài liệu API endpoint đầy đủ, bao gồm chi tiết tham số, các field phản hồi, mẫu JSON và các mã lỗi
Tài liệu tham khảo chung có thể được tìm thấy tại thư mục skills/references/ :
- authentication.md — Cách triển khai chữ ký HMAC SHA256
- base-urls.md — Cấu hình URL gốc cho môi trường
