AIコーディングアシスタント活用のためのクイックスタートガイド。
概要
本ドキュメントは、AIコーディングアシスタント向け「BingX APIスキル」のコレクションです。無期限先物、現物取引、コピートレード、およびアカウント管理を網羅する15のスキルモジュールで構成されています。
インストール後は、市場データの照会、取引の実行、アカウント管理についてAIと自然言語で直接やり取りでき、手動でAPIリクエストのコードを書く必要はありません。
サポート対象の AI アシスタント：クラウドコード、、Cursorおよび スキル機能をサポートするその他のAIコーディングアシスタント。
インストール
- 一般的なインストール手順(Claude Code / Cursor / その他)
| npx skills add BingX-API/api-ai-skills |
- Claude Code 専用インストール(自動アップデート対応)
| /plugin add BingX-API/api-ai-skills |
インストールの詳細については、次を参照してください： README.md
スキル概要
- USDT-M無期限
| スキルネーム | 目的 | 要認証必要 |
| bingx-swap-market | 市場データ：価格、板情報(深度)、K線(ローソク足)、資金調達率、未決済注文(OI)など | 未完了 |
| bingx-swap-trade | 取引操作：注文の作成、注文のキャンセル、レバレッジ設定、アセットモードの設定など | 対応 |
| bingx-swap-account | アカウント情報：残高、現在のポジション、手数料率、資金履歴など | 対応 |
- 現物
| スキルネーム | 目的 | 要認証必要 |
| bingx-spot-market | 市場データ：価格、板情報(深度)、K線(ローソク足)、取引履歴など | 未完了 |
| bingx-spot-trade | 取引操作：注文の作成、注文のキャンセル、注文の照会、OCO注文など | 対応 |
| bingx-spot-account | アカウント情報：残高、資産の概要、資金振替など | 対応 |
| bingx-spot-wallet | ウォレット操作：入金、出金、振替履歴など | 対応 |
- コピー取引
| スキルネーム | 目的 | 要認証必要 |
| bingx-copytrade-spot | 現物コピー取引：コピーポジションの決済、収益の照会など | 対応 |
| bingx-copytrade-swap | 先物コピー取引：ポジションの決済、利確/損切りの設定、手数料の設定など | 対応 |
- アカウント管理
| スキルネーム | 目的 | 要認証必要 |
| bingx-fund-account | 資金口座：残高の照会、資産の概要、内部振替など | 対応 |
| bingx-sub-account | サブアカウント管理：サブアカウントの作成・凍結、APIキー管理など | 対応 |
| bingx-agent | パートナー/ブローカー：ユーザーの招待、報酬(コミッション)の照会、パートナーデータの確認など | 対応 |
- 標準先物
| スキルネーム | 目的 | 要認証必要 |
| bingx-standard-trade | 標準先物：ポジションの照会、注文履歴、残高など | 対応 |
認証に関する説明
- 認証不要の機能
以下の市場データに関する機能は、APIキーを設定せずに使用できます ：
- bingx-swap-market(無期限先物市場データ)
- bingx-spot-market(現物市場データ)
- 認証が必要な機能
その他すべての取引およびアカウント関連の機能には、次の環境変数の設定が必要です：
- BINGX_API_KEY — APIキー
- BINGX_SECRET_KEY — シークレットキー
APIキーは、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 は表示時にキーを自動的にマスキングします：
- APIキー：最初と最後の数文字のみ表示(例：su1Qc...8akf)
- シークレットキー：全体を非表示とし、末尾5文字のみ表示(例：...aws1)
主な活用シーン
インストールが完了すると、自然言語を使用してAIと直接対話できるようになります。よく使われる例をいくつか挙げます：
- 市場データの照会
| BTC-USDTの現在価格を照会 |
| ETH-USDTの過去1時間のK線(ローソク足)データを表示 |
| BTC-USDTの現在の資金調達率を教えてください |
- 取引実行プロセス
| BTC-USDTを数量0.01で成行買い注文 |
| ETHを価格4,000 USDT、数量0.1で指値売り注文 |
| BTC-USDTの未約定注文を全てキャンセル |
- アカウント管理
| 先物口座の残高と現在のポジションを表示 |
| 現物口座の残高を照会 |
| 現物口座から先物口座へ100 USDTを振替 |
- その他の操作
| サブアカウント一覧を表示 |
| パートナー紹介リストを照会 |
マルチスキルワークフロー
複数のスキルを組み合わせて、一連の取引プロセスを完結させることができます：
- 先物取引ワークフロー
| スワップ市場(BTC-USDTの市場データと板情報を確認) ↓ スワップ口座(口座残高と利用可能証拠金を確認) ↓ スワップ取引(注文を実行) |
- ポジション管理ワークフロー
| 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 usage description └── api-reference.md # Full API documentation |
- SKILL.md: スキルの目的、クイックリファレンス表、TypeScriptコードサンプル、エージェントの対話ルール(権限承認、確認メカニズムなど)の定義
- api-reference.md: APIエンドポイントの完全なドキュメント(パラメータ詳細、レスポンス項目、JSONサンプル、エラーコードなどを含む)
共通のリファレンスドキュメントは skills/references/ ディレクトリにあります。
- authentication.md — HMAC SHA256 署名の実装方法
- base-urls.md — 環境ごとのベースURL設定
