面嚮AI編碼助手用戶的快速上手指南

 

概述

本文檔是一套面嚮 AI 編碼助手的 BingX 交易所 API 技能集合，包含 15 个技能模塊，覆蓋永續合約、現貨交易、跟單交易和賬戶管理等業務。

安裝後，你可以直接用自然語言與AI對話來查詢行情、下單交易、管理賬戶，無需手動編寫任何API請求代碼。

支持的 AI 助手：Claude Code、Cursor 及其他支持 skills 機制的 AI 編碼助手。

 

安裝

  • 通用安裝（Claude Code / Cursor / 其他）
npx skills add BingX-API/api-ai-skills
  • Claude Code 專屬安裝（支持自動更新）
/plugin add BingX-API/api-ai-skills

詳細安裝説明參見 README.md

 

技能總覽

  • U本位永續合約（USDT-M Perpetual）
技能名稱 用途 需要鑒權
bingx-swap-market 行情數據：價格、深度、K綫、資金費率、持倉量等         否
bingx-swap-trade 交易操作：下單、撤單、設置杠桿、保證金模式等          是
bingx-swap-account 賬戶信息：餘額、持倉、手續費率、資金流水等          是
  • 現貨交易（Spot）
技能名稱 用途 需要鑒權
bingx-spot-market 行情數據：價格、深度、K綫、成交記錄等          否
bingx-spot-trade 交易操作：下單、撤單、訂單查詢、OCO 訂單等            是
bingx-spot-account 賬戶信息：餘額、資產總覽、資產劃轉等        是
bingx-spot-wallet 錢包操作：充值、提現、轉賬記錄等       是
  • 跟單交易（Copy Trading）
技能名稱 用途 需要鑒權
bingx-copytrade-spot 現貨跟單：賣出跟單持倉、查詢盈利等      是
bingx-copytrade-swap 合約跟單：平倉、設置止盈止損、佣金設置等              是
  • 賬戶管理（Account Management）
技能名稱 用途 需要鑒權
bingx-fund-account 資金賬戶：餘額查詢、資產總覽、賬戶閒劃轉等           是
bingx-sub-account 子賬戶管理：創建/凍結子賬戶、API Key 管理等           是
bingx-agent 代理/經紀商：邀請用戶、佣金查詢、合作夥伴作數據等            是
  • 标准合约（Standard Contract）
技能名稱 用途 需要鑒權
bingx-standard-trade 標準合約：持倉查詢、訂單歷史、餘額查詢等             是

 

鑒權説明

  • 無需鑒權的技能

以下行情類技能無需配置 API Key 即可使用：

  1. bingx-swap-market（永續合約行情）
  2. bingx-spot-market（現貨行情）
  • 需要鑒權的技能

其餘所有交易和賬戶類技能需要配置以下環境變量：

  1. BINGX_API_KEY — 你的 API Key
  2. BINGX_SECRET_KEY — 你的 Secret Key

API Key 在 BingX 用戶中心 → API 管理 創建。

  • 運行環境
環境 説明 基礎 URL
prod-live 生產實盤 https://open-api.bingx.com
prod-vst 模擬盤（無需真實資金）         https://open-api-vst.bingx.com

鑒權簽名的完整技術細節參見 skills/references/authentication.md

 

安全機制

  • 寫操作確認

在 prod-live（生產實盤）環境下，所有寫操作（下單、撤單、劃轉等）執行前需要用戶輸入 CONFIRM 確認。模擬盤環境無需確認。

  • 密鑰脫敏

AI 展示密鑰時會自動脫敏：

  1. API Key：顯示首 5 位 + 尾 4 位，例如 su1Qc...8akf
  2. Secret Key：全部掩碼，僅顯示尾 5 位，例如 ***...aws1

 

常見使用場景

安裝完成后，你可以直接用自然語言與 AI 對話。以下是一些常見示例：

  • 行情查詢
查詢 BTC-USDT 的當前價格
查看 ETH-USDT 最近 1 小時的 K 綫數據
BTC-USDT 當前的資金費率是多少？
  • 交易操作
幫我下一個 BTC-USDT 的市價買單，數量 0.01
下一個 ETH-USDT 的限價賣單，價格 4000，數量 0.1
撤銷所有 BTC-USDT 的挂單
  • 賬戶管理
查看我的合約賬戶餘額和持倉
查詢我的現貨賬戶餘額
將 100 USDT 從現貨賬戶劃轉到合約賬戶
  • 其他操作
查看我的子賬戶列表
查詢我的代理邀請用戶列表

 

多技能工作流

多个技能可以組合使用完成完整的交易流程：

  • 合約交易流程
swap-market（查看 BTC-USDT 行情和深度）
    ↓
swap-account（檢查賬戶餘額和可用保證金）
    ↓
swap-trade（下單交易）
  • 持倉管理流程
swap-account（查看當前持倉和盈虧）
    ↓
swap-market（查看最新價格）
    ↓
swap-trade（平倉或調整持倉）
    ↓
swap-account（確認平倉結果）
  • 現貨交易流程
spot-market（查詢現貨價格和深度）
    ↓
spot-account（檢查現貨賬戶餘額）
    ↓
spot-trade（下單買入或賣出）
  • 转跨賬戶資產劃轉
spot-account（查看現貨餘額）
    ↓
spot-account / fund-account（劃轉資產到合約賬戶）
    ↓
swap-trade（使用劃轉資金進行合約交易）

 

文件結構

每個技能模塊由兩個文件組成：

skills/<skill-name>/
├── SKILL.md           # Agent 行爲説明
└── api-reference.md   # 完整 API 文檔
  1. SKILL.md：定義技能用途、快速參考表、TypeScript 代碼示例、Agent 交互規則（鑒權、確認機制制等）
  2. api-reference.md：完整的 API 端點文檔，包括參數説明、響應字段、示例 JSON 和錯誤碼

通用參考文檔位於 skills/references/ 目錄：

  1. authentication.md — HMAC SHA256 簽名實現
  2. base-urls.md — 環境基礎 URL 配置