Panduan Singkat untuk Pengguna dengan Asisten Pemrograman AI.
Ikhtisar
Dokumen ini merupakan kumpulan Skills API BingX untuk Asisten Pemrograman AI, yang mencakup 15 modul skill, meliputi Perpetual Futures, spot trading, Standard Futures Koin-M, copy trading, dan pengelolaan akun.
Setelah diinstal, Anda dapat langsung berinteraksi dengan AI menggunakan bahasa alami (natural language) untuk mengakses data pasar, melakukan transaksi, dan mengelola akun, tanpa perlu menulis kode permintaan API secara manual.
Asisten AI yang Didukung: Claude Code,Cursor dan asisten pemrograman AI lainnya yang mendukung mekanisme Skills.
Penginstalan
- Penginstalan Umum (Claude Code/Cursor/Lainnya)
| npx skills add BingX-API/api-ai-skills |
- Penginstalan Khusus Claude Code (mendukung pembaruan otomatis)
| /plugin add BingX-API/api-ai-skills |
Untuk petunjuk penginstalan yang detail, lihat README.md
Ikhtisar Skills
- Perpetual USDT-M
| Nama Skill | Tujuan | Diperlukan Otorisasi |
| bingx-swap-market | Data pasar: Harga, Kedalaman pasar, Grafik K-line, tingkat pendanaan, jumlah posisi terbuka, dll. | Tidak lengkap |
| bingx-swap-trade | Operasi trading: Memasang pesanan, membatalkan pesanan, mengatur leverage, mode aset, dll. | Ya |
| bingx-swap-account | Informasi akun: Saldo, posisi saat ini, tingkat biaya, aliran dana, dll. | Ya |
- Spot
| Nama Skill | Tujuan | Diperlukan Otorisasi |
| bingx-spot-market | Data pasar: Harga, Kedalaman, Grafik K-line,Riwayat trade, dll. | Tidak lengkap |
| bingx-spot-trade | Operasi trading: Memasang pesanan, membatalkan pesanan, memeriksa pesanan,pesanan OCO, dll. | Ya |
| bingx-spot-account | Informasi akun: Saldo, ringkasan aset, transfer aset, dll. | Ya |
| bingx-spot-wallet | Operasi dompet: Deposit, penarikan, riwayat transfer, dll. | Ya |
- Perpetual Koin-M
| Nama Skill | Tujuan | Diperlukan Otorisasi |
| bingx-coinm-market | Data pasar: Harga, Kedalaman pasar, Grafik K-line, tingkat pendanaan, dll. | Tidak lengkap |
| bingx-coinm-trade | Operasi trading: Memasang pesanan, membatalkan pesanan, leverage, mode aset, dll. | Ya |
- Copy Trading
| Nama Skill | Tujuan | Diperlukan Otorisasi |
| bingx-copytrade-spot | Copy Trading Spot: Menutup posisi copy, memeriksa profit, dll. | Ya |
| bingx-copytrade-swap | Copy Trading Futures: Menutup posisi, menetapkan TP/SL, menetapkan komisi, dll. | Ya |
- Manajemen Akun
| Nama Skill | Tujuan | Diperlukan Otorisasi |
| bingx-fund-account | Akun Dana: Cek saldo, ringkasan aset, transfer internal, dll. | Ya |
| bingx-sub-account | Manajemen Sub-Akun: Membuat/membekukan sub-akun,Mengelola Kunci API, dll. | Ya |
| bingx-agent | Mitra/Broker: Mengundang pengguna, mengecek komisi, memeriksa data mitra, dll. | Ya |
- Standard Futures
| Nama Skill | Tujuan | Diperlukan Otorisasi |
| bingx-standard-trade | Standard Futures: Memeriksa posisi, riwayat pesanan, saldo, dll. | Ya |
Penjelasan Otorisasi
- Skills yang tidak memerlukan otorisasi
Skills data pasar berikut ini dapat digunakan tanpa mengatur Kunci API :
- bingx-swap-market (Data Pasar Perp Futures)
- bingx-spot-market (Data pasar spot)
- bingx-coinm-market (Data Pasar Standard Futures Koin-M)
- Skills yang memerlukan otorisasi
Semua skills trading dan terkait akun lainnya memerlukan konfigurasi variabel lingkungan berikut:
- BINGX_API_KEY — Kunci API Anda
- BINGX_SECRET_KEY — Kunci Rahasia Anda
API Key dibuat di Pusat Pengguna BingX → Pengelolaan API .
- Lingkungan Operasional
| Lingkungan | Deskripsi | URL Dasar |
| prod-live | Produksi (langsung) | https://open-api.bingx.com |
| prod-vst | Demo (tidak memerlukan dana sungguhan) | https://open-api-vst.bingx.com |
Untuk detail teknis lengkap tentang tanda tangan autentikasi, lihat skills/references/authentication.md
Mekanisme Keamanan
- Konfirmasi operasi penulisan
Di lingkungan prod-live (produksi), semua operasi penulisan (pemesanan, pembatalan pesanan, transfer, dll.) memerlukan masukan pengguna berupa CONFIRM sebelum dieksekusi. Tidak diperlukan konfirmasi di lingkungan demo.
- Key Masking
AI akan secara otomatis melakukan masking pada kunci saat menampilkannya:
- Kunci API: Menampilkan 5 karakter pertama dan 4 karakter terakhir, misalnya: su1Qc...8akf
- Kunci Rahasia: Seluruhnya disembunyikan, hanya menampilkan 5 karakter terakhir, misalnya: ***...aws1
Skenario Penggunaan Umum
Setelah penginstalan selesai, Anda dapat berinteraksi langsung dengan AI menggunakan bahasa alami (natural language). Berikut adalah beberapa contoh umum:
- Memeriksa Data Pasar
| Memeriksa harga BTC-USDT saat ini |
| Lihat data K-line untuk ETH-USDT dalam satu jam terakhir |
| Bagaimana tingkat pendanaan saat ini untuk BTC-USDT? |
- Operasi Trading
| Memasang pesanan beli pasar untuk BTC-USDT dengan jumlah 0,01 |
| Memasang limit order jual untuk ETH dengan harga 4.000 USDT dan jumlah 0,1. |
| Membatalkan semua pesanan terbuka untuk BTC-USDT |
- Manajemen Akun
| Melihat saldo akun futures saya dan posisi saat ini |
| Memeriksa saldo akun spot saya |
| Mentransfer 100 USDT dari akun spot saya ke akun futures saya |
- Operasi Lainnya
| Lihat daftar sub-akun saya |
| Memeriksa daftar undangan mitra saya |
Alur Kerja Multi-Skill
Berbagai skill dapat digabungkan untuk menyelesaikan proses trading secara keseluruhan:
- Alur Kerja Futures Trading
| swap-market (melihat data pasar dan kedalaman pasar BTC-USDT) ↓ swap-account (memeriksa saldo akun dan margin yang tersedia) ↓ swap-trade (memasang pesanan) |
- Alur Kerja Manajemen Posisi
| swap-account (melihat posisi saat ini dan PnL) ↓ swap-market (melihat harga terakhir) ↓ swap-trade (menutup atau menyesuaikan posisi) ↓ swap-account (mengonfirmasi hasil penutupan) |
- Alur Kerja Spot Trading
| spot-market (memeriksa harga spot dan kedalaman) ↓ spot-account (memeriksa saldo akun spot) ↓ spot-trade (memasang pesanan beli atau jual) |
- Transfer Aset Antar-Akun
| spot-account (lihat saldo spot) ↓ spot-account / fund-account (mentransfer aset ke akun futures) ↓ swap-trade (trade futures dengan dana yang ditransfer) |
Struktur File
Setiap modul skill terdiri dari dua berkas:
| skills/<skill-name>/ ├── SKILL.md # Deskripsi penggunaan agen └── api-reference.md # Dokumentasi API lengkap |
- SKILL.md: Menjelaskan tujuan keterampilan, tabel referensi cepat, contoh kode TypeScript, aturan interaksi agen (otorisasi, mekanisme konfirmasi, dll.)
- api-reference.md: Dokumen lengkap endpoint API, termasuk detail parameter, bidang respons, contoh JSON, dan kode kesalahan.
Dokumentasi referensi umum dapat ditemukan di direktori skills/references/:
- authentication.md — Implementasi tanda tangan HMAC SHA256
- base-urls.md — Konfigurasi URL dasar lingkungan
