Короткий посібник для користувачів з ШІ-помічниками для кодування.
Огляд
Цей документ є збіркою навичок BingX API для ШІ-помічників з кодування, включно з 15 модулями навичок, які охоплюють безстрокові ф'ючерси, спотову торгівлю, копітрейдинг та керування акаунтом.
Після встановлення ви можете безпосередньо взаємодіяти природною мовою зШІ, щоб запитувати ринкові дані, розміщувати торги та керувати рахунками, не пишучи вручну код запиту API.
Підтримувані ШІ-помічники:Claude Code,Cursor та інші ШІ-помічники з кодування, які підтримують механізм навичок.
Інсталяція
- Загальне встановлення (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-лінія, ставка фінансування, відкритий інтерес тощо. | Не завершено |
| 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 | Ф'ючерсний копітрейдинг: закриття позицій, встановлення TP/SL, встановлення комісійних тощо. | Так |
- Керування акаунтом
| Назва навички | Призначення | Необхідність авторизації |
| 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 перед виконанням. У демо-середовищі підтвердження не потрібне.
- Маскування ключів
ШІ автоматично маскуватиме ключі під час їхнього показу:
- Ключ API: показано перші 5 і останні 4 символи, наприклад, su1Qc...8akf
- Секретний ключ: повністю приховано, показані лише останні 5 символів, наприклад, ***...aws1
Типові сценарії використання
Після завершення встановлення ви зможете безпосередньо взаємодіяти з ШІ за допомогою природної мови. Ось декілька типових прикладів:
- Запит ринкових даних
| Повідом поточну ціну BTC-USDT |
| Покажи дані K-лінії за останню годину для ETH-USDT |
| Яка поточна ставка фінансування для BTC-USDT? |
- Торгові операції
| Розмісти ринковий ордер купівлі BTC-USDT на суму 0,01 |
| Розмісти лімітний ордер продажу ETH за ціною 4000 USDT на суму 0,1 |
| Скасуй всі відкриті ордери для BTC-USDT |
- Керування акаунтом
| Покажи баланс мого ф'ючерсного рахунку та поточні позиції |
| Повідом баланс мого спотового рахунку |
| Перекажи 100 USDT з мого спотового рахунку на мій ф'ючерсний рахунок |
- Інші операції
| Покажи список моїх субакаунтів |
| Покажи мій партнерський список рефералів |
Робочий процес з кількома навичками
Для виконання повних торгових процесів можна поєднувати декілька навичок:
- Робочий процес торгівлі ф'ючерсами
| swap-market (показ ринкових даних і глибини BTC-USDT) ↓ swap-account (перевірка балансу рахунку та доступної маржі) ↓ swap-trade (розміщення ордера) |
- Робочий процес керування позиціями
| swap-account (перегляд поточних позицій та PnL) ↓ 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 # Опис використання агента └── api-reference.md # Повна документація API |
- SKILL.md: Визначає призначення навичок, довідкову таблицю, зразки коду TypeScript, правила взаємодії агентів (авторизація, механізм підтвердження тощо).
- api-reference.md: Повна документація кінцевих точок API, включно з подробицями параметрів, полями відповідей, прикладами JSON та кодами помилок
Загальна довідкова документація знаходиться в каталозі skills/references/:
- authentication.md — Реалізація підпису HMAC SHA256
- base-urls.md — Конфігурація базових URL середовища
