Краткое руководство для пользователей ИИ-ассистентов

 

Краткий обзор

В данном документе представлена коллекция из 15 модулей навыков для работающих через API BingX ИИ-ассистентов, включающая навыки для работы с бессрочными фьючерсами, спотовой торговли, копи-трейдинга и управления аккаунтом.

После установки модулей навыков вы сможете взаимодействовать с ИИ на своем языке, чтобы запрашивать рыночные данные, совершать сделки и управлять аккаунтами, без написания кода для API-запросов вручную.

Поддерживаемые ИИ-ассистенты: Claude Code, Cursor и другие ИИ-помощники для кодинга, способные работать с механизмом Skills.

 

Установка

  • Общая установка (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 Рыночные данные: цена, глубина, график, ставка финансирования, открытый интерес и т. д.         Нет
bingx-swap-trade Торговые операции: размещение ордеров, отмена ордеров, настройка плеча, режима активов и т. д.          Да
bingx-swap-account Информация об аккаунте: баланс, текущие позиции, ставки комиссии, движение средств и т. д.          Да
  • Спот
Название навыка Назначение Требуется ли авторизация
bingx-spot-market Рыночные данные: цена, глубина, график, история сделок и т.д. Нет
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:

  1. bingx-swap-market (данные рынка бессрочных фьючерсов)
  2. bingx-spot-market (данные спот рынка)
  • Навыки, требующие авторизации

Все остальные навыки, связанные с торговлей и аккаунтом, требуют настройки следующих переменных среды:

  1. BINGX_API_KEY — ваш ключ API
  2. 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

 

Механизм обеспечения защиты

  • Подтверждение операций записи

В рабочей среде (реальная торговля) все операции записи (размещение ордеров, отмена ордеров, переводы и т. д.) выполняются только после отправки пользователем слова CONFIRM. В демо-среде (демо-торговле) подтверждения не требуется.

  • Маскировка ключей

ИИ автоматически маскирует ключи при их отображении:

  1. Ключ API: отображаются только первые 5 и последние 4 символа, например, su1Qc...8akf.
  2. Секретный ключ маскируется полностью, отображаются только последние 5 символов, например, ***...aws1.

 

Распространенные сценарии использования

После установки вы сможете напрямую обращаться с ИИ на своем языке. Вот несколько примеров запросов:

  • Запрос рыночных данных
Узнай текущую цену BTC-USDT.
Покажи свечной график ETH-USDT за последний час
Какая сейчас ставка финансирования для BTC-USDT?
  • Торговые операции
Размести рыночный ордер на покупку BTC-USDT в объеме 0,01.
Размести лимитный ордер на продажу 0,1 ETH по цене 4 000 USDT.
Отмени все открытые ордера на 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           # описание использования ИИ-агентом
└── api-reference.md   # полная документация по API
  1. SKILL.md определяет назначение навыка, содержит справочную таблицу, примеры кода на TypeScript и правила взаимодействия с агентом (авторизация, механизм подтверждения и т. д.).
  2. api-reference.md: полная документация по эндпоинтам API, в том числе подробная информация о параметрах, поля ответа, примеры JSON и коды ошибок.

Общую справочную документацию можно найти в каталоге skills/references/

  1. authentication.md — реализация подписи HMAC SHA256;
  2. base-urls.md — настройка базовых URL для среды