Bybit MCP

Разрешает приём котировок от не-LP для конкретного RFQ. Это позволяет инициатору запроса получать и исполнять котировки от обычных контрагентов в дополнение к поставщикам ликвидности. Ограничение скорости: 50 запросов в секунду. Подсказка агенту: используйте эту конечную точку, чтобы разрешить контрагентам, не являющимся LP, котировать ваш RFQ. Только создатель RFQ может вызывать эту конечную точку. Передайте rfqId целевого RFQ.

Ручное заимствование для Unified account. Правила: - Заимствование через OpenAPI endpoint поддерживает только плавающую ставку - Этот endpoint — только для ручных операций заимствования - Только для Unified account Сервис: bizasset-uta-loan-prod

Запрашивает баланс определённой монеты в определённом типе счёта. Поддерживает запрос баланса суб-UID с мастер-API-ключом. - accountType и coin обязательны - memberId обязателен при запросе баланса суб-UID с мастер-API-ключом - toMemberId + toAccountType обязательны для запросов баланса, передаваемого между счетами - withLtvTransferSafeAmount=1 требует установки toAccountType

Создаёт заказ на заимствование с фиксированной ставкой для Unified account. Правила: - Поддерживает фиксированные сроки: 7, 14, 30, 90, 180 дней. - Стратегия заказа: PARTIAL (частичное исполнение или отмена) или FULL (исполнение или отмена целиком). - Обработка срока погашения: 1 (автовозврат) или 2 (конвертация в заём с плавающей ставкой). - Заимствование зависит от доступного предложения на рынке кредитования с фиксированной ставкой. - Только для Unified account. Сервис: bizasset-uta-loan-prod Подсказка агенту: ВАЖНО: это создаёт реальный заём с обязательствами по процентам. Перед выполнением вы ОБЯЗАНЫ попросить пользователя явно подтвердить сумму займа, годовую ставку и срок. Не выполняйте автоматически.

Ручное погашение без конвертации активов (погашение без потерь). Система использует только доступный остаток на спотовом счёте в валюте долга. Правила: - Если передан только coin без amount, система использует доступный спотовый остаток в валюте долга - Если coin не передан во входном параметре, amount передать нельзя - Погашение запрещено с 04:00 до 05:30 каждый час - Проценты начисляются исходя из суммы займа (BorrowAmount) в 05:00 каждый час - Обязательства с плавающей ставкой погашаются раньше, чем с фиксированной - BYUSDT нельзя использовать для погашения Сервис: bizasset-uta-loan-prod

Вручную погашает обязательства Unified Account. Правила: - Если не указаны ни coin, ни amount, система погашает все обязательства - Если указана только coin (без amount), обязательство по этой монете погашается полностью - Если coin не передана, amount передать нельзя - Система сначала использует доступный спотовый баланс; оставшиеся суммы запускают конвертацию активов в порядке принудительного погашения - Обязательства с плавающей ставкой погашаются раньше обязательств с фиксированной ставкой - BYUSDT и MNT исключены из стандартного погашения через конвертацию - Погашение заблокировано с 04:00 до 05:30 UTC каждый час; проценты начисляются в 05:00 UTC - Комиссии за конвертацию используют более высокую ставку актива с лимитом 300 000 USD на транзакцию Сервис: bizasset-uta-loan-prod

Вносит средства в пул ликвидности. - quoteAmount и baseAmount обязательны условно: должен быть указан хотя бы один из них. - quoteAccountType требуется при внесении quoteCoin; baseAccountType требуется при внесении baseCoin. - orderLinkId используется для идемпотентности; максимум 40 символов; после использования то же значение нельзя применить повторно — повторная отправка возвращает ошибку. Ограничение частоты: 5 запросов/с (UID) Подсказка агенту: ВАЖНО: эта операция зачисляет реальные активы в пул ликвидности. Перед выполнением ОБЯЗАТЕЛЬНО попросите пользователя явно подтвердить продукт, суммы токенов и риск непостоянных потерь. Не выполняйте автоматически.

Добавляет дополнительное обеспечение (маржу) к позиции с кредитным плечом в Liquidity Mining, чтобы избежать ликвидации. Rate Limit: 5 запросов/с (UID) Подсказка агенту: ВАЖНО: Это добавляет реальное обеспечение к существующей позиции liquidity mining. Перед выполнением вы ДОЛЖНЫ попросить пользователя явно подтвердить ID позиции и сумму маржи. Не выполняйте автоматически.

Добавляет или уменьшает маржу для позиции в режиме изолированной маржи. Использует положительное значение для добавления маржи или отрицательное для её уменьшения. Возвращает обновлённые детали позиции после изменения маржи. Подсказка агенту: Используйте этот инструмент для ручной корректировки маржи по позициям с изолированной маржой. Передайте положительное значение маржи для добавления, отрицательное для уменьшения (например, "10" или "-10"). Максимум 4 знака после запятой. В режиме хеджирования укажите positionIdx. Возвращает полную обновлённую информацию о позиции, включая новый liqPrice.

Изменяет существующий открытый ордер. Можно обновить параметры цены, объёма, триггерной цены, тейк-профита и стоп-лосса. - Необходимо указать либо orderId, либо orderLinkId, чтобы идентифицировать целевой ордер - Изменить можно только неисполненные или частично исполненные ордера - Для опционов можно изменить orderIv (передайте фактическое значение, например, 0.1 для 10%) - Ответ — только подтверждение; проверяйте через WebSocket-канал ордеров Подсказка агенту: используйте эту конечную точку для изменения цены, объёма или TP/SL существующего открытого ордера. TradFi: используйте category=spot для токенов xStock, category=linear для бессрочных контрактов на акции/товары.

Изменяет (модифицирует) цену и/или количество существующего спред-ордера. Сценарии использования: - Корректировка цены открытого лимитного ордера без отмены и повторного создания. - Изменение количества неисполненного или частично исполненного ордера. - Для указания целевого ордера используйте orderId или orderLinkId. Важно: - Чтобы идентифицировать ордер, требуется либо orderId, либо orderLinkId. - Необходимо указать хотя бы один из параметров: qty или price. - Изменять можно только неисполненные или частично исполненные ордера. - Установка price="" (пустая строка) оставляет текущую цену без изменений. - Установка price="0" обновляет цену до нуля. - Ответ возвращается асинхронно; отслеживайте финальный статус через WebSocket. Подсказка для агента: конечная точка POST с аутентификацией. Для идентификации ордера требуется либо orderId, либо orderLinkId. Должен быть указан хотя бы один из параметров: qty или price. Изменять можно только неисполненные или частично исполненные ордера. price="" сохраняет текущую цену; price="0" устанавливает цену в ноль. Ответ асинхронный.

Запрашивает котировку на конверсию. Система возвращает: - Quote ID (quoteTxId) - Обменный курс в реальном времени - Время истечения котировки - Суммы конверсии Правила котировок: - Котировки действуют ограниченное время, обычно 30 секунд - После истечения нужно запросить новую котировку - Сумма котировки должна быть в пределах лимитов торговой пары Важно: этот endpoint могут вызывать только API-ключи от Master UID. Варианты использования: - Зафиксировать обменный курс перед подтверждением сделки - Показать пользователям точную сумму, которую они получат - Проверить параметры сделки перед выполнением

Изменяет несколько существующих открытых ордеров за один вызов API. - Максимум 20 ордеров на запрос для фьючерсов/опционов, 10 для спота - Для каждого ордера требуется либо orderId, либо orderLinkId - Изменять можно только неисполненные или частично исполненные ордера - Проверяйте retExtInfo.list[].code для статуса каждого ордера - Ответ — только подтверждение; подтверждайте через WebSocket поток ордеров Подсказка агенту: используйте эту конечную точку для изменения нескольких ордеров за раз. Для одиночного ордера используйте amendOrder. TradFi: используйте category=spot для пакетного изменения xStock, category=linear для бессрочных контрактов на акции/товары.

Отменяет несколько заказов за один вызов API. - Не более 20 заказов на запрос для фьючерсов/опционов, 10 для спота - Для каждого заказа требуется orderId или orderLinkId - Отменить можно только неисполненные или частично исполненные заказы - Статус каждого заказа проверяйте по retExtInfo.list[].code - Ответ — только подтверждение получения; подтверждайте отмену через WebSocket поток заказов Подсказка агенту: используйте эту конечную точку для массовой отмены конкретных заказов. Для отмены всех заказов используйте cancelAllOrders. TradFi: для пакетной отмены xStock используйте category=spot, для бессрочных контрактов на акции/товары — category=linear.

Размещает несколько ордеров в одном вызове API. - Максимум 20 ордеров на запрос для фьючерсов/опционов, 10 для спота - Каждый ордер проверяется независимо; возможен частичный успех - Проверяйте retExtInfo.list[].code для статуса каждого ордера - Ответ — только подтверждение; проверяйте через стрим ордеров WebSocket Подсказка агенту: используйте этот эндпоинт для размещения нескольких ордеров одновременно. Проверяйте retExtInfo.list на коды успеха/ошибки каждого ордера. TradFi: используйте category=spot для пакетных ордеров xStock, category=linear для бессрочных контрактов на акции/товары.

Отменяет все открытые ордера, соответствующие указанным критериям. - Для linear/inverse: необходимо указать хотя бы symbol, baseCoin или settleCoin - Для опционов: отмените все опционные ордера без дополнительных фильтров - Для spot: по умолчанию отменяются все обычные ордера - Используйте orderFilter для выбора конкретных типов ордеров (normal, TP/SL, stop, OCO) - Ответ — только подтверждение; проверяйте через стрим ордеров WebSocket Подсказка агенту: Используйте этот эндпоинт, чтобы отменить все открытые ордера для категории/символа сразу. Для отмены одного ордера используйте cancelOrder. TradFi: используйте category=spot для отмены всех ордеров xStock, category=linear для бессрочных контрактов на акции/товары.

Отменяет все активные котировки для аутентифицированного аккаунта. Возвращает массив результатов со статусом отмены каждой котировки. Ограничение скорости: 50 запросов в секунду. Подсказка для агента: Эта конечная точка отменяет все активные котировки сразу. Параметры тела запроса не требуются. В ответе перечисляется каждая отменённая котировка с её статусом успеха/неудачи.

Отменяет все активные RFQs для аутентифицированного аккаунта. Возвращает массив результатов отмены, по одному на каждый RFQ. Когда инициатор отменяет запрос, все соответствующие котировки становятся недействительными. Когда поставщик отменяет котировку, запрос остаётся без изменений, но котировка становится недействительной. Ограничение скорости: 50 запросов в секунду. Подсказка агенту: Эта конечная точка отменяет все активные RFQs сразу. Тело запроса не требуется. Ответ возвращает массив результатов, показывающий, какие RFQs были отменены.

Отменяет все открытые спред-ордера, опционально отфильтрованные по символу. Сценарии использования: - Отменяет все открытые спред-ордера по всем символам, задав cancelAll = true. - Отменяет все открытые ордера для конкретного спред-символа, указав symbol. - Экстренное управление рисками: быстро закрывает все открытые спред-ордера. Важно: - Когда указан symbol, cancelAll игнорируется, и отменяются только ордера, соответствующие этому символу. - Когда symbol опущен и cancelAll = true, отменяются все открытые ордера по всем символам. - Ответ асинхронный — следите за WebSocket для подтверждения окончательного статуса. Подсказка агенту: POST-эндпоинт, требующий аутентификации. Когда указан symbol, cancelAll игнорируется. Когда symbol опущен и cancelAll=true, отменяются все ордера. Ответ асинхронный — используйте WebSocket для подтверждения.

Отменяет один открытый ордер по orderId или orderLinkId. - Необходимо указать либо orderId, либо orderLinkId - Система отдаёт приоритет orderId, если указаны оба, но они конфликтуют - Для спотовых ордеров orderFilter позволяет выбирать определённые типы ордеров - Ответ — только подтверждение; проверяйте через поток ордеров WebSocket Подсказка агенту: используйте этот эндпоинт для отмены одного открытого ордера по его orderId или orderLinkId. TradFi: используйте category=spot для токенов xStock, category=linear для бессрочных контрактов на акции и товары.

Отменяет активную котировку. Вы должны передать один из следующих параметров: quoteId, rfqId или quoteLinkId. Порядок приоритета при передаче нескольких: quoteId > quoteLinkId > rfqId. Ограничение скорости: 50 запросов в секунду. Подсказка агенту: передайте один из параметров quoteId, quoteLinkId или rfqId, чтобы отменить котировку. Приоритет: quoteId > quoteLinkId > rfqId. При использовании rfqId отменяются все котировки для этого RFQ.

Отменяет активный RFQ. Необходимо передать либо rfqId, либо rfqLinkId. Если переданы оба, учитывается только rfqId. Когда инициатор отменяет заказ, все соответствующие котировки становятся недействительными. Ограничение частоты запросов: 50 запросов в секунду. Подсказка агенту: передайте либо rfqId, либо rfqLinkId, чтобы отменить RFQ. Если переданы оба, приоритет у rfqId. Отмена RFQ делает недействительными все связанные котировки.

— "ответ", acknowledgement — "подтверждение", cancellation — "отмена", asynchronously — "асинхронно". "does not guarantee cancellation" — "не гарантирует отмену". "by its order ID or custom order link ID" — "по его идентификатору order ID или пользовательскому order link ID". В Usage Scenarios "cancel an open limit order" — "отменяет открытый лимитный ордер". В Important "Either orderId or orderLinkId must be provided" — "Необходимо указать orderId или orderLinkId". "Monitor the WebSocket stream for final order status confirmation" — "Следите за WebSocket-потоком, чтобы подтвердить финальный статус ордера". Глагол в повелительном наклонении, но в оригинале тоже повелительное ("Monitor"), так что можно оставить. Или перевести как "Отслеживайте". В Agent hint: "POST endpoint requiring authentication" — "POST-эндпоинт, требующий аутентификации". "Either orderId or orderLinkId is required" — "Требуется orderId или orderLinkId". "Response is asynchronous -- the acknowledgement does not guarantee cancellation" — "Ответ асинхронен — подтверждение не гарантирует отмену". "Use the WebSocket stream to confirm final status" — "Используйте WebSocket-поток для подтверждения финального статуса". В итоге получится текст, разбитый на абзацы и пункты. Проверим, чтобы не было "является" и т.д. Начнем: "Отменяет один ордер спред-торговли по его order ID или пользовательскому order link ID." (Можно "спред-торговли" или "обыкновенный спред-ордер"? Оригинал "spread trading order" — обычно "спред-ордер". Лучше "спред-торговли" как контекст.) Далее "Usage Scenarios" — "Сценарии использования:" (с **). Пункты. "Important" — "Важно:" (с **). Agent hint оставим как "Подсказка агенту:". Для пунктов используем тире. Сохраним жирное выделение заголовков. Глагол "Cancel" — "отменяет". Да, как в примере "Convert a resource" -> "Преобразует". Теперь напишем перевод.Убедимся, что нет "играет ключевую роль" и подобного. Все ок. Тон деловой. Соблюдены правила. Орфография. Ещё один момент: в оригинале "spread trading order" — возможно, "спред-ордер". Лучше уточнить: "однотипный спред-ордер" или просто "ордер спред-торговли". Оставлю как "ордер спред-торговли" чтобы точнее, но можно и "спред-ордер". Решу: "ордер спред-торговли" звучит немного тяжело, но сохраняет смысл. В русском трейдинге обычно говорят "спред-ордер". Пусть будет "спред-ордер". Но в оригинале "spread trading order" — это ордер на спред-торговлю, не обязательно маркет-мейкинг. Думаю, "спред-ордер" понятно. Я напишу "спред-ордер". Итоговый перевод.Примечание: в конце текста "Agent hint" — можно оставить как есть, или перевести, но в правилах сказано не переводить имена собственные и технические названия, но это не техническое название, а подсказка. Можно перевести. Переведу как "Заметка для агента:" или "Подсказка агенту:". Возьму "Подсказка агенту:". Формат: в оригинале после "Agent hint:" идет описание, и это отдельная строка, не в блоке. Сохраним. Ещё после "Response is asynchronous -- the acknowledgement does not guarantee cancellation." в оригинале точка и затем новая строка "Use the WebSocket stream..." — в блоке Important это как отдельное предложение. Сохраним. Теперь можно писать. Переведу.Отменяет один спред-ордер по его order ID или пользовательскому order link ID. Сценарии использования: - Отменяет открытый лимитный ордер, который ещё не полностью исполнен. - Используйте orderId (назначенный системой) или orderLinkId (заданный пользователем) для идентификации ордера. Важно: - Необходимо указать orderId или orderLinkId. - Ответ — это только подтверждение. Отмена обрабатывается асинхронно. Следите за WebSocket-потоком для подтверждения финального статуса ордера. Подсказка агенту: POST-эндпоинт, требующий аутентификации. Требуется orderId или orderLinkId. Ответ асинхронен — подтверждение не гарантирует отмену. Используйте WebSocket-поток для подтверждения финального статуса.

Заберите все доступные проценты для указанного продукта одним кликом. - Передайте productId=-1, чтобы собрать проценты по всем продуктам сразу - Доход зачисляется на основной счёт пользователя; accountType указать нельзя - У каждого продукта не более одной активной позиции, поэтому positionId не требуется Ограничение частоты: 5 запросов/с (UID)

Останавливает работающий комбо-бот для фьючерсной торговли. Бот отменяет все ожидающие ордера и закрывает все позиции в портфеле. bot_id получается из ответа createComboBot или из getComboDetail. Остановить можно только ботов в работающем состоянии. Ограничение частоты: 10 запросов в секунду на UID. Подсказка агенту: используйте этот инструмент, чтобы остановить работающий комбо-бот. bot_id обязателен и находится в ответе createComboBot. stop_type указывает причину остановки. После остановки используйте getComboDetail, чтобы проверить итоговый PnL и причину закрытия.

Закрывает работающего бота DCA. Необходимо указать close_mode, чтобы определить, как будут урегулированы оставшиеся активы: - 1 (DCA_BIT_MODE): расчёт в BIT - 2 (DCA_BASE_MODE): конвертировать всё в базовые токены - 3 (DCA_QUOTE_MODE): конвертировать всё в токен котировки Бот должен находиться в состоянии, допускающем закрытие. Боты, которые сейчас находятся в середине инвестиционного цикла, могут быть недоступны для закрытия (status_code=503). Лимит запросов: 3 запроса в секунду на UID. Подсказка агенту: Используйте close_mode=3 (DCA_QUOTE_MODE), если пользователь хочет конвертировать всё обратно в монету котировки (например, USDT).

Закрывает (останавливает) работающего фьючерсного сеточного бота. Бот отменяет все ожидающие сеточные ордера и закрывает позиции. bot_id можно получить из ответа createFGridBot или из getFGridDetail. Остановить можно только ботов в рабочем состоянии. Ограничение частоты: 10 запросов в секунду на одного пользователя (UID). Подсказка агенту: Используйте этот инструмент, чтобы остановить работающего сеточного бота. bot_id обязателен, его можно найти в ответе createFGridBot. После остановки вызовите getFGridDetail, чтобы проверить итоговую PnL и причину закрытия.

Закрывает (останавливает) работающего фьючерсного торгового бота Martingale. Бот отменяет все ожидающие ордера и закрывает позицию. bot_id можно получить из ответа createFMartBot или из getFMartDetail. Закрыть можно только ботов в рабочем состоянии. Ограничение скорости: 10 запросов в секунду на UID. Подсказка агенту: Используйте этот инструмент для остановки работающего бота Martingale. bot_id обязателен и находится в ответе createFMartBot. stop_type указывает причину закрытия. После закрытия используйте getFMartDetail для проверки итоговой PnL и причины закрытия.

Закрывает работающего спот-грид-бота. Необходимо указать close_mode, чтобы определить, как распределяются оставшиеся активы: - 1 (BIT_MODE): расчет в BIT - 2 (BASE_MODE): конвертировать всё в базовый токен - 3 (QUOTE_MODE): конвертировать всё в токен котировки - 4 (BASE_AND_QUOTE_MODE): вернуть активы как есть, без конвертации Бот должен находиться в состоянии, допускающем закрытие (NEW или RUNNING). Ботов в состоянии CANCELLING или COMPLETED закрыть повторно нельзя. Ограничение скорости: 3 запроса в секунду на UID. Подсказка агенту: используйте close_mode=3 (QUOTE_MODE), если пользователь хочет вывести средства в стейблкоин. Используйте close_mode=4, если пользователь хочет сохранить оба токена.

Запрашивает минимальный/максимальный лимит одной конверсии для указанной валютной пары в рамках указанного типа счета. - Интерфейс OpenAPI, требуется аутентификация через API-ключ - Разрешение ACL: RESOURCE_GROUP_EXCHANGE_HISTORY + PERMISSION_READ - Лимит запросов: 100/path/s глобально

Запрашивает список конвертируемых монет для указанного типа счета и направления конверсии. - Интерфейс OpenAPI, требует аутентификации по API Key - Разрешение ACL: RESOURCE_GROUP_EXCHANGE_HISTORY + PERMISSION_READ - Ограничение скорости: 30/user/s, 1500/path/s глобально - Требует проверки соответствия (продукт CONVERSION)

Подтверждает ожидаемое обновление ставки поддержания маржи для позиции. Это снимает ограничение только на уменьшение, которое было применено, когда Bybit скорректировал лимит риска. Подсказка агенту: используйте это, когда у позиции isReduceOnly=true из-за корректировки лимита риска Bybit. Вызов этого подтверждает новый MMR и снимает ограничение только на уменьшение. Проверьте isReduceOnly в getPositionInfo, чтобы определить, нужно ли это действие.

Подтвердите котировку и выполните конверсионную сделку. Важно: - Необходимо подтвердить в течение срока действия котировки - Выполнение сделки асинхронно и не завершится мгновенно - Используйте конечную точку запроса сделки для проверки финального статуса - Рекомендуется настроить вебхук для получения уведомлений о завершении сделки Статусы сделки: - processing: Сделка обрабатывается - success: Сделка выполнена успешно - failed: Сделка не выполнена Варианты использования: - Выполнить сделку после того, как пользователь подтвердит котировку - Отправить сделку с пользовательским идентификатором отслеживания (merchantRequestId) - Настроить вебхук для получения обновлений статуса в реальном времени

Подтверждает и выполняет конвертацию на основе идентификатора котировки. Обмен асинхронный; проверяйте итоговый статус, вызывая API запроса результата. Убедитесь, что вы подтверждаете котировку до её истечения. - Интерфейс OpenAPI, требуется аутентификация по API-ключу - Права ACL: RESOURCE_GROUP_EXCHANGE_HISTORY + PERMISSION_WRITE - Ограничение частоты: 5/пользователь/с, 100/путь/с глобально - Требуется верификация KYC

Запрашивает все подтверждённые записи конверсий. Поддерживает несколько типов кошельков и разделённые запятыми accountType. - Интерфейс OpenAPI, требует аутентификации по API-ключу - Разрешение ACL: RESOURCE_GROUP_EXCHANGE_HISTORY + PERMISSION_READ - Ограничение скорости: 50/path/s глобально

Создает стратегию Chase Order, которая непрерывно отслеживает рыночную цену и автоматически корректирует цену ордера, чтобы повысить вероятность исполнения. Когда использовать: - Нужно быстрое исполнение, но при этом цена лучше, чем по рыночному ордеру - Рынок волатилен, цена быстро меняется - Хотите оставаться вблизи вершины книги ордеров без ручных корректировок Поведение при исполнении: 1. Получить текущий лучший бид/аск из книги ордеров 2. Рассчитать цену преследования = лучшая цена ± смещение преследования (дистанция или процент) 3. Разместить лимитный ордер по цене преследования 4. Непрерывно отслеживать рыночную цену 5. Если цена движется и текущий ордер перестает быть конкурентным: - Отменить существующий ордер - Пересчитать цену преследования - Разместить новый ордер по лучшей цене 6. Повторять до полного исполнения или достижения maxChasePrice Расчет цены: - С использованием chaseDistance: buy_price = ask - chaseDistance или sell_price = bid + chaseDistance - С использованием chasePercentE4: buy_price = ask × (1 - chasePercentE4/10000) или sell_price = bid × (1 + chasePercentE4/10000) - Защита maxChasePrice: стратегия останавливается, если эта цена превышена Важные замечания: - Стратегия преследования будет часто отменять и заменять ордера — следите за лимитами API - ОБЯЗАТЕЛЬНО установите maxChasePrice, чтобы избежать выхода из-под контроля при экстремальной волатильности - Рекомендуемый chasePercentE4: 10–50 (0.1%–0.5%) для пар с высокой ликвидностью - Используйте chaseDistance для пар с низкой ликвидностью и фиксированным шагом цены - Стратегия останавливается, когда: ордер полностью исполнен, достигнут maxChasePrice или стратегия вручную отменена Подсказка агенту: Используйте эту конечную точку, когда пользователю нужно быстрое исполнение ордера с отслеживанием цены. Лучше всего подходит для запросов вроде «купи быстро, но не выше 26000». Не используйте для медленного исполнения или когда нужно скрыть намерение ордера — вместо этого используйте TWAP или Iceberg.

Создаёт комбинированного торгового бота для фьючерсов, который управляет портфелем из нескольких фьючерсных символов. Бот автоматически ребалансирует позиции в зависимости от настроенного режима триггера (по времени, по проценту или по обоим). Обязательные параметры: кредитное плечо, начальная маржа, режим ребалансировки и хотя бы один набор настроек символа с целевым процентом позиции и стороной. Перед вызовом этой конечной точки используйте /v5/fcombobot/getlimit, чтобы проверить диапазоны параметров. bot_id из ответа потребуется для последующих операций, таких как getComboDetail или closeComboBot. Ограничение частоты: 10 запросов в секунду на один UID. Подлежит проверке соответствия, GEO IP и верификации KYC. Подсказка агенту: всегда сначала вызывайте getComboLimit, чтобы убедиться, что параметры в допустимом диапазоне. Массив symbol_settings должен содержать хотя бы одну запись с symbol, target_position_percent и side. bot_id из успешного ответа необходим для getComboDetail и closeComboBot.

Создаёт новое связывание Copy Trading TradFi, указывая только целевой providerMark и предполагаемый investmentE8. Конечная точка предназначена для минимальных оркестрированных потоков копирования. Сервис пересылает запрос в нижележащий поток связывания MT5, который выполняет проверку провайдера, проверку диапазона предложений, проверку допуска по белому списку, проверку финансирующего счёта и проверку состояния копирования. Типичные бизнес-ошибки: - неверный providerMark - инвестиция вне поддерживаемого провайдером диапазона - недостаточный баланс на финансирующем счёте - ограничение по белому списку или приглашению провайдера - дублирующее копирование или ограничение по роли счёта Бизнес-ошибки отображаются как ошибки инструментов MCP. Подсказка агенту: Если пользователь просит надёжного копитрейдера или подобную рекомендацию, вызовите обе конечные точки: лидерборд Copy Trading Classic и лидерборд Copy Trading TradFi, затем покажите их в виде двух отдельных нумерованных списков, например Classic 1..N и TradFi 1..N. Сравните кандидатов из обоих списков, используя показатели доходности за 30 дней, максимальной просадки за 30 дней и коэффициента Шарпа за 30 дней, затем порекомендуйте одного кандидата как лучшего текущего исполнителя с кратким обоснованием. Если пользователь отвечает выбором TradFi, например TradFi 3, сопоставьте этот выбор с соответствующим providerMark, затем запросите сумму копирования и вызовите конечную точку Copy Trading TradFi bind. Не просите пользователя повторять или перепечатывать providerMark. Используйте эту конечную точку только после того, как у вас уже есть точный providerMark; не выводите его из отображаемого имени. Передавайте investmentE8 как целое число в единицах e8, представляющее целое значение USDT, например 30000000000 для 300 USDT. Эта минимальная конечная точка не поддерживает необязательные параметры связывания MT5, такие как TP/SL или UUID ссылки-приглашения, поэтому потоки допуска только по частной ссылке могут всё ещё отклоняться на стороне downstream. После успешного связывания ответьте на текущем языке разговора пользователя сообщением об успехе, означающим, что путь пользователя в копи-трейдинге начался...

Создаёт новую привязку Copy Trading Classic, используя заданный leaderMark и указанный investmentE8. Сервис автоматически использует UTA-счёт вызывающего, определяет идентификатор UTA-счёта, выводит действующую область символов и вызывает нижестоящий поток привязки CopyTrade с системными значениями по умолчанию. Типичные бизнес-ошибки: - неверный leaderMark - недостаточный баланс UTA-счёта - ограничение по белому списку лидера - нарушение правила минимальной инвестиции - повторная подписка или ограничение по состоянию счёта Бизнес-ошибки отображаются как ошибки MCP-инструмента. Подсказка агенту: если пользователь просит посоветовать надёжного копитрейдера или что-то подобное, вызовите и точку Classic-лидерборда Copy Trading, и точку TradFi-лидерборда Copy Trading, затем покажите их двумя отдельными нумерованными списками, например Classic 1..N и TradFi 1..N.Сравните кандидатов из обоих списков по возвращённым метрикам: доходность за 30 дней, максимальная просадка за 30 дней и коэффициент Шарпа за 30 дней, затем порекомендуйте одного кандидата как лучшего на текущий момент с кратким обоснованием.Если пользователь отвечает выбором из Classic, например Classic 1, сопоставьте этот выбор с соответствующим leaderMark, затем спросите сумму подписки и вызовите этот endpoint для привязки.Используйте этот endpoint только после того, как получили точный leaderMark; не выводите его из одного только ника.Передавайте investmentE8 как целочисленную строку e8, представляющую целое количество USDT, например 10000000000 для 100 USDT.Сервис автоматически использует UTA-счёт вызывающего, выводит символы из настроек синхронизации лидера и по-прежнему применяет логику белого списка и Sync Master. После успешной привязки ответьте на текущем языке пользователя сообщением об успехе, означающим, что путь копитрейдинга пользователя начался, он в любое время может зайти в Trading Hub Copy Trading для персонализированного управления, а AI в будущем откроет более интеллектуальные возможности копитрейдинга.Пример на английском: Your copy trading journey…

Создаёт DCA-бота, который автоматически инвестирует через заданные интервалы. Укажите частоту инвестирования (в секундах), котируемую валюту, торговые пары с индивидуальными суммами и опционально максимальную сумму инвестиций. Предварительные требования: - Пользователь должен быть аутентифицирован и пройти проверки KYC/комплаенс. - Торговые пары должны быть валидными и не дублироваться. - Минимальная частота — 10 секунд. - Не более 5 торговых пар на одного бота. При успехе возвращает bot_id. Если пользователь заблокирован (status_code=421), ban_reason_text содержит локализованное пояснение. Лимит запросов: 3 qps на UID. Подсказка агенту: поле parameters.frequency_in_second управляет частотой, с которой бот инвестирует. Типовые значения: 600 (10 мин), 3600 (1 час), 86400 (1 день). Каждая пара в parameters.pairs указывает базовую монету и её сумму инвестиций за раунд.

Создаёт одного бота для фьючерсной сеточной торговли. Бот будет автоматически размещать сеточные ордера в заданном ценовом диапазоне. Обязательные параметры: symbol, grid_mode, ценовой диапазон, количество сеток, кредитное плечо, тип сетки и начальная инвестиция. Необязательные параметры: настройки TP/SL, триггер по цене входа и трейлинг-стоп. Перед вызовом этого endpoint используйте /v5/fgridbot/validate, чтобы проверить диапазоны параметров. Ответ содержит check_code, который указывает на конкретные ошибки валидации при неудаче создания. Ограничение скорости: 10 запросов в секунду на один UID. Действует compliance wall и проверка KYC. Подсказка агенту: сначала всегда вызывайте validateFGridInput, чтобы убедиться, что параметры в допустимом диапазоне. Если status_code не равен нулю, посмотрите check_code для конкретной ошибки. bot_id из успешного ответа понадобится для последующих операций, таких как getFGridDetail или closeFGridBot.

Создаёт фьючерсного мартингейл-трейдинг-бота. Бот открывает начальную позицию и добавляет к ней при падении цены (режим Long) или росте (режим Short) на заданный price_float_percent. Каждое добавление масштабирует позицию на add_position_percent. Ключевые параметры: symbol, mode (long/short), leverage, price trigger percentage, add position ratio, max add count, initial margin и round take-profit percentage. Опциональные параметры: stop-loss, entry price trigger, auto-cycle toggle и trailing stop. Перед вызовом этой конечной точки используйте /v5/fmartingalebot/getlimit для проверки диапазонов параметров. Rate limit: 10 запросов в секунду на один UID. Подлежит проверкам compliance wall, GEO IP check и KYC. Подсказка для агента: Всегда сначала вызывайте getFMartLimit, чтобы убедиться, что параметры в допустимом диапазоне. Параметр martingale_mode определяет направление: 1=Long (покупает на падении), 2=Short (продаёт на росте). auto_cycle_toggle=1 означает, что бот перезапускается после каждого round TP. bot_id из успешного ответа необходим для getFMartDetail и closeFMartBot.

Создаёт спот-грид бота с указанной торговой парой, ценовым диапазоном, количеством сеток и суммой инвестиций. Опционально поддерживает цену входа, стоп-лосс/тейк-профит, трейлинг-стоп и трейлинг сеток (автосдвиг). Предварительные требования: - Сначала вызовите validateGridInput, чтобы убедиться в корректности параметров. - Пользователь должен быть аутентифицирован и пройти проверки KYC/соответствия. Возвращает grid_id в случае успеха. Если пользователь заблокирован (status_code=421), ban_reason_text предоставляет локализованное объяснение. Лимит запросов: 3 запроса в секунду на UID. Подсказка агенту: Всегда вызывайте validateGridInput перед этой конечной точкой. Поле symbol использует верхний регистр, например "BTCUSDT". Используйте invest_mode для управления тем, инвестировать только в котируемую валюту (0), только в базовую (1) или в обе (2).

Создаёт Iceberg-стратегию, которая разбивает крупный ордер на множество мелких дочерних ордеров, показывая за раз только один — чтобы скрыть торговые намерения. Когда использовать: - Вы размещаете крупный ордер и хотите скрыть его полный объём от рынка. - Вы хотите предотвратить манипуляции ценой, основанные на вашем объёме. - Вам нужно снизить рыночное влияние, сохраняя согласованную цену. - Вы хотите получать мейкерские скидки, используя ордера post-only. Порядок исполнения: 1. Рассчитать размер дочернего ордера: - Если указан subSize: orderCount = size / subSize - Если указан orderCount: subSize = size / orderCount 2. Создать первый дочерний ордер (с лимитной или преследующей ценой). 3. Дождаться полного исполнения дочернего ордера. 4. После исполнения создать следующий дочерний ордер. 5. Повторять до тех пор, пока не выполнится весь объём. 6. Каждый дочерний ордер независим — при преследовании цены они могут различаться. Важные замечания: - Рекомендуемый subSize: 5%-20% от общего объёма. - Установите postOnly=1, чтобы получить скидку мейкера. - Задайте chaseDistance="-1" для агрессивного исполнения в роли тейкера (удар по лучшему биду/аску). - Всегда задавайте maxChasePrice для защиты цены. - Стратегия выполняется последовательно — медленнее Chase, но скрытнее. - Если дочерний ордер исполнился частично и был отменён, стратегия продолжает работу с оставшимся объёмом. Подсказка агенту: Используйте эту конечную точку, когда пользователь хочет скрыть крупный объём ордера от рынка. Лучше всего подходит для запросов вроде «купить 100 BTC, не показывая полный объём». Не используйте для срочного исполнения — для этого применяйте Chase Order.

Размещает новый ордер на бирже Bybit. - Spot: поддерживает обычные ордера, ордера TP/SL и условные (стоп) ордера через orderFilter - Linear/Inverse: поддерживает однонаправленный и хеджевый режим через positionIdx - Options: требуется orderLinkId; заказ по подразумеваемой волатильности через orderIv Ответ — только подтверждение. Используйте поток ордеров WebSocket, чтобы подтвердить фактический статус ордера. Подсказка агенту: используйте эту конечную точку, чтобы разместить новый ордер на покупку или продажу для спотовых, линейных, инверсных или опционных продуктов. TradFi: токены xStock используют category=spot (например TSLAXUSDT); бессрочные контракты на акции и товары используют category=linear (например TSLAPUSDT, XAUUSDT, CLUSDT).

Отправляет котировку для существующего RFQ. Квотер указывает цены для ног RFQ в направлениях покупки и/или продажи. Должен быть указан хотя бы один из параметров quoteBuyList или quoteSellList. - quoteBuyList: Исполнение Maker совпадает с направлением ноги - quoteSellList: Исполнение Maker противоположно направлению ноги Ограничение скорости: 50 запросов в секунду. Подсказка агенту: Используйте этот инструмент, чтобы ответить на RFQ с указанием цен. Укажите хотя бы один из параметров quoteBuyList или quoteSellList. Нельзя выставлять котировку на собственный RFQ. Для спотовых продуктов убедитесь, что обеспечение включено.

Создаёт новый запрос котировок (RFQ) для получения цен от выбранных контрагентов. Инициатор указывает одну или несколько ног (инструментов) и список контрагентов, которые получат RFQ. Каждая нога определяет категорию продукта, символ, направление и количество. Ограничение скорости: 50 запросов в секунду. Совет: Используйте эндпоинт Get RFQ Config, чтобы получить доступных контрагентов, типы стратегий и максимальное количество ног перед созданием RFQ. Подсказка агенту: Используйте этот эндпоинт для создания нового RFQ. Сначала нужно вызвать Get RFQ Config, чтобы получить корректные deskCodes контрагентов и максимальное количество разрешённых ног. Все ноги должны иметь одинаковые базовую и расчетную монеты.

Создаёт новый ордер для спред-торговли. Сценарии использования: - Открывает новую спред-позицию, размещая лимитный или рыночный ордер по символу спред-комбинации. - Использует orderLinkId для назначения пользовательского идентификатора с целью отслеживания. - Использует timeInForce для управления исполнением (например, PostOnly для заполнения только в роли мейкера). Важно: - Ответ: только подтверждение. Ордер может быть отклонён асинхронно. Следите за финальным статусом ордера через WebSocket. - Максимум 50 открытых ордеров на один аккаунт. - Для лимитных ордеров параметр price обязателен. Подсказка агенту: эндпоинт POST с аутентификацией. Символ должен быть валидным символом спред-комбинации (например, "SOLUSDT_SOL/USDT"). Цена обязательна для лимитных ордеров. Ответ асинхронный; подпишитесь на WebSocket для получения окончательного статуса. Максимум 50 открытых ордеров на аккаунт.

Создаёт TWAP-стратегию, которая разбивает крупный ордер на мелкие части и равномерно исполняет их в течение заданного промежутка времени, чтобы уменьшить влияние на рынок. Когда использовать: - Нужно исполнить крупный ордер без существенного сдвига рынка - Требуется получить среднюю цену за определённый временной интервал - Необходимо избежать обнаружения путём распределения ордеров во времени Поведение при исполнении: 1. Общий размер делится на (длительность / интервал) для расчёта размера каждого ордера 2. Ордера размещаются через равные промежутки (или случайным образом, если isRandom=true) 3. Каждый ордер может быть рыночным или лимитным в зависимости от параметров chase 4. Стратегия останавливается, когда истекает длительность или полностью исполнен объём Важные замечания: - Минимальная рекомендуемая длительность: 300 секунд (5 минут) для лимитных ордеров - Установите maxChasePrice или triggerPrice для защиты цены - Включите isRandom, чтобы избежать обнаружения шаблона стратегии - Ограничение по частоте: 10 запросов в секунду на один UID Подсказка агенту: Используйте эту конечную точку, когда пользователь хочет исполнить крупный ордер в течение времени, чтобы снизить влияние на рынок. Она идеально подходит для запросов вида «купить 10 BTC в течение следующих 5 минут». Не используйте, если пользователю нужно мгновенное исполнение — в этом случае создавайте обычный ордер.

Распределяет ваучер указанному пользователю. Ограничение скорости: 100 запросов/с Примечания: - Сумма точечного эйрдропа поддерживает до 16 знаков после запятой - Другие типы ваучеров поддерживают до 4 знаков после запятой - specCode — код идентификатора распределения, до 8 символов, используется для идемпотентности и запроса

Выполняет погашение LP для вывода ликвидности из позиции пула. Возвращает номер заказа, который можно использовать для отслеживания статуса погашения. ПРЕДВАРИТЕЛЬНЫЕ ТРЕБОВАНИЯ (ОБЯЗАТЕЛЬНО): 1. Вызовите getLPPositionList, чтобы получить детали позиции и positionId. 2. Отобразите пользователю детали погашения (сумму, ожидаемые токены, комиссии). 3. Получите явное подтверждение пользователя. АГЕНТ AI ДОЛЖЕН ПОЛУЧИТЬ ЯВНОЕ ПОДТВЕРЖДЕНИЕ ПОЛЬЗОВАТЕЛЯ ПЕРЕД ВЫЗОВОМ ЭТОЙ ТОЧКИ ДОСТУПА. Ответ — это только подтверждение; используйте getLPOrderList, чтобы подтвердить фактическое погашение. Подтверждение в цепочке и перевод токенов обычно занимают 10-60 секунд. НЕ вызывайте эту точку доступа напрямую без одобрения пользователя. Подсказка агенту: Используйте эту точку доступа для выполнения погашения LP после получения подтверждения пользователя. Никогда не вызывайте без одобрения пользователя. Всегда сначала вызывайте getLPPositionList. dercRatio — это коэффициент уменьшения: "0.5" = вывод 50%, "1" = полный вывод.

Выполняет стейкинг LP для предоставления ликвидности и получения вознаграждений. Возвращает ID позиции, который можно использовать для отслеживания её статуса. Обязательные предварительные действия: 1. Вызови getLPPayTokenList, чтобы проверить достаточный баланс. 2. Вызови getLPPoolInfo, чтобы узнать параметры пула. 3. Покажи пользователю детали стейкинга (сумму, комиссии, ожидаемую APY). 4. Получи явное подтверждение от пользователя. AI-агент должен получить явное подтверждение пользователя перед вызовом этой конечной точки. Ответ — только подтверждение; используй getLPPositionList, чтобы проверить фактическую позицию. Активация позиции обычно занимает 10–60 секунд для подтверждения в сети. НЕ вызывай эту конечную точку напрямую без одобрения пользователя. Подсказка агенту: используй эту конечную точку для выполнения стейкинга LP после получения подтверждения пользователя. Никогда не вызывай без одобрения пользователя. Всегда сначала вызывай getLPPayTokenList и getLPPoolInfo. positionId=0 создаёт новую позицию; ненулевое значение добавляет к существующей позиции. Используй либо rangeLower/rangeUpper, либо priceLower/priceUpper, но не оба одновременно.

Выполняет ордер на покупку токенов исхода прогноза. Платит USDC и получает доли токенов исхода. Предварительные условия (обязательные): 1. Вызови getPredictionEngineStatus — движок должен быть доступен 2. Вызови getPredictionEventDetail — получи tokenId и убедись, что рынок открыт 3. Вызови getPredictionOrderEstimate — просмотри детали ордера 4. Покажи оценку пользователю и получи явное подтверждение НЕ вызывай этот endpoint без явного подтверждения пользователя. Фаза 1 поддерживает только orderType=1 (FOK). Ордер FOK, который не может быть полностью исполнен по текущей цене, будет целиком отменён. Используй slippage, чтобы задать допустимое отклонение цены (например, "0.05" = 5%). Ответ — только ACK (подтверждение получения). Проверь getPredictionOrderList для получения окончательного статуса исполнения. Подсказка агенту: перед вызовом требуется явное подтверждение пользователя. Всегда сначала вызывай getPredictionEngineStatus, getPredictionEventDetail и getPredictionOrderEstimate. Покажи пользователю детали оценки и дождись явного "да" перед продолжением. orderType=1 (FOK) — единственный поддерживаемый тип. slippage="0.05" означает допустимое изменение цены до 5%. Ответ — асинхронный ACK — проверяй getPredictionOrderList для реального результата исполнения.

Выполняет ордер на продажу токенов прогноза. Обменивает доли токенов на USDC. Обязательные предусловия: 1. Вызови getPredictionEngineStatus — движок должен быть доступен 2. Вызови getPredictionPositionList — убедись, что у пользователя есть доли токенов 3. Вызови getPredictionOrderEstimate — просмотри детали ордера на продажу 4. Покажи оценку пользователю и получи явное подтверждение НЕ вызывай этот эндпоинт без явного подтверждения пользователя. Phase 1 поддерживает только orderType=1 (FOK). Ордер FOK, который не может быть полностью исполнен, будет отменён целиком. Используй slippage, чтобы задать допуск по цене (например, "0.05" = 5%). Ответ — только ACK. Проверяй getPredictionOrderList для получения финального статуса исполнения. Подсказка агенту: ТРЕБУЕТ явного подтверждения пользователя перед вызовом. Всегда сначала вызывай getPredictionEngineStatus, getPredictionPositionList и getPredictionOrderEstimate. Покажи детали оценки пользователю и жди явного «да» перед продолжением. orderType=1 (FOK) — единственный поддерживаемый тип. size указывается в долях (не в USDC). Ответ — асинхронный ACK — проверяй getPredictionOrderList для получения фактического результата исполнения.

Размещает ордер на покупку токенов в сети с оплатой токенами-платежами. Возвращает orderNo, который можно использовать с getOrderList для отслеживания статуса ордера. Обязательные предварительные условия: 1. Сначала вызовите getTradeQuote, чтобы получить quoteData, correctingCode и gas 2. Покажите пользователю детали котировки (сумму, комиссии, проскальзывание) 3. Получите явное подтверждение пользователя AI-агент обязан получить явное подтверждение пользователя перед вызовом этой конечной точки. Ответ — только уведомление. Используйте getOrderList, чтобы подтвердить фактический статус ордера. Подтверждение в сети обычно занимает от 10 до 60 секунд. НЕ вызывайте эту конечную точку напрямую без действительной котировки. Все значения quoteData, correctingCode и gas должны быть получены из непросроченного ответа getTradeQuote. Подсказка агенту: используйте эту конечную точку для выполнения покупки после получения котировки и подтверждения пользователя. Никогда не вызывайте без одобрения пользователя. Всегда сначала вызывайте getTradeQuote. Не используйте для продажи — вместо этого вызывайте executeRedeem. Не угадывайте и не придумывайте значения quoteData/correctingCode — они должны быть из getTradeQuote.

Выполняет (принимает) котировку для начала многоногой сделки. Этот эндпоинт асинхронный — заявка отправляется в торговый движок. Чтобы подтвердить исполнение, проверьте эндпоинт Get Trade History или следите за веб-сокет-топиком Execution. Только создатель RFQ может выполнять котировки. Лимит запросов: 50 запросов в секунду. Подсказка агенту: Это асинхронный эндпоинт. После его вызова опрашивайте Get Trade History или слушайте Execution WebSocket, чтобы подтвердить, что сделка выполнена. Только создатель RFQ может выполнять котировки.

Размещает ордер на продажу для обмена ончейн-токенов на платежные токены. Возвращает orderNo, который можно использовать с getOrderList для отслеживания статуса ордера. Обязательные предварительные действия: 1. Сначала вызовите getTradeQuote, чтобы получить quoteData, correctingCode и gas 2. Покажите пользователю детали котировки (сумму, комиссии, проскальзывание) 3. Получите явное подтверждение от пользователя AI-агент должен получить явное подтверждение от пользователя перед вызовом этой конечной точки. Ответ — только подтверждение приема — используйте getOrderList для проверки фактического статуса ордера. Подтверждение в сети обычно занимает 10–60 секунд. НЕ вызывайте эту конечную точку без действующей котировки. Все значения quoteData, correctingCode и gas должны быть получены из неистекшего ответа getTradeQuote. Подсказка агенту: используйте эту конечную точку для исполнения сделки на продажу после получения котировки и подтверждения пользователя. Никогда не вызывайте без одобрения пользователя. Всегда сначала вызывайте getTradeQuote. НЕ используйте это для покупки — для этого используйте executePurchase. НЕ угадывайте и не выдумывайте значения quoteData/correctingCode — они должны быть получены из getTradeQuote.

Запрашивает режим маржи аккаунта, статус UTA, статус DCP и другую информацию о конфигурации.

Запрашивает спецификации торгуемых инструментов для аккаунта пользователя. Поддерживает спотовые, линейные (USDT/USDC бессрочные и фьючерсные) и инверсные контракты. Возвращает детали контракта, плечо, цены и фильтры размера лота. Ограничение скорости: 10 запросов/с Подсказка агенту: Используйте это для получения правил торговли перед размещением ордеров. Параметр category обязателен. Для линейных/инверсных используйте symbol для фильтрации по конкретному контракту. Структура ответа различается между спотовыми и линейными/инверсными категориями. Спот не поддерживает пагинацию.

Запрашивает доступный остаток для вывода по указанным монетам в Unified account.- Параметр coinName обязателен и принимает одно или несколько названий монет, разделённых запятыми (максимум 20 монет).- Возвращает доступную сумму для вывода по каждой запрошенной монете.

Запрашивает данные оповещений ADL (Auto-Deleveraging) и метрики страхового фонда для деривативных контрактов, указывая текущий уровень риска ADL и пороги активации. Используйте этот эндпоинт, когда вам нужно: - Отслеживать уровни риска ADL для конкретных символов контрактов в реальном времени - Проверять текущий баланс страхового фонда (balance) и коэффициент просадки PnL (pnlRatio) - Понимать пороги, при которых активируется ADL (insurancePnlRatio, adlTriggerThreshold) Поддерживаемые продукты: USDT Perpetual, USDT Delivery, USDC Perpetual, USDC Delivery, Inverse contract Данные обновляются каждую 1 минуту. Опустите symbol, чтобы получить данные по всем символам. Не используйте этот эндпоинт для общих балансов страхового пула. Используйте getInsurancePool. Примечания: - Данные обновляются каждую 1 минуту - Аутентификация не требуется Подсказка агенту: Используйте этот эндпоинт для мониторинга уровней риска ADL (Auto-Deleveraging) для символов контрактов. Опустите symbol, чтобы получить данные ADL по всем поддерживаемым символам. Высокий pnlRatio (более отрицательный, чем insurancePnlRatio) указывает на повышенный риск ADL. Для получения информации о балансе общего страхового пула используйте getInsurancePool.

Получает онлайн P2P-рекламу.

Запрашивает историю ваших заказов. Требует разрешения Earn на API-ключ. Ограничение частоты запросов: 10 запросов/с (UID)

Запрашивает ваши активные позиции. Требует разрешения Earn на API-ключе. Лимит запросов: 10 запросов/с (UID) Примечания DiscountBuy: Возвращает только активные/расчётные позиции (статус = Active или Settling). Параметр coin фильтрует по базовому активу (например, coin=BTC возвращает позиции с базовым активом BTC).

Запрашивает доступные списки продуктов Advance Earn. Аутентификация не требуется. Лимит запросов: 50 запросов/с (IP)

Получает котировки в реальном времени (целевые цены и APY) для конкретного продукта Dual Assets. Котировки поступают от институциональных маркет-мейкеров и часто обновляются (секундный уровень). Аутентификация не требуется. Ограничение скорости: 50 запросов/с (на IP) Совет: Для получения обновлений в реальном времени подпишитесь на WebSocket-канал earn.dualassets.offers вместо опроса этой конечной точки. Используйте эту конечную точку для начальной загрузки или как запасной вариант.

Запрашивает подробную информацию об указанном прямом клиенте партнёрского аккаунта, включая VIP-уровень, уровень KYC, диапазон баланса кошелька, торговый объём за 30/365 дней, сумму депозитов и комиссионные данные. Примечания: - Необходимо использовать API-ключ с разрешением affiliate, привязанный к Master UID. - uid — это Master UID прямого клиента, для которого выполняется запрос. - depositAmount30Day / depositAmount365Day обновляются каждые 5 минут. - Торговый объём охватывает три бизнес-линии: деривативы, опционы и спот. - Комиссионные данные приведены только для справки; обращайтесь к Партнёрскому порталу для получения точных цифр. - totalWalletBalance возвращает диапазон, а не точный баланс: - "1" → < 100 USDT - "2" → 100-500 USDT - "3" → 500-1000 USDT (или аналогичная категория) - "4" → > 500 USDT

Запрашивает список всех прямых клиентов текущего партнёрского аккаунта. Поддерживает курсорную пагинацию. Данные об объёме торгов, сумме депозита и комиссиях за 30 дней, 365 дней и произвольные диапазоны дат можно получить по запросу. Примечания: - Необходимо использовать API-ключ с разрешением affiliate, привязанный к Master UID. - Для параметра cursor передавайте "" или "0" в первом запросе; для последующих страниц передавайте значение nextPageCursor из предыдущего ответа. - need30, need365 и needDeposit по умолчанию равны false; включайте их по необходимости, чтобы избежать лишней нагрузки. - При указании startDate / endDate ответ включает поля для произвольного диапазона (takerVol, makerVol, tradeVol, tradfiTradeVol, commissionsVol) и опускает поля для 30/365 дней. - Карта комиссий всегда возвращает пять фиксированных валют: BTC, ETH, MNT, USDC, USDC.

Получает список P2P-ордеров. По умолчанию возвращает ордера за 90 дней. Ордера доступны за последние 180 дней.

Запрашивает подробную информацию о холдингах для конкретного токена по коду цепи и адресу токена. Возвращает количество, стоимость в USD, нереализованную прибыль/убыток, цену покупки и текущую рыночную цену. Результат содержит массив assetList из 0 или 1 элемента. Пустой assetList означает, что пользователь не владеет этим токеном или токен недоступен. Используйте chainCode и tokenAddress из ответа getAssetList или из getBizTokenList. НЕ ИСПОЛЬЗУЙТЕ этот эндпоинт для получения общих рыночных данных токена - используйте getBizTokenPriceList. НЕ ИСПОЛЬЗУЙТЕ для получения информации о проекте (описание, ссылки) - используйте getBizTokenDetails. Подсказка агенту: Используйте этот эндпоинт для получения подробной информации о холдингах конкретного токена, когда пользователь спрашивает о конкретном активе. Требует chainCode + tokenAddress - получите их из getAssetList или getBizTokenList. Ответ содержит массив assetList из 0 или 1 элемента. Пустой массив означает, что пользователь не владеет этим токеном. НЕ ИСПОЛЬЗУЙТЕ для общих рыночных данных - используйте getBizTokenPriceList. НЕ ИСПОЛЬЗУЙТЕ для информации о проекте токена - используйте getBizTokenDetails.

Запрашивает портфель токенов пользователя в сети. Возвращает общую стоимость портфеля в USD и отдельные активы с нереализованной прибылью/убытком, ценой покупки и текущей рыночной ценой. Возвращаются только токены с ненулевым балансом. Токены с нулевым балансом отфильтровываются. Используйте tradeFlag, чтобы узнать, можно ли продать токен через executeRedeem. Используйте tokenCode из ответа для запросов котировок и исполнения. Используйте chainCode + tokenAddress из ответа для вызова getAssetDetail и получения дополнительной информации. НЕ используйте этот эндпоинт для поиска новых токенов для покупки — вместо этого используйте getBizTokenList. НЕ используйте этот эндпоинт для получения рыночных данных по токенам, которых у вас нет — вместо этого используйте getBizTokenPriceList. Подсказка агенту: используйте этот эндпоинт, когда пользователь спрашивает о своих активах, балансе, портфеле, прибыли или убытках. Возвращает общую стоимость в USD и прибыль/убыток по каждому токену. Перед попыткой продажи проверьте tradeFlag. Используйте tokenCode из ответа для получения котировки и совершения сделки. НЕ используйте этот эндпоинт для поиска новых токенов — используйте getBizTokenList. НЕ используйте этот эндпоинт для рыночных данных по токенам, которых у вас нет — используйте getBizTokenPriceList.

Запрашивает общий обзор активов для текущего аккаунта, включая разбивку собственного капитала по типам аккаунтов, детали по категориям и детали на уровне монет. Примечания: - Этот эндпоинт требует аутентификации. - Поддерживает запрос родительского и дочернего аккаунта: если API-ключ принадлежит суб-аккаунту, родительский UID используется автоматически. - memberId можно указать для запроса активов конкретного суб-аккаунта. - Аккаунты с нулевым балансом отфильтровываются, за исключением типов аккаунтов UnifiedTradingAccount и FundingAccount (всегда возвращаются) или аккаунтов, явно переданных в параметре accountType. - Валюта оценки по умолчанию — USD, если не указана. - Для UnifiedTradingAccount активы DirectStocks объединяются в категорию STOCKS в рамках UTA (не возвращаются как отдельный тип аккаунта). - Для аккаунтов с isHaveProductType=true (Earn, TradingBot, CopyTrading, Alpha) ответ включает разбивку по categories. - Для типов аккаунтов CopyTrading и TradFi отрицательный собственный капитал считается нулевым при расчёте totalEquity. - Категории с нулевым капиталом и монеты с нулевым капиталом отфильтровываются из ответа.

Возвращает полную стратегию Aurora AI (параметры + метрики бэктестинга), идентифицированную по закодированному aurora_id, который ранее был возвращён одной из рекомендательных конечных точек. Лимит запросов: 20 запросов в секунду на UID на путь. Подсказка агенту: Используйте это, чтобы повторно получить стратегию Aurora, для которой у вас есть её aurora_id, например, чтобы обновить метрики бэктестинга или заново отобразить параметры. Если у вас ещё нет aurora_id, сначала вызовите одну из рекомендательных конечных точек (/v5/aurora/home, /v5/aurora/creation, /v5/aurora/explore, /v5/aurora/easy).

Получает базовую информацию об указанном ваучере, включая монету, единицу номинала, продуктовую линейку, общую сумму и распределённую сумму. Ограничение скорости: 50 запросов/с

Запрашивает подробную информацию о конкретном токене в сети. Возвращает описание проекта, ссылки на соцсети (Twitter, сайт, whitepaper), флаг риска, лимиты количества ордеров и статус токена. AI-агент вызывает этот инструмент, когда пользователь спрашивает о деталях конкретного токена, информации о проекте или статусе риска. Используйте chainCode и tokenAddress из ответа getBizTokenList или getAssetList. Когда showMessage=1, отображайте уведомление с content пользователю. Если переданы linkName и linkAddress, включите ссылку в уведомление. НЕ используйте этот эндпоинт для получения цен токенов — используйте getBizTokenPriceList. НЕ используйте его для просмотра доступных токенов — используйте getBizTokenList. Подсказка агенту: Используйте этот эндпоинт для получения детальной информации о токене, включая описание, сайт, Twitter, whitepaper и флаги риска. Требует chainCode + tokenAddress — получите их из getBizTokenList или getAssetList. Когда showMessage=1, отображайте пользователю уведомление с content. Не используйте для цен токенов — используйте getBizTokenPriceList. Не используйте для просмотра токенов — используйте getBizTokenList.

Запрашивает ончейн-токены, доступные для торговли, опционально отфильтрованные по тегу. Возвращает код токена в формате DEX_<id>, адрес контракта, флаг риска, лимиты объёма заказа и коды поддерживаемых платёжных токенов. Агент AI вызывает этот инструмент, когда пользователь хочет найти токены или выражает намерение купить, не указывая конкретный токен. Используйте tokenTag для фильтрации по категории. НЕ используйте эту конечную точку для получения цен токенов или рыночных данных - используйте getBizTokenPriceList. НЕ используйте её для получения балансов пользователя - используйте getAssetList. Подсказка агенту: Используйте эту конечную точку для поиска торгуемых ончейн-токенов и преобразования названий токенов в коды DEX-токенов. Вызывайте, когда пользователь спрашивает, какие токены доступны, или хочет просмотреть токены по категориям. Предупредите пользователя, если riskFlag=1, прежде чем продолжить сделку. НЕ используйте для получения цен - используйте getBizTokenPriceList.

Выполняет пакетный запрос цен токенов и рыночных данных по парам код сети + адрес токена. Возвращает текущую цену, изменение цены за 24 часа, объём торгов, рыночную капитализацию, ликвидность и количество держателей. Используйте chainCode и tokenAddress из getBizTokenList, getAssetList или ввода пользователя. НЕ используйте этот эндпоинт для поиска новых токенов — используйте getBizTokenList. НЕ используйте для получения информации о проекте токена (описание, ссылки) — используйте getBizTokenDetails. Подсказка агенту: Используйте этот эндпоинт для получения цен токенов, изменений за 24 часа, объёмов, рыночной капитализации и других рыночных данных. Принимает пары chainCode + tokenAddress — получайте их из getBizTokenList или getAssetList. НЕ используйте для поиска токенов — используйте getBizTokenList. НЕ используйте для информации о проекте — используйте getBizTokenDetails.

Получает записи о начисленных процентах, отсортированные в обратном порядке по времени создания. Поддерживает данные за период до 2 лет. Правила временного диапазона: - Если оба параметра startTime и endTime не указаны: возвращает последние 30 дней по умолчанию - Указан только startTime: возвращает период с startTime по startTime + 30 дней - Указан только endTime: возвращает период с endTime - 30 дней по endTime - Указаны оба: разница endTime - startTime должна быть ≤ 30 дней

Получает сообщения чата для P2P-заказа.

Запрашивает записи о прибылях и убытках по закрытым позициям пользователя. Результаты сортируются по createdTime в порядке убывания. - Единый аккаунт покрывает: бессрочные контракты USDT / контракты USDC Правила временного диапазона: - Без startTime и endTime: возвращает последние 7 дней по умолчанию - Только startTime: возвращает период с startTime до startTime + 7 дней - Только endTime: возвращает период с endTime - 7 дней до endTime - Оба указаны: endTime - startTime должно быть не больше 7 дней Хранение данных: до 2 лет

Запрашивает данные по закрытым опционным позициям, включая цены входа/выхода, комиссии, детали поставки и реализованный PnL. Применимо только к опционным контрактам. Подсказка агенту: используйте это для получения закрытых опционных позиций. Поддерживается только category=option. Диапазон времени по умолчанию: 24 часа. Максимальный диапазон на один запрос: 7 дней. Поддерживает историю до 6 месяцев. Возвращает цены входа/выхода, информацию о поставке, комиссии и реализованный PnL.

Запрашивает опционные греки, агрегированные по базовой монете. Возвращает дельту, гамму, вегу и тету для каждой базовой монеты с опционными позициями. Ограничение частоты запросов: 10 запросов/с. Подсказка агенту: Используйте это для управления опционными рисками. Передайте baseCoin для фильтрации (например, BTC, ETH, SOL). Если параметр опущен, возвращает греки для всех базовых монет. Все значения греков возвращаются в виде строковых чисел.

Получает информацию о залоге текущего единого маржинального счета, включая процентную ставку по займу, доступную сумму займа, коэффициент конвертации залога, возможность использования в качестве маржи и т.д.

Получает подробные сведения о конкретном фьючерсном комбо-боте, включая конфигурацию (символы, кредитное плечо, режим ребалансировки), текущий статус отображения, показатели PnL (общий PnL, реализованный, нереализованный, комиссия за фондирование), информацию о позициях портфеля, маржинальные балансы (общий, доступный, маржинальный баланс) и временные метки. bot_id — это числовой идентификатор, полученный из createComboBot или из конечных точек списка ботов. Ограничение скорости: 10 запросов в секунду на один UID. Подсказка агенту: Используйте эту конечную точку для проверки статуса и производительности комбо-бота. Ответ содержит все поля PnL, детали позиций, статистику ребалансировки и причину закрытия, если бот остановлен. Отдавайте предпочтение этой конечной точке перед другими при ответах на вопросы о производительности конкретного бота.

Проверяет входные параметры для создания комбо-бота фьючерсов и возвращает допустимые диапазоны для каждого параметра (начальная маржа, кредитное плечо, порог ребалансировки, временной интервал, проценты TP/SL, трейлинг-стоп). Используйте этот эндпоинт перед вызовом /v5/fcombobot/create, чтобы убедиться, что параметры находятся в допустимых границах. В ответе содержится check_code, который указывает, какой параметр выходит за диапазон, если валидация не пройдена. Ограничение скорости: 10 запросов в секунду на один UID. Подсказка агенту: сначала вызовите этот эндпоинт, чтобы получить допустимые диапазоны параметров перед созданием комбо-бота. Если check_code не равен нулю, код указывает на конкретную ошибку валидации. Диапазоны в ответе (init_margin, leverage, sl_percent, tp_percent и т.д.) показывают точные минимальные и максимальные значения для каждого параметра.

Получает курируемый лидерборд Copy Trading Classic для потоков рекомендаций в диалоговом режиме. Эндпоинт возвращает ранжированный список кандидатов-лидеров. Возвращаемый порядок — это предполагаемый порядок отображения, и его следует сохранять, когда вызывающий показывает список пользователю. Подсказка агенту: Если пользователь запрашивает надежного копи-трейдера или аналогичную рекомендацию, вызовите одновременно эндпоинт лидерборда Copy Trading Classic и эндпоинт лидерборда Copy Trading TradFi. Представьте два возвращенных списка отдельно, например под заголовками Classic и TradFi, и пронумеруйте каждый список по порядку с помощью 1., 2., 3.. Сравните кандидатов из обоих списков, используя возвращаемые метрики: доходность за 30 дней, максимальную просадку за 30 дней и коэффициент Шарпа за 30 дней, затем порекомендуйте одного кандидата как лучшего на текущий момент с кратким обоснованием. Дайте пользователю выбрать, ответив индексом с указанием продукта, например Classic 1 или TradFi 3. Если пользователь выбирает кандидата из Classic, сопоставьте выбранный индекс с соответствующим leaderMark, затем запросите сумму для копирования и вызовите эндпоинт привязки Copy Trading Classic. Не просите пользователя повторять или перепечатывать leaderMark. После успешной привязки ответьте на текущем языке диалога пользователя сообщением об успехе, означающим, что путешествие пользователя в копи-трейдинг началось, он может в любое время зайти в CopyTrading Trading Hub для персонализированного управления, и в будущем AI откроет ещё более интеллектуальные возможности копи-трейдинга. Пример на английском: Your copy trading journey has successfully begun. You can visit the [CopyTrading Trading Hub] at any time for personalized management. In the future, AI will unlock even more intelligent copy trading capabilities for you. Wishing you success!

Получает кураторскую таблицу лидеров Copy Trading TradFi для потоков рекомендаций в диалогах. Конечная точка возвращает ранжированный список поставщиков-кандидатов. Возвращённый порядок — это предполагаемый порядок отображения, и его следует сохранять, когда вызывающая сторона показывает список пользователю. Подсказка агенту: если пользователь просит надёжного копитрейдера или аналогичную рекомендацию, вызовите обе конечные точки: таблицу лидеров Copy Trading Classic и эту таблицу лидеров Copy Trading TradFi. Покажите два возвращённых списка по отдельности, например, как Classic и TradFi, и пронумеруйте каждый список по порядку с помощью 1., 2., 3.. Сравните кандидатов из обоих списков, используя возвращённые показатели: доходность за 30 дней, максимальную просадку за 30 дней и коэффициент Шарпа за 30 дней. Затем порекомендуйте одного кандидата как лучшего на данный момент с кратким обоснованием. Дайте пользователю выбрать, ответив индексом, квалифицированным по продукту, например Classic 1 или TradFi 3. Если пользователь выбирает кандидата TradFi, сопоставьте выбранный индекс обратно с соответствующим providerMark, затем спросите сумму следования и вызовите конечную точку привязки Copy Trading TradFi. Не просите пользователя повторять или вводить заново providerMark. После успешной привязки ответьте на текущем языке общения пользователя сообщением об успехе, означающим, что путешествие пользователя в копитрейдинге началось, он может в любое время зайти в Copytrading Trading Hub для персонализированного управления, и в будущем AI откроет ещё более интеллектуальные возможности копитрейдинга. Пример на русском: Ваше путешествие в копитрейдинг успешно началось. Вы можете в любое время зайти в [Copytrading Trading Hub] для персонализированного управления. В будущем AI откроет для вас ещё более интеллектуальные возможности копитрейдинга. Желаем вам успешных инвестиций!

Получает информацию о пользователе-контрагенте в конкретном заказе. Подсказка агенту: Запрашивай только контрагента текущего активного заказа. НЕ перечисляй произвольные UID и не вызывай это в цикле — это раскрывает PII посторонних пользователей.

Запрашивает исторические операции корректировки залога с поддержкой постраничного вывода. Features: - Приватная конечная точка (требуется аутентификация) - Запрос по конкретному adjustId или фильтр по валюте - Поддержка постраничного вывода с навигацией на основе курсора - Показывает LTV до и после для каждой корректировки - Отслеживает статус корректировки (processing, success, failed) - Лимит запросов: 5 запросов за временной интервал на UID Use Cases: - Просмотр прошлых корректировок залога - Отслеживание изменений LTV со временем - Проверка операций корректировки - Аудит действий по управлению залогом Query Modes: - По adjustId: получает конкретную корректировку (без постраничного вывода) - По валюте: получает все корректировки для валюты (с постраничным выводом) - Все корректировки: получает полную историю (с постраничным выводом)

Запрашивает информацию о валютах, доступных в качестве залога в системе криптокредитования. Особенности: - Публичная конечная точка (аутентификация не требуется) - Запрашивает информацию по конкретной валюте или возвращает все залоговые валюты - Возвращает порядок ликвидации для каждой валюты - Возвращает уровни коэффициентов залога в зависимости от стоимости в долларах США - Ограничение скорости: 1000 запросов за временной интервал Сценарии использования: - Проверить, можно ли использовать валюту в качестве залога - Просмотреть приоритет ликвидации для валют - Получить коэффициенты залога для разных уровней стоимости залога - Оценить параметры риска перед внесением активов в залог

Запрашивает информацию о валютах, доступных для займа в системе криптокредитования. Возможности: - Публичный endpoint (авторизация не требуется) - Запрос по конкретной валюте или получение всех доступных для займа валют - Фильтрация по VIP-уровню для просмотра доступных ставок и лимитов - Поддерживает как гибкие (почасовая ставка), так и срочные (7-180 дней) займы - Лимит запросов: 1000 запросов за временное окно Примеры использования: - Проверить, доступна ли валюта для гибкого или срочного займа - Просмотреть процентные ставки для разных VIP-уровней - Получить минимальную/максимальную сумму займа - Сравнить рыночные ставки

Запрашивает максимальную сумму залога, которую можно вывести (погасить) для конкретной валюты. Возможности: - Приватная конечная точка (требуется аутентификация) - Рассчитывает безопасную сумму вывода, сохраняющую здоровый LTV - Предотвращает случайную ликвидацию, показывая максимальный безопасный вывод - Ограничение скорости: 5 запросов за временное окно на UID Сценарии использования: - Проверить, сколько залога можно безопасно вывести - Убедиться, что после вывода остаётся достаточное обеспечение - Предотвратить ликвидацию, проверяя суммы вывода Важно: - Возвращает 0, если вывод любой суммы приведёт к ликвидации - Сумма рассчитывается так, чтобы LTV оставался ниже

Запрашивает текущую позицию пользователя по криптокредиту с подробными деталями. Возможности: - Частная конечная точка (требуется аутентификация) - Получение общих метрик позиции (LTV, общая задолженность, общее обеспечение) - Просмотр детальной разбивки заимствований по валютам - Просмотр разбивки обеспечения по валютам - Просмотр разбивки поставок (кредитования) по валютам - Отдельная информация о задолженности с гибким и фиксированным сроком - Ограничение скорости: 5 запросов за временной интервал на UID Варианты использования: - Мониторинг текущего коэффициента LTV и риска ликвидации - Просмотр общей задолженности и стоимости обеспечения - Отслеживание заимствований в нескольких валютах - Обзор распределения обеспечения - Проверка позиций кредитования - Оценка общего состояния портфеля Важно: - Возвращает пустую позицию, если у пользователя нет активных займов - Все значения в долларах США рассчитываются по ценам в реальном времени - Гибкая и срочная задолженность отслеживаются отдельно

Запрашивает доступный запас пула кредитования для фиксированного срочного займа. Правила: - Разрешает запрашивать только монеты, поддерживаемые фиксированным срочным крипто-займом - Запрашиваемая монета должна существовать - Имя монеты должно быть в верхнем регистре - Доступный запас = min(рыночный доступный + финансовый триал (50M), оставшийся лимит заимствования пользователя) - Точность: точность заимствования, округление вниз - Финансовый триал также должен соответствовать требованию к финансовой ставке: запрашиваемая ставка >= финансовая ставка

Запрашивает активные контракты займа (займы). Лимит запросов: 5 запросов на UID.

Запрашивает детали и историю ордера на заимствование. Лимит запросов: 5 запросов на UID

Запрашивает доступные ордера на поставку (предложения по кредитованию) с рынка для конкретной валюты и срока. Особенности: - Публичный эндпоинт (аутентификация не требуется) - Просматривает доступные предложения по кредитованию перед размещением ордера на заимствование - Сортирует по ставке или сумме - Фильтрует по валюте и сроку - Ограничение по запросам: 1000 запросов за временной интервал Сценарии использования: - Проверяет доступные ставки перед заимствованием - Находит лучшие предложения по кредитованию на рынке - Сравнивает ставки на разные сроки Важно: - Результаты показывают фактические ордера на поставку от кредиторов - Ставки могут меняться по мере исполнения ордеров - Используйте эти ставки при размещении ордеров на заимствование

Запрашивает историю и информацию о продлении займа. Лимит запросов: 5 запросов на UID

Запрашивает записи о погашении кредитов. Лимит запросов: 5 запросов на UID

Запрашивает активные контракты поставки (позиции кредитования). Ограничение скорости: 5 запросов на UID

Запрашивает детали и историю ордеров поставки (кредитования). Ограничение частоты: 5 запросов на UID.

Запрашивает доступные ордера займа (спрос) на рынке.

Запрашивает доступный запас пула кредитования для гибкого займа. Правила: - Разрешает запрашивать только монеты, поддерживаемые гибким крипто-займом - Запрашиваемая монета должна существовать - Имя монеты должно быть ЗАГЛАВНЫМИ буквами - Доступный запас = min(общая сумма кредитования платформы, оставшийся лимит заимствования пользователя) - Точность: точность заимствования

Запрашивает исторические записи гибкого займа с постраничной разбивкой. Возможности: - Запрос по ID ордера или валюте - Поддержка постраничной навигации - Просмотр деталей и статуса займа - Лимит запросов: 5 запросов на UID

Запрашивает текущие позиции гибкого заимствования по валюте. Возможности: - Просматривает текущий долг и проценты - Проверяет почасовую процентную ставку - Отслеживает накопленные проценты - Ограничение скорости: 5 запросов на UID Сценарии использования: - Проверяет текущую сумму долга - Отслеживает накопление процентов - Рассчитывает сумму погашения

Запрашивает исторические записи гибких погашений с пагинацией. Возможности: - Запрос по ID погашения или валюте - Поддержка пагинации - Просмотр деталей погашения, включая основную сумму и проценты - Лимит запросов: 5 запросов на UID Сценарии использования: - Отслеживание истории погашений - Проверка транзакций погашения - Расчет общей суммы процентов

Запрашивает конфигурацию защиты от отключения (DCP). Возвращает статус DCP и временное окно для каждого типа продукта. Должен быть предварительно авторизован менеджером аккаунта. Лимит запросов: 10 запросов/с Подсказка агенту: Используйте это для проверки настроек DCP. Параметры не требуются. Возвращает массив конфигураций DCP на уровне продуктов со статусом и временным окном. Работает только для учетных записей, у которых DCP включен их менеджером аккаунта. Пустой результат означает, что DCP не настроен.

Получает исторические цены поставки (расчётные цены) для истекших фьючерсных и опционных контрактов, включая финальную расчётную цену и временную метку поставки. Используйте эту конечную точку, когда вам нужно: - Узнать расчётную цену конкретного истекшего фьючерсного или опционного контракта - Проанализировать исторические цены поставки для исследований или сверки PnL - Получить постраничные записи поставок по нескольким истекшим контрактам Поддерживаемые продукты: USDT фьючерсы, USDC фьючерсы, Inverse фьючерсы, Опционы Поддерживает курсорную пагинацию через nextPageCursor. Не используйте эту конечную точку для предстоящих дат поставки - используйте getInstrumentsInfo, который включает deliveryTime для активных контрактов. Примечания: - Поддерживает курсорную пагинацию - Аутентификация не требуется Подсказка агенту: Используйте эту конечную точку для поиска исторических расчётных цен по истекшим фьючерсам и опционам. Для опционных запросов baseCoin по умолчанию равен BTC. Используйте category для фильтрации типа продукта. Для получения времени поставки активных (ещё не истекших) контрактов используйте getInstrumentsInfo. Используйте nextPageCursor из ответа для пагинации.

Запрашивает записи поставок USDC фьючерсов, Inverse фьючерсов и Опционов. - Единый счет включает: USDT фьючерсы / USDC контракты / Inverse фьючерсы / Опционы - Классический счет включает: Inverse фьючерсы Правила временного диапазона: - Без обоих startTime и endTime: по умолчанию возвращает последние 30 дней - Указан только startTime: возвращает от startTime до startTime + 30 дней - Указан только endTime: возвращает от endTime - 30 дней до endTime - Указаны оба: endTime - startTime должно быть ≤ 30 дней

Запрашивает записи распределения ваучеров для указанного пользователя, включая статус получения, срок действия, израсходованную сумму и т.д. Лимит запросов: 50 запросов/с.

Запрашивает кредитное плечо для продукта Double Win RFQ с выбранным пользователем диапазоном цен.Применим только для продуктов RFQ (isRfqProduct=true). Для продуктов с фиксированным диапазоном получайте кредитное плечо из Get Product Extra Info или темы WebSocket earn.doublewin.offers. Требует разрешения Earn для ключа API. Ограничение частоты: 1 запрос/с (UID) Примечания: - lowerPrice и upperPrice должны удовлетворять условию: lowerPrice < initialPrice < upperPrice - Обе цены должны быть точными кратными priceTickSize (из Get Product Info) - Возвращаемые значения leverage и expireTime используются при размещении ордера Stake - Ордер должен быть размещён до expireTime; после истечения срока выполните повторный запрос к этой конечной точке

Запрашивает историческую дневную APR для продукта. Поддерживает FlexibleSaving и OnChain. FlexibleSaving: Возвращает почасовые записи APR. OnChain: Возвращает дневные записи APR. Результаты возвращаются в порядке убывания по дате/времени. Максимальный диапазон запроса - 182 дня. Аутентификация необязательна (публичный endpoint).

Запрашивает почасовые детали доходности. Поддерживает только FlexibleSaving. - Максимальный диапазон запроса - 7 дней

Запрашивает историю ордеров на стейкинг/выкуп. - По умолчанию возвращает данные за последние 7 дней; максимальный диапазон запроса - 7 дней - Поддерживает запрос по типу ордера

Запрашивает информацию о текущей позиции стейкинга. - Flexible saving yield накапливается ежечасно и распределяется ежедневно в UTC 00:30.

Запрашивает информацию о продукте Earn, включая примерную APR, минимальную/максимальную сумму стейкинга, статус продукта и т.д. Аутентификация не требуется.

Запрашивает историю доходности. Поддерживает FlexibleSaving и OnChain.

Запрашивает многоуровневую структуру комиссий для клиентов уровней Pro и Market Maker, сгруппированную по группам символов, включая ставки комиссий тейкера/мейкера и рибейты мейкера для каждого уровня клиента. Используйте этот эндпоинт, когда нужно: - Найти ставки комиссий, применимые к конкретному ID группы для клиентов Pro или Market Maker - Понять, какие символы относятся к какой группе комиссий (например, G1 для основных монет) - Сравнить ставки комиссий тейкера/мейкера и рибейты мейкера по уровням Pro (Pro 1–6) или MM (MM 1–3) Возвращает список групп комиссий, каждая со своим списком символов и таблицей ставок комиссий. Примечания: - Применяется только для клиентов уровней Pro и Market Maker - productType=contract — единственное поддерживаемое значение - Аутентификация не требуется Подсказка для агента: Используйте этот эндпоинт, чтобы получить структуру групп комиссий для клиентов Pro или Market Maker. productType обязателен (поддерживается только "contract"). Опционально можно отфильтровать по groupId (1–8). Этот эндпоинт актуален только для аккаунтов уровня Pro или Market Maker. Для получения ставок комиссий стандартных аккаунтов вместо этого используйте эндпоинт Account getFeeRate.

Запрашивает ставки комиссии maker и taker для указанной категории продукта. Можно фильтровать по symbol (спот/линейные/инверсные) или baseCoin (только опционы). Ограничение скорости: 10 запросов/с Подсказка агенту: используйте для проверки ставок комиссии перед торговлей. Параметр category обязателен. Используйте symbol для фильтрации по споту/линейным/инверсным. Используйте baseCoin для опционов (например, BTC, ETH, SOL). Ставки комиссии возвращаются в виде десятичных строк (например, "0.0006" = 0.06%).

Получает полные сведения о конкретном фьючерсном грид-боте, включая конфигурацию (символ, ценовой диапазон, кредитное плечо, тип сетки), текущий статус, метрики PnL (реализованная и нереализованная прибыль, прибыль по сетке, комиссия за фондирование), информацию о позиции, балансы маржи и временные метки. bot_id — это числовой идентификатор, полученный из createFGridBot или эндпоинтов списка ботов. Ограничение частоты: 10 запросов в секунду на один UID. Подсказка агенту: используйте этот эндпоинт для проверки статуса и производительности грид-бота. В ответе содержатся все поля PnL, детали позиции и причина остановки, если бот остановлен. Отдавайте предпочтение этому эндпоинту перед другими при ответах на вопросы о производительности конкретного бота.

Запрашивает историю заказов с фиксированным сроком. Поддерживает курсорную пагинацию. Примечания: - При запросе по productId также необходимо указать category - Если не указан orderType, возвращаются все типы заказов Лимит запросов: 10 запросов/с

Запрашивает информацию о текущей должности с фиксированным сроком. Лимит запросов: 10 req/s

Запрашивает информацию о продукте с фиксированным сроком, включая ступенчатую APY, минимальную/максимальную сумму стейкинга, статус продукта и т. д. Аутентификация не требуется. Ограничение скорости: 50 запр./с (на IP).

Получает подробную информацию для конкретного фьючерсного Martingale-бота, включая конфигурацию (символ, режим, плечо, триггер цены, настройки добавления позиции), текущий статус отображения, метрики PnL (реализованная, нереализованная, общая), информацию о позиции (размер, средняя цена, балансы), прогресс раунда (завершённые раунды, текущий раунд, текущие добавления), маржинальные балансы и временные метки. Идентификатор bot_id — это числовой ID, полученный из createFMartBot или из endpoint'ов для вывода списка ботов. Лимит запросов: 10 запросов в секунду на один UID. Подсказка агенту: используйте этот endpoint для проверки состояния и производительности Martingale-бота. Ответ содержит все поля PnL, детали позиции, прогресс раунда (completed_rounds, current_round, current_added_pos_num) и причину закрытия, если бот остановлен. Отдавайте предпочтение этому endpoint перед другими при ответе на вопросы о состоянии и производительности конкретного бота.

Проверяет входные параметры для создания фьючерсного Martingale-бота и возвращает допустимые диапазоны для каждого параметра (процент плавающей цены, коэффициент добавления позиции, количество добавлений позиции, начальная маржа, процент TP раунда, стоп-лосс, цена входа, кредитное плечо). Используйте эту конечную точку перед вызовом /v5/fmartingalebot/create, чтобы убедиться, что параметры находятся в допустимых пределах. Ответ содержит check_code, который указывает, какой параметр выходит за границы диапазона, если проверка не пройдена. Ограничение частоты: 100 запросов в секунду на IP. Подсказка агенту: сначала вызовите эту конечную точку, чтобы получить допустимые диапазоны параметров перед созданием Martingale-бота. Если check_code не равен нулю, конкретная ошибка проверки указывается значением кода. Диапазоны в ответе показывают точные минимальные и максимальные значения, допустимые для каждого параметра.

Запрашивает исторические записи ставок финансирования для бессрочных контрактов. У каждого символа свой интервал расчёта финансирования (обычно каждые 4 или 8 часов). Используйте этот эндпоинт, если вам нужно: - Проанализировать исторические тенденции ставок финансирования для конкретного бессрочного контракта - Рассчитать общие расходы или доход от финансирования для позиции за определённый период времени - Сравнить ставки финансирования по разным символам или временным периодам Поддерживаемые продукты: USDT-контракт, Inverse-контракт Записи отсортированы в обратном хронологическом порядке. Используйте startTime и endTime (в миллисекундах) для фильтрации по определённому диапазону времени. Не используйте этот эндпоинт для получения текущей ставки финансирования — используйте getTickers, который включает fundingRate и nextFundingTime в свой ответ. Примечания: - Аутентификация не требуется Подсказка агенту: Используйте этот эндпоинт для получения исторических ставок финансирования для бессрочного контракта. Параметры category и symbol обязательны. Укажите startTime и endTime (в миллисекундах), чтобы сузить временной диапазон. Для получения текущей ставки финансирования и времени следующего финансирования используйте getTickers.

Запрашивает исторические данные по ставкам заимствования для UTA спотовой маржи. - Требует API-ключ с разрешением Spot. - startTime и endTime должны передаваться вместе. Максимальный интервал — 30 дней. - Если оба опущены, по умолчанию берутся последние 7 дней. - Данные доступны за последние 6 месяцев. Подсказка агенту: аутентифицированный эндпоинт (требуется разрешение Spot). Возвращает исторические почасовые ставки заимствования для определенной монеты и VIP-уровня. Параметр currency обязателен. Если vipLevel опущен, используется текущий VIP-уровень учетной записи. startTime/endTime должны использоваться вместе (максимальное окно — 30 дней); если опущены, по умолчанию берутся последние 7 дней. Примечание: "No VIP" должно быть URL-закодировано как "No%20VIP".

Запрашивает исторические данные по подразумеваемой волатильности для опционов с часовой детализацией. Возвращает рассчитанный Bybit индекс исторической волатильности для указанной базовой монеты. Используйте эту конечную точку, когда вам нужно: - Исследовать исторические тренды подразумеваемой волатильности для торговли опционами или управления рисками - Сравнивать волатильность по разным периодам усреднения (например, 7-дневный и 30-дневный) - Получать до 2 лет почасовых данных по волатильности для бэктестинга или анализа Поддерживаемые продукты: Только опционы startTime и endTime должны быть указаны вместе или оба опущены (по умолчанию — последний 1 час). Максимальный диапазон запроса за один раз — 30 дней. Не используйте эту конечную точку для текущей подразумеваемой волатильности — используйте getTickers с category=option, который включает markIv, bid1Iv и ask1Iv для конкретных контрактов. Примечания: - По умолчанию возвращает данные за последний 1 час - Максимальный диапазон запроса за один раз — 30 дней - startTime и endTime должны быть указаны вместе или опущены вместе - Аутентификация не требуется Подсказка агенту: Используйте эту конечную точку для получения исторической подразумеваемой волатильности по опционам (часовая детализация). category должно быть "option". baseCoin по умолчанию BTC, если опущено. Для текущей подразумеваемой волатильности конкретных контрактов используйте getTickers с category=option. startTime и endTime должны быть указаны вместе или опущены; максимальный диапазон — 30 дней за запрос.

Запрашивает доступные списки продуктов Hold-to-Earn. Аутентификация не требуется.

Запрашивает историю распределения доходности по продуктам Hold-to-Earn. Требует разрешение Earn для ключа API. Результаты сортируются по дате распределения от новых к старым. Пагинация: на основе курсора. Пропустите cursor в первом запросе; передайте nextCursor из предыдущего ответа для последующих страниц. Пустой nextCursor в ответе обозначает последнюю страницу.

Получает компоненты бирж и торговые пары, из которых состоит индексная цена Bybit, включая их индивидуальные веса, текущие цены и множители. Используйте этот эндпоинт, когда нужно: - Узнать, какие биржи и спотовые пары влияют на индексную цену Bybit - Выяснить, почему индексная цена отличается от цен на отдельных спотовых рынках - Изучить состав и методологию расчёта весов конкретного индекса Возвращает indexName, lastPrice, updateTime и массив components с деталями по каждой бирже. Не используйте этот эндпоинт только для получения значения индексной цены — для этого есть getTickers, который включает indexPrice. Примечания: - Аутентификация не требуется Подсказка для агента: используйте этот эндпоинт, чтобы изучить состав индексной цены Bybit. indexName обязателен (например, BTCUSDT, ETHUSDT). Возвращает, какие биржи участвуют в расчёте и с какими весами. Для получения только текущего значения индексной цены используйте getTickers, который включает indexPrice. TradFi: используйте для проверки состава эталонной цены товарных бессрочных контрактов — indexName=XAUUSDT (золото), XAGUSDT (серебро), CLUSDT (сырая нефть). Недоступно для токенов xStock (например, TSLAXUSDT).

Запрашивает исторические свечи цены индекса, полученные из составной спотовой цены на нескольких биржах. Используйте этот эндпоинт, когда вам нужно: - Проанализировать исторические движения цены индекса для исследований или бэктестинга - Сравнить цену индекса и цену маркировки, чтобы понять базисный спред с течением времени - Построить графики базовой спотовой цены рынка, используемой Bybit в качестве референса Поддерживаемые продукты: контракты USDT, контракты USDC, инверсные контракты Каждая запись свечи содержит массив из 5 элементов: [startTime, open, high, low, close]. Данные возвращаются в обратном хронологическом порядке (сначала самые новые). Не используйте этот эндпоинт для торговых свечей цены: используйте getMarketKline. Не используйте этот эндпоинт для свечей цены маркировки: используйте getMarkPriceKline. Примечания: - Данные возвращаются в обратном хронологическом порядке (сначала самые новые) - Аутентификация не требуется Подсказка агенту: используйте этот эндпоинт для получения исторических свечей цены индекса (составная спотовая цена является эталоном). Для обычных торговых свечей OHLCV используйте getMarketKline. Для свечей цены маркировки используйте getMarkPriceKline. Для свечей премиум-индекса (ставка финансирования) используйте getPremiumIndexKline.

Запрашивает спецификации инструментов для активных торговых пар на спотовом рынке, контрактах USDT, контрактах USDC, инверсных контрактах и рынках опционов, включая точность цены, лимиты количества, диапазоны кредитного плеча и детали контрактов. Используйте эту конечную точку, когда вам нужно: - Узнать доступные торговые пары и их текущий status торговли - Получить tickSize, minOrderQty, maxOrderQty для проверки ордера перед размещением - Получить диапазон фильтра кредитного плеча (minLeverage, maxLeverage) для контракта - Проверить deliveryTime для информации об истечении фьючерсов/опционов Схема ответа различается в зависимости от category. Поддерживает курсорную пагинацию через nextPageCursor. Не используйте эту конечную точку для данных о ценах в реальном времени — используйте getTickers. Примечания: - Схема ответа различается в зависимости от category; смотрите определения схем для подробностей - Поддерживает курсорную пагинацию - Аутентификация не требуется Подсказка агенту: используйте эту конечную точку для обнаружения торговых пар и их ограничений перед созданием ордеров. Вызывайте её, чтобы получить tickSize, minOrderQty и maxOrderQty для символа. Не используйте её для цен в реальном времени — используйте getTickers для текущей цены и статистики за 24 часа. Для пагинации передавайте nextPageCursor из предыдущего ответа в параметр cursor. Поиск TradFi: используйте symbolType=xstocks (category=spot) для токенизированных акций (например, TSLAXUSDT), symbolType=stock (category=linear) для бессрочных контрактов на акции (например, TSLAPUSDT), или symbolType=commodity (category=linear) для бессрочных контрактов на металлы/нефть (например, XAUUSDT=золото, XAGUSDT=серебро, CLUSDT=сырая нефть). Всегда вызывайте этот endpoint, чтобы подтвердить точный символ перед первой сделкой TradFi в сессии.

Запрашивает балансы страхового пула Bybit и их эквиваленты в долларах США для разных расчётных монет. Страховой фонд покрывает убытки от ликвидаций, чтобы предотвратить автоматическое делевереджирование (ADL). Используйте этот эндпоинт, когда нужно: - Отслеживать состояние страхового фонда для конкретной монеты (BTC, USDT, USDC и т.д.) - Понимать, какие контракты используют общий пул, а какие — изолированный - Проверить текущий баланс пула как индикатор риска для рынков деривативов Возвращает все страховые монеты, если параметр coin опущен. Не используйте этот эндпоинт для получения порогов ADL — для этого применяйте getAdlAlert. Примечания: - Изолированный пул обновляется каждую минуту - Общий пул обновляется ежедневно - Аутентификация не требуется Подсказка агенту: используйте этот эндпоинт, чтобы проверить балансы страхового пула Bybit для расчётных монет. Опустите coin, чтобы получить все монеты; укажите конкретную монету (например, USDT, BTC) для уточнённого результата. Для получения подробностей о порогах ADL и коэффициенте PnL используйте getAdlAlert.

Возвращает постраничный список активностей Launchpool, отфильтрованный по статусу.Опционально сужает результаты по монете активности или коду проекта.Каждый элемент включает массив pools с APR и суммами стейкинга на пул. Подсказка агенту: Используйте этот эндпоинт для просмотра активностей Launchpool по статусу. Фильтруйте по activityCoin, чтобы найти пулы для конкретной монеты. У каждого проекта несколько пулов с разными вариантами stakeCoin. Используйте cursor + limit для постраничной навигации.

Возвращает историю операций стейкинга авторизованного пользователя в Launchpool, с разбивкой по страницам. Фильтрация по монете, типу операции, статусу записи и временному диапазону. AI-агент может использовать эту информацию, чтобы показать пользователю историю его стейкинг-транзакций или исследовать конкретные типы операций, такие как пополнения или выводы. Подсказка агенту: Используйте эту конечную точку для получения истории операций стейкинга пользователя. Фильтруйте по типу, чтобы сосредоточиться на конкретной операции (например, type=0 для пополнений, type=1 для ручных выводов, type=2 для начислений процентов). startTime и endTime должны передаваться вместе как 13-значные метки времени в миллисекундах.

Возвращает активные стейкинг-позиции авторизованного пользователя в Launchpool, включая сводку портфеля в долларах США и детали по каждой позиции (сумма стейка, накопленное вознаграждение, дата авто-выкупа). AI-агент может использовать этот метод, чтобы показать пользователю его текущий стейкинг-портфель на одном экране. Подсказка агенту: используйте эту конечную точку, чтобы показать пользователю его текущую сводку по стейкингу. totalInvestmentUsd, totalEarningsUsd и todayEarningsUsd дают быстрый снимок портфеля. Список даёт детали по каждой позиции, включая дату авто-выкупа.

Возвращает завершённые позиции стейкинга Launchpool аутентифицированного пользователя, суммируя общее вознаграждение по каждой позиции. Фильтрует по монете стейкинга, монете вознаграждения и временному интервалу стейкинга. AI-агент использует этот эндпоинт, чтобы показать пользователю его прошлое участие и общее вознаграждение по завершённым активностям Launchpool. Подсказка агенту: Используйте этот эндпоинт для получения исторических позиций Launchpool пользователя. Каждая запись представляет одну завершённую позицию стейкинга с итоговым вознаграждением. startTime/endTime фильтруют по периоду стейкинга (не по дате создания записи) и должны передаваться вместе как 13-значные временные метки в миллисекундах.

Запрашивает записи о ликвидациях для позиций Liquidity Mining с пагинацией на основе курсора. Ограничение скорости: 10 запросов/с

Запрашивает историю ордеров Liquidity Mining с курсорной пагинацией. Этот эндпоинт также используется для получения деталей одного ордера. - Передайте только orderId или orderLinkId, чтобы получить один ордер (остальные фильтры игнорируются; ордера со статусом Pending видны) - Без orderId/orderLinkId возвращает список с пагинацией, отфильтрованный по остальным параметрам (ордера со статусом Pending исключены; ордера со статусами Success, Processing и Fail включены) - Фильтр status по умолчанию (если не указан): возвращает ордера со статусами Success, Processing и Fail Лимит запросов: 10 запросов/с (UID)

Запрашивает активные позиции по майнингу ликвидности для текущего пользователя. Поля суммы (quoteAmount, baseAmount и т.д.) вычисляются динамически на основе цен в реальном времени. Ограничение скорости: 10 запросов/с (UID)

Запрашивает доступные листинги продуктов Liquidity Mining. Аутентификация не требуется (поддерживается гостевой доступ). Ограничение частоты: 50 запросов/с (IP).

Запрашивает записи о получении доходности для позиций майнинга ликвидности с курсорной пагинацией. Ограничение скорости: 10 запросов в секунду (UID)

Запрашивает коэффициенты чистых длинных и коротких позиций в процентах от всех держателей позиций, используемые как индикатор рыночных настроений для рынков деривативов. Используйте этот эндпоинт, когда нужно: - Измерять настроения рынка, сравнивая доли держателей длинных и коротких позиций - Отслеживать изменения соотношения длинных/коротких позиций во времени как контрарный или трендовый сигнал - Анализировать исторические данные о настроениях на интервалах от 5 минут до 1 дня Поддерживаемые продукты: USDT contract, Inverse contract Расчёт: - buyRatio = Количество держателей длинных позиций / Общее количество держателей позиций - sellRatio = Количество держателей коротких позиций / Общее количество держателей позиций Обязательные параметры: category, symbol и period. Поддерживает курсорную пагинацию через nextPageCursor. Примечания: - Поддерживает курсорную пагинацию - Аутентификация не требуется Подсказка агенту: используйте этот эндпоинт для получения данных о настроениях по соотношению длинных/коротких позиций для символа дериватива. Обязательные параметры: category, symbol и period (5min/15min/30min/1h/4h/1d). Используйте startTime и endTime (в миллисекундах) для запроса конкретного временного диапазона. Для пагинации передавайте nextPageCursor из предыдущего ответа в параметр cursor.

Запрашивает историю ордеров LP пользователя (операции stake и redeem) с опциональными фильтрами. Возвращает постраничный список ордеров с указанием статуса, сумм, комиссий и времени исполнения. Агент ИИ должен вызывать этот инструмент после выполнения stake/redeem, чтобы подтвердить результат пользователю. Опрашивайте с подходящим фильтром orderStatus, чтобы проверить, завершился ли ожидающий ордер. НЕ используйте эту конечную точку для получения деталей позиции — вместо этого используйте getLPPositionList. Подсказка агенту: Используйте эту конечную точку для проверки статуса ордера после выполнения stake/redeem или когда пользователь спрашивает об истории ордеров. После executeLPStake или executeLPRedeem опрашивайте эту конечную точку и сопоставляйте элементы ответа по orderNo (orderNo — это поле ответа; эта конечная точка не принимает orderNo на вход — фильтруйте список по orderType и orderStatus вместо этого). НЕ используйте это для проверки текущих позиций — для этого используйте getLPPositionList.

Запрашивает доступные платежные токены, которые можно использовать для LP staking. Возвращает детали токена и доступный баланс пользователя для каждого. Вызовите это перед стейкингом, чтобы показать пользователям, какие токены они могут использовать. Подсказка для агента: Используйте этот endpoint, чтобы показать пользователям, какие токены они могут использовать для стейкинга. Возвращает баланс пользователя для каждого токена, помогая им решить, что стейкать.

Запрашивает текущие цены в USD для одного или нескольких платежных токенов. Поддерживает пакетные запросы для получения цен нескольких токенов в одном запросе. Рассчитывает стоимость стейка в USD или показывает пользователям информацию о ценах. Подсказка агенту: используйте этот эндпоинт для получения цен токенов для расчета стоимости стейка в USD. Позволяет запрашивать несколько токенов за один раз, передавая массив значений tokenCode. Показывает пользователям стоимость их стейка в USD перед подтверждением.

Запрашивает подробную информацию о пуле, включая разбивку APY, комиссии, резервы токенов и историческую производительность. Используйте это после выбора пула из списка пулов, чтобы получить полные детали. Подсказка для агента: Используйте этот endpoint, когда пользователь хочет получить подробную информацию о конкретном пуле. Вызывайте это перед стейкингом, чтобы показать пользователю полные детали пула. poolAddress обязателен и должен быть получен из getLPPoolList.

Запрашивает доступные пулы ликвидности с опциональной фильтрацией по тегу и токену. Возвращает информацию о пулах, включая адреса, поддерживаемые токены, APY и TVL. AI-агент может использовать этот эндпоинт, чтобы помочь пользователям находить и сравнивать пулы ликвидности. Подсказка агенту: используйте этот эндпоинт, когда пользователь хочет просмотреть доступные LP-пулы или искать пулы по токену. Фильтруйте по tokenSymbol, чтобы найти пулы, содержащие определённый токен.

Запрашивает позиции пользователя в пулах ликвидности с оценкой в реальном времени. Возвращает детали позиции: поставленную сумму, текущую стоимость, заработанные награды и APY. AI-агент должен вызывать этот инструмент, чтобы показать пользователям их LP-портфель или после выполнения stake/redeem для подтверждения результата. НЕ используйте эту конечную точку для получения информации о пуле, а используйте getLPPoolInfo. Подсказка агенту: Используйте эту конечную точку, чтобы показать пользователям их LP-позиции и производительность портфеля. После executeLPStake или executeLPRedeem опрашивайте эту точку, чтобы подтвердить обновление позиции. НЕ используйте для получения деталей пула. Для этого используйте getLPPoolInfo.

Запрашивает исторические свечные данные (OHLCV) — open, high, low, close, volume и turnover. Используй этот эндпоинт, когда нужно: - Строить ценовые графики с данными open/high/low/close/volume/turnover - Выполнять технический анализ исторических рыночных цен - Получать данные за конкретный временной диапазон через параметры start и end Доступные продукты: Spot, USDT контракты, USDC контракты, Inverse контракты Каждая свеча — это массив из 7 элементов: [startTime, open, high, low, close, volume, turnover]. Данные выдаются в обратном хронологическом порядке (сначала самые свежие). Возвращает до 1000 записей за один запрос. Не используй этот эндпоинт для свечей по маркировочной цене — используй getMarkPriceKline. Не используй этот эндпоинт для свечей по индексной цене — используй getIndexPriceKline. Примечания: - Данные возвращаются в обратном хронологическом порядке (сначала самые свежие) - Аутентификация не требуется Подсказка агенту: используй этот эндпоинт для получения OHLCV-свечей под построение графиков или технический анализ. Передай start и end таймстемпы (в миллисекундах), чтобы запросить конкретный временной диапазон. Для свечей по маркировочной цене используй getMarkPriceKline; для свечей по индексной цене — getIndexPriceKline. Для свечей по премиум-индексу (фандинг) используй getPremiumIndexPriceKline.

Запрашивает исторические свечи mark price, используемые для расчета маржи и ликвидаций по деривативным контрактам. Используйте этот эндпоинт, когда вам нужно: - Проанализировать исторические движения mark price для управления рисками или бэктестинга. - Построить график свечей mark price рядом со свечами торговой цены для сравнения. - Понять риск ликвидации на основе истории mark price. Поддерживаемые продукты: USDT-контракт, USDC-контракт, Inverse-контракт Каждая запись свечи — это массив из 5 элементов: [startTime, open, high, low, close]. Данные возвращаются в обратном хронологическом порядке (сначала самые новые). Не используйте этот эндпоинт для свечей обычной торговой цены — используйте getMarketKline. Не используйте этот эндпоинт для свечей индексной цены — используйте getIndexPriceKline. Примечания: - Данные возвращаются в обратном хронологическом порядке (сначала самые новые). - Аутентификация не требуется. Подсказка агенту: используйте этот эндпоинт для получения исторических свечей mark price по контрактам. Маркировочная цена используется для маржинальных требований и ликвидации — она отличается от торговой цены. Для обычных OHLCV-свечей торговой цены используйте getMarketKline. Для свечей индексной цены используйте getIndexPriceKline.

Получает информацию о типах счетов для указанных ID участников. Используйте API-ключ основного или суб-счета. Важные замечания: - Можно запрашивать типы счетов для нескольких ID участников - Возвращает типы счетов: SPOT, CONTRACT, OPTION, UNIFIED, FUND - У счетов UTA/UMA разные комбинации типов счетов - Отфильтровывает недействительные или неактивные типы счетов Комбинации типов счетов: - UTA (Unified Trading Account): имеет CONTRACT, UNIFIED, FUND - UMA (Unified Margin Account): имеет CONTRACT, UNIFIED, SPOT, FUND - Classic Account: имеет SPOT, CONTRACT, OPTION, FUND по отдельности Типы счетов: - SPOT: спот-счет - CONTRACT: счет для торговли бессрочными и фьючерсными контрактами - OPTION: опционный счет - UNIFIED: счет с единым обеспечением/торговый счет - FUND: фондовый счет (кошелек) Правила фильтрации: - Счета UTA: типы OPTION и SPOT исключаются (объединены в UNIFIED) - Счета UMA: тип OPTION исключается, если существует UNIFIED - Возвращаются только активные типы счетов

Запрашивает конфигурацию Market Maker Protection и статус заморозки для указанной базовой монеты. Возвращает параметры MMP и текущее состояние. Ограничение частоты: 5 запросов/с Подсказка агенту: используйте это, чтобы проверить настройки MMP и статус заморозки. Параметр baseCoin обязателен. Ключевые поля: mmpEnabled (активен ли MMP), window (временное окно в мс), frozenPeriod (длительность заморозки в мс), qtyLimit, deltaLimit, mmpFrozen (текущий статус заморозки), mmpFrozenUntil (время истечения заморозки).

Запрашивает историю ордеров на перемещение позиций (block trade). Возвращает детали ордера, статус исполнения, комиссии и информацию об отклонении. Подсказка агенту: используйте этот инструмент для проверки статуса и истории запросов на перемещение позиций. Фильтруйте по категории, символу, статусу или blockTradeId. Максимум 7 дней на запрос. Каждая запись показывает сторону maker/taker, детали исполнения и коды результата. status=Processing — исполняется, Filled — завершён, Rejected — отклонён.

Получает детали конкретного P2P-объявления.

Получает список моих P2P-объявлений.

Извлекает исторические цены доставки опционов, сгруппированные по базовой монете и расчётной монете, и возвращает их в обратном хронологическом порядке (сначала самые последние расчёты). Используйте этот эндпоинт, когда вам нужно: - Найти недавние расчётные цены опционов по базовой монете (BTC, ETH и т.д.), не зная конкретных символов контрактов. - Получить последнюю цену доставки вскоре после завершения расчёта. - Получить доступ к истории расчётов для конкретной пары базовая монета / расчётная монета. Поддерживаемые продукты: Только опционы Не используйте этот эндпоинт для цен доставки фьючерсов — используйте getDeliveryPrice. Не используйте этот эндпоинт, если вам нужны расчётные цены для конкретного символа контракта — используйте getDeliveryPrice. Примечания: - Запрашивайте не менее чем через 1 минуту после завершения расчёта, так как данные могут задерживаться до 1 минуты. - Лимит по умолчанию — 50 записей. - Аутентификация не требуется. Подсказка агенту: Используйте этот эндпоинт для получения недавних цен доставки опционов по baseCoin (например, BTC, ETH). category=option и baseCoin обязательны; settleCoin по умолчанию равен USDT. Подождите не менее 1 минуты после расчёта перед запросом, чтобы данные были доступны. Для цен доставки фьючерсов или запросов по конкретным символам используйте getDeliveryPrice.

Запрашивает исторические данные по открытому интересу для деривативных контрактов за указанные временные интервалы. Возвращает общий размер открытых позиций по всем участникам рынка. Используйте этот эндпоинт, когда вам нужно: - Отслеживать изменения открытого интереса во времени как индикатор рыночных настроений - Анализировать тенденции открытого интереса относительно движений цены для исследований - Получать временные ряды открытого интереса с интервалами 5min, 15min, 30min, 1h, 4h или 1d Поддерживаемые продукты: USDT contract, USDC contract, Inverse contract Поддерживает пагинацию на основе курсора через nextPageCursor. Не используйте этот эндпоинт для текущего открытого интереса: используйте getTickers, который включает openInterest и openInterestValue в реальном времени. Примечания: - В периоды экстремальной волатильности рынка задержка данных возрастает - Поддерживает пагинацию на основе курсора - Аутентификация не требуется Подсказка агенту: Используйте этот эндпоинт для получения исторических временных рядов данных по открытому интересу. Обязательные параметры: category, symbol и intervalTime (5min/15min/30min/1h/4h/1d). Для текущего значения открытого интереса используйте getTickers, который включает openInterest в реальном времени. Для пагинации передайте nextPageCursor из предыдущего ответа в параметр cursor.

Запрашивает неисполненные или частично исполненные ордера в режиме реального времени. Для запроса более старых записей ордеров используйте эндпоинт истории ордеров. - Единый аккаунт охватывает: Spot / USDT perpetual / USDC contract / Inverse contract / Options - Классический аккаунт охватывает: Spot / USDT perpetual / Inverse contract Поведение: - По умолчанию возвращает открытые (неисполненные / частично исполненные) ордера (openOnly=0) - Установите openOnly=1, чтобы также возвращать последние 500 закрытых ордеров - При запросе по orderId или orderLinkId параметр openOnly игнорируется - Результаты сортируются по createdTime от новых к старым - После перезапуска сервера закрытые ордера единого аккаунта следует запрашивать через эндпоинт истории ордеров Приоритет параметров фильтра: orderId > orderLinkId > symbol > baseCoin Подсказка агенту: TradFi: используйте category=spot для запроса открытых ордеров xStock, category=linear для бессрочных ордеров на акции и сырьевые товары.

Получает данные глубины стакана для торговой пары. Возвращает снимок заявок на покупку и продажу по всем поддерживаемым типам продуктов. Используйте этот эндпоинт, когда требуется: - Проверить текущую глубину спроса и предложения перед размещением заявки - Получить лучшую цену покупки/продажи и доступный объём на каждом уровне - Сопоставить с WebSocket-потоком стакана по полям u (идентификатор обновления) и seq Поддерживаемые продукты: Спот, USDT-контракт, USDC-контракт, Inverse-контракт, Опцион Возвращает до 500 уровней на сторону для деривативов (спот: до 200; опцион: до 25). Используйте limit=1 только для лучших цен спроса и предложения. Не используйте этот эндпоинт для RPI-заявок — вместо этого используйте getRpiOrderbook. Не используйте этот эндпоинт для статистики за 24 часа или последней цены — вместо этого используйте getTickers. Примечания: - RPI-заявки не включены; используйте getRpiOrderbook для глубины с учётом RPI - Заявки на покупку отсортированы по убыванию цены - Заявки на продажу отсортированы по возрастанию цены - Аутентификация не требуется Подсказка агенту: Используйте этот эндпоинт для получения текущей глубины спроса и предложения для торговой пары. Используйте limit=1 (по умолчанию для спота/опциона) только для лучших цен; увеличьте лимит для более глубокого анализа. RPI-заявки исключены — используйте getRpiOrderbook, если нужна глубина с RPI. Не используйте для статистики за 24 часа или последней цены — используйте getTickers.

Получает подробную информацию о конкретном P2P-заказе.

Запрашивает историю заказов. Так как создание и отмена заказов происходят асинхронно, данные, возвращаемые этим endpoint, могут задерживаться. Чтобы получить информацию о заказах в реальном времени, можно запросить endpoint открытых заказов или положиться на websocket stream (рекомендуется). - Единый аккаунт поддерживает: Spot / USDT perpetual / USDC contract / Inverse contract / Options - Классический аккаунт поддерживает: Spot / USDT perpetual / Inverse contract Правила: - Последние 7 дней: можно запрашивать все закрытые статусы, кроме «Cancelled», «Rejected», «Deactivated» - Последние 24 часа: можно запрашивать заказы со статусами «Cancelled», «Rejected», «Deactivated» - Старше 7 дней: можно запрашивать только заказы с финальными статусами исполнения (Filled, PartiallyFilledCanceled) Правила временного диапазона: - Если startTime и endTime не заданы: по умолчанию возвращаются последние 7 дней - Если задан только startTime: возвращается диапазон от startTime до startTime + 7 дней - Если задан только endTime: возвращается диапазон от endTime - 7 дней до endTime - Если заданы оба: endTime - startTime должен быть ≤ 7 дней Подсказка для агента: TradFi: используйте category=spot для истории заказов xStock, category=linear для истории бессрочных контрактов на акции и товары.

Запрашивает историю торговых заказов пользователя с опциональными фильтрами. Возвращает список заказов с постраничной разбивкой, включая статус заказа, суммы токенов, комиссии и время выполнения. Агент AI вызывает этот endpoint после выполнения трейда, чтобы подтвердить результат пользователю. Опрашивайте с фильтром orderStatus=[1], чтобы проверить, завершился ли ожидающий заказ. НЕ используйте этот endpoint для получения цен токенов или рыночных данных — используйте getBizTokenPriceList. НЕ используйте это для проверки активов — используйте getAssetList. Подсказка агенту: используйте этот endpoint для проверки статуса заказа после выполнения трейда или когда пользователь спрашивает об истории своих трейдов. После executePurchase или executeRedeem опрашивайте его с orderNo, чтобы подтвердить завершение. Не используйте это для получения цен токенов — используйте getBizTokenPriceList. Не используйте это для проверки портфеля активов — используйте getAssetList.

Получает текущий допустимый диапазон цен для размещения ордеров, включая максимальный лимит цены покупки (buyLmt) и минимальный лимит цены продажи (sellLmt). Используйте этот эндпоинт, когда вам нужно: - Проверить, что цена лимитного ордера входит в допустимый диапазон перед отправкой - Избежать отклонения ордера из-за ошибки выхода цены за допустимый диапазон - Узнать текущие ценовые лимиты, чтобы сформировать корректные ордера рядом с рыночной ценой Поддерживаемые продукты: Spot, USDT contract, Inverse contract Возвращает buyLmt (максимально допустимая цена заявки на покупку) и sellLmt (минимально допустимая цена заявки на продажу). Не используйте этот эндпоинт для определения шага цены или точности цены — используйте getInstrumentsInfo. Примечания: - Аутентификация не требуется Подсказка агенту: Используйте этот эндпоинт, чтобы убедиться, что цена лимитного ордера находится в допустимом диапазоне перед размещением ордера. По умолчанию category принимает значение linear. symbol обязателен. Вызывайте этот эндпоинт перед отправкой лимитного ордера, если получаете ошибки выхода цены за допустимый диапазон. Для ограничений по шагу цены и точности цены используйте getInstrumentsInfo.

Запрашивает доступные платежные токены для торговли. Возвращает символ токена, код токена CEX_<id>, максимальный лимит торговли и список поддерживаемых блокчейнов. AI-агент должен вызывать этот метод перед выполнением сделки, чтобы преобразовать ввод пользователя (например, "USDT") в соответствующий код токена CEX_<id>, необходимый для getTradeQuote. НЕ ИСПОЛЬЗУЙТЕ эту конечную точку для получения ончейн-токенов, доступных для торговли, используйте getBizTokenList. НЕ ИСПОЛЬЗУЙТЕ этот метод для получения рыночных данных или цен токенов, используйте getBizTokenPriceList. Подсказка для агента: Используйте эту конечную точку для получения доступных платежных токенов (USDT, USDC и т.д.) и их кодов CEX перед размещением сделки. Сопоставляет ввод пользователя, например "USDT", с "CEX_1". Обязателен перед вызовом getTradeQuote. НЕ ИСПОЛЬЗУЙТЕ этот метод для получения ончейн-токенов, доступных для торговли, используйте getBizTokenList. НЕ ИСПОЛЬЗУЙТЕ этот метод для получения цен токенов, используйте getBizTokenPriceList.

Получает список ожидающих P2P-заказов. По умолчанию возвращает заказы за 90 дней. Заказы доступны за последние 180 дней.

Запрашивает информацию о портфельной марже, включая баланс кошелька, ставки маржи и диапазон PNL по активам. Примечания: - Этот эндпоинт требует аутентификации. - Если baseCoin не указан, возвращает все базовые монеты.

Запрашивает данные о позициях в реальном времени: размер позиции, накопленную realizedPNL. - Единый аккаунт включает: бессрочные контракты USDT / контракты USDC / инверсные контракты / опционы - Классический аккаунт включает: бессрочные контракты USDT / инверсные контракты Единый аккаунт: - Для linear обязателен либо symbol, либо settleCoin - Для inverse обязателен либо symbol, либо settleCoin - Для option параметр baseCoin необязателен; если его не передать, возвращаются все опционные позиции Информация: - Если позиция в одностороннем режиме и сторона позиции пуста, значит по этому символу позиция не открыта

Запрашивает информацию о кредитном плече фьючерсов: символ, сторона и режим позиции. Охватывает: Бессрочные USDT / контракты USDC / обратные контракты Примечание: - В режиме портфельной маржи возвращает ошибку

Запрашивает данные tier позиции для спотовой маржинальной торговли. - Возвращает информацию о tier, включая лимиты заимствования, маржинальные ставки и максимальное кредитное плечо. - Если currency опущен, возвращает данные для всех настроенных монет. - Tiers упорядочены от малых к большим. Подсказка агенту: Аутентифицированная конечная точка. Возвращает информацию о tier позиции для каждой монеты для спотовой маржи. Каждый tier включает borrowLimit, positionMMR (ставка поддержания маржи), positionIMR (ставка начальной маржи) и maxLeverage. Передайте currency, чтобы отфильтровать по конкретной монете, или опустите, чтобы получить все монеты. Маржинальные ставки используют точность до 8 знаков после запятой.

Запрашивает, доступен ли в данный момент механизм сопоставления заявок на рынке предсказаний. Когда механизм недоступен, заявки на покупку и продажу не могут быть отправлены. Агент ИИ должен проверять статус механизма перед попыткой разместить заявки. Если механизм недоступен, сообщите пользователю и не продолжайте торговлю. Подсказка агенту: вызывайте этот инструмент перед размещением любой заявки на покупку или продажу, чтобы проверить, доступен ли механизм сопоставления. Если available=false, не продолжайте торговлю и сообщите пользователю, что рынок временно недоступен.

Получает подробную информацию о событии предсказаний, включая все связанные рынки, токены исходов, текущие цены и статистику торгов. Используйте slug для поиска события по читаемому названию (имеет приоритет над eventId). Установите hasMoreMarkets=true, чтобы включить рынки из связанных под-событий «more-markets». Агент ИИ должен вызывать этот эндпоинт перед размещением заказов, чтобы получить полный список идентификаторов токенов исходов и текущие цены для конкретного события. Подсказка агенту: используйте этот эндпоинт для получения всех деталей конкретного события предсказаний, включая tokenIds для торговли. Предпочитайте использовать slug, если он доступен (более стабилен, чем eventId). Вызывайте этот эндпоинт перед покупкой/продажей, чтобы подтвердить текущие рыночные цены и доступные tokenIds. НЕ ИСПОЛЬЗУЙТЕ getPredictionMarketList для деталей отдельного события. Используйте этот эндпоинт.

Запрашивает подробные турнирные таблицы и результаты матчей для определённого этапа турнира. Возвращает групповые таблицы со статистикой команд для групповых этапов или информацию о сетке для плей-офф. Используйте stageCode из getPredictionTimelineStages, чтобы указать, какой этап запросить. Допустимые stageCodes: Groups, R32, R16, QF, SF, Final. AI-агент может использовать это, чтобы предоставить контекст о производительности команд, помогая пользователям делать обоснованные прогнозы ставок. Подсказка для агента: используйте это, чтобы получить групповые таблицы или результаты плей-офф для определённого этапа турнира. stageCode должен быть одним из: Groups, R32, R16, QF, SF, Final. Используйте этот контекст, чтобы помочь пользователям принимать обоснованные решения о ставках. eventType=1: FIFA Women's World Cup 2023.

Получает все матчи спортивного события с их текущим статусом и информацией о рынках прогнозов. Возвращает детали матча: команды, запланированное время, статус (Live/Upcoming/Ended) и связанные рынки прогнозов для каждого матча. AI-агент использует это, чтобы показать пользователю доступные матчи для ставок, а затем использует eventId для получения подробной информации о рынке перед торговлей. Подсказка агенту: Используйте это, чтобы получить все матчи FIFA 2026 (eventType=1). У каждого матча есть связанный eventId - используйте его с getPredictionEventDetail, чтобы получить tokenIds. Фильтруйте по matchStatus: 1=Live, 2=Upcoming, 3=Ended. НЕ ПОКАЗЫВАЙТЕ завершённые матчи для торговли, если пользователь явно не попросит.

Запрашивает полную книгу ордеров (глубину bid/ask) для токенов исходов прогнозов. Возвращает все ценовые уровни с доступным количеством. AI-агент может использовать это, чтобы оценить влияние на цену перед размещением крупного заказа или показать пользователям информацию о глубине рынка. Максимум 20 tokenIds на запрос. Подсказка агенту: Используйте это, чтобы получить полную глубину книги ордеров для конкретных tokenIds. Полезно для оценки влияния на цену крупного заказа. Если нужна только текущая лучшая цена, используйте getPredictionTokenPrice. Максимум 20 tokenIds на запрос.

Получает оценку деталей исполнения ордера на рынке предсказаний перед его размещением. Возвращает оценочную среднюю цену исполнения, общее количество полученных/проданных долей, комиссию и информацию о том, может ли ордер FOK быть полностью исполнен. Обязательно перед любой покупкой или продажей. AI-агент должен показать пользователю оценочные результаты перед переходом к исполнению. - BUY: установите side=1, amount = USDC для инвестирования, payTokenCode = "USDC" - SELL: установите side=2, amount = количество долей для продажи Фаза 1 поддерживает только orderType=1 (FOK). Ордер FOK, который не может быть полностью исполнен, будет полностью отменён. Подсказка агенту: ОБЯЗАТЕЛЬНО перед вызовом buy или sell. Всегда сначала показывайте оценку пользователю. side=1 это BUY (сумма в USDC), side=2 это SELL (сумма в долях). orderType=1 (FOK) - единственный поддерживаемый тип в Фазе 1. Покажите пользователю estimatedCost, estimatedReceive, feeAmount и toWin (только для BUY). НЕ вызывайте buy/sell без подтверждения пользователя после просмотра оценки.

Запрашивает историю ордеров аутентифицированного пользователя на рынке предсказаний. Возвращает детали ордера, включая статус исполнения, цену исполнения и комиссии. Используйте этот инструмент после размещения ордера на покупку или продажу, чтобы проверить итоговый статус исполнения. Ордеры FOK отображаются как FILLED или CANCELLED. Поддерживает фильтрацию по: - status: статус ордера (PENDING/FILLED/PARTIALLY_FILLED/CANCELLED/REJECTED) - tokenId: конкретный токен исхода - eventId: конкретное событие - side: BUY (1) или SELL (2) - days: количество дней для просмотра истории (максимум 90) Подсказка агенту: используйте этот инструмент, чтобы проверить статус исполнения ордера после размещения ордеров на покупку/продажу. Фильтруйте по status=2 (FILLED) или status=4 (CANCELLED), чтобы увидеть результаты ордера. Ордеры FOK либо полностью исполнены (FILLED), либо отменены (CANCELLED) - частичного исполнения нет. Используйте параметр days, чтобы ограничить диапазон истории (максимум 90 дней).

Запрашивает доступные платёжные токены для торговли на рынке предсказаний. Возвращает символ токена, код и список поддерживаемых блокчейнов. Агент ИИ должен вызывать этот метод перед совершением сделки, чтобы проверить поддерживаемые платёжные токены. Первая фаза рынка предсказаний поддерживает только USDC. Подсказка агенту: используйте эту конечную точку для получения доступных платёжных токенов перед размещением ордера на покупку на рынке предсказаний. Возвращает информацию о токене USDC. Используйте код токена в запросах на покупку (поле payTokenCode).

Запрашивает сводную информацию о портфеле прогнозного рынка аутентифицированного пользователя. Возвращает общую инвестированную сумму, текущую стоимость портфеля, нереализованную и реализованную прибыль/убыток, а также общее количество активных и исторических позиций. AI-агент может использовать это, чтобы предоставить пользователям быстрый обзор их результатов на прогнозном рынке без перечисления всех отдельных позиций. Подсказка агенту: Используйте это для общего обзора портфеля: общая стоимость, общая прибыль/убыток, количество позиций. Для деталей по отдельным позициям используйте getPredictionPositionList. Для разбивки исторической прибыли/убытка используйте getPredictionPositionList.

Запрашивает исторические позиции аутентифицированного пользователя по прогнозам, которые были закрыты (путем ручной продажи, разрешения рынка или истечения срока). Возвращает реализованную прибыль/убыток и итоговый результат для каждой закрытой позиции. AI-агент может использовать это для подведения итогов торговли прогнозами пользователя. Подсказка агенту: Используйте это, чтобы посмотреть историю закрытых позиций пользователя по прогнозам и реализованную прибыль/убыток. Для текущих открытых позиций используйте getPredictionPositionList. Результат показывает WIN/LOSE/MANUAL_CLOSE и выигранную или проигранную сумму.

Запрашивает текущие открытые позиции аутентифицированного пользователя по прогнозам. Возвращает позиции, которые ещё не были разрешены. Каждая позиция включает количество удерживаемых акций, текущую рыночную стоимость, нереализованную прибыль/убыток и информацию о связанном событии. AI-агент должен вызывать этот метод перед размещением ордера на продажу, чтобы подтвердить, что у пользователя достаточно акций, и отобразить текущий портфель. Подсказка агенту: используйте это, чтобы проверить, какие позиции у пользователя есть перед продажей. Показывает только открытые (неразрешённые) позиции. Для исторических позиций используйте getPredictionPositionHistory. Каждая позиция имеет tokenId, используйте его в ордерах на продажу. Проверяйте availableSize перед продажей, чтобы убедиться, что у пользователя достаточно акций.

Запрашивает исторические данные о ценах токенов исходов прогнозов. Возвращает временной ряд цен для отображения на графике. Два режима: 1. По tokenIds: укажите напрямую до 20 идентификаторов токенов. 2. По eventId: укажите событие, чтобы получить историю цен для всех его токенов. Параметр interval задаёт временной диапазон: 1H, 6H, 1D, 1W, 1M или ALL. Параметр fidelity задаёт количество минут между точками данных (0 — авто). Примечание: у этого эндпоинта более строгие лимиты запросов (2 запроса/с), так как данные не кэшируются. Подсказка агенту: используйте этот инструмент, чтобы получить историю цен для конкретных токенов или событий. Используйте interval=1D для дневного просмотра, interval=1W для анализа недельного тренда. Предпочитайте запрос по tokenIds, когда знаете конкретные токены. НЕ используйте этот инструмент для текущих цен. Вместо этого используйте getPredictionTokenPrice.

Запрашивает список сопутствующих/связанных рынков для определённого типа спортивного события. Сопутствующие рынки — это дополнительные рынки прогнозов, связанные с основным событием (например, лучший бомбардир, победители группы, золотая бутса). ИИ-агент может использовать это для обнаружения дополнительных торговых возможностей помимо прогнозов исходов матчей. Подсказка агенту: используйте это для обнаружения сопутствующих/вспомогательных рынков для спортивных событий. eventType=1 относится к FIFA_2026. Это дополнительные рынки помимо исходов матчей (например, лучший бомбардир, наибольшее количество голов).

Запрашивает временную шкалу этапов турнира для события спортивного прогнозирования. Возвращает все этапы (Групповой этап, 1/32 финала, 1/16 финала, Четвертьфиналы, Полуфиналы, Финал) с их текущим статусом. AI-агент использует это, чтобы понять текущую фазу турнира и перейти к соответствующему этапу для прогнозов. Подсказка агента: Используйте это, чтобы получить временную шкалу этапов турнира для FIFA 2026 (eventType=1). Возвращает, какие этапы имеют статус Done/Active/Upcoming. Используйте stageCode отсюда в getPredictionGroupStageDetail, чтобы получить данные прогнозов.

Запрашивает текущие рыночные цены для до 20 токенов исходов прогнозов. Возвращает лучшую цену покупки, лучшую цену продажи и цену последней сделки для каждого токена. AI-агент должен вызывать этот инструмент перед размещением ордеров, чтобы подтвердить текущие рыночные цены. Цена представляет вероятность (0–1): цена 0,65 означает ~65% вероятность исхода YES. Подсказка агенту: используйте этот инструмент для получения текущих цен для конкретных tokenIds перед торговлей. Цена — это вероятность (от 0 до 1). Токен YES по цене 0,65 означает 65% вероятность исхода YES. Всегда проверяйте цену перед покупкой/продажей. Максимум 20 tokenIds на запрос. НЕ используйте этот инструмент для истории цен — используйте getPredictionPriceHistory.

Запрашивает исторические свечи премиального индекса, базиса между ценой маркировки и индексной ценой, используемого в расчетах ставки финансирования для бессрочных контрактов USDT и USDC. Используйте этот эндпоинт, когда вам нужно: - Анализировать исторический базис ставки финансирования для бессрочных контрактов - Исследовать зависимость между ценой маркировки и индексной ценой с течением времени - Строить графики премиального индекса (значения обычно небольшие положительные или отрицательные десятичные числа) Поддерживаемые продукты: Бессрочные контракты USDT, USDC Каждая запись свечи - массив из 5 элементов: [startTime, open, high, low, close]. Данные возвращаются в обратном хронологическом порядке (сначала самые новые). Не используйте этот эндпоинт для свечей торговой/маркировочной/индексной цены - используйте соответствующие эндпоинты свечей. Примечания: - Данные возвращаются в обратном хронологическом порядке (сначала самые новые) - Авторизация не требуется Подсказка агенту: Используйте этот эндпоинт для получения исторических свечей премиального индекса, используемых в расчете ставки финансирования. Премиальный индекс показывает спред между ценой маркировки и индексной ценой. Для свечей торговой цены используйте getMarketKline; для цены маркировки - getMarkPriceKline; для индексной цены - getIndexPriceKline.

Запрашивает общедоступные данные о RFQ-трейдах с опциональной фильтрацией по временному диапазону и курсорной пагинацией. Окно между startTime и endTime не должно превышать 30 дней. Лимит запросов: 50 запросов в секунду. Подсказка агенту: Этот эндпоинт возвращает общедоступные (анонимизированные) данные о RFQ-трейдах. Требуется аутентификация через заголовки с API-ключом. Временное окно между startTime и endTime не должно превышать 30 дней.

Возвращает постраничный список активностей Puzzle, отфильтрованный по статусу. Опционально сужает результаты по коду проекта или монете активности. AI-агент может использовать это, чтобы помочь пользователям просматривать доступные активности Puzzle или искать детали конкретного проекта. Подсказка агенту: Используйте эту конечную точку для получения списка активностей Puzzle. Фильтруйте по статусу (0=предстоящие, 1=текущие, 2=завершённые). Чтобы найти конкретный проект, передайте его код через projectId. Используйте cursor/limit для постраничной навигации.

Запрашивает исторические котировки с возможностью фильтрации по ID, типу трейдера и статусу. Поддерживает курсорную пагинацию. Сортирует результаты по createdAt по убыванию. Эти данные не в реальном времени. Используйте эндпоинт Get Quotes (real-time) для получения данных в реальном времени. Приоритет при указании нескольких идентификаторов: quoteId > quoteLinkId > rfqId. Параметр quoteLinkId недействителен, когда traderType равен "request". Лимит запросов: 50 запросов в секунду. Подсказка агенту: Возвращает исторические (не в реальном времени) данные котировок. Используйте Get Quotes Realtime для данных в реальном времени. Поддерживает пагинацию через курсор. Когда указаны и quoteId, и quoteLinkId, применяются оба условия.

Запрашивает котировки в реальном времени от RFQ engine. Возвращает все нефинальные котировки, отсортированные по убыванию createdAt. Приоритет при указании нескольких идентификаторов: quoteId > quoteLinkId > rfqId. Параметр quoteLinkId недействителен, когда traderType равен "request". Ограничение скорости: 50 запросов в секунду. Примечание: Во время экстремальной волатильности рынка этот интерфейс может испытывать повышенную задержку. Подсказка агенту: Используйте для получения данных котировок в реальном времени. Для исторических данных используйте Get Quotes (quote-list). Приоритет: quoteId > quoteLinkId > rfqId. quoteLinkId игнорируется, когда traderType равен "request".

Запрашивает недавнюю публичную историю торгов для символа, возвращая записи исполнения с ценой, размером, направлением тейкера, временной меткой и порядковым номером. Используйте эту конечную точку, когда нужно: - просмотреть недавний поток сделок и цены исполнения для символа; - получить записи сделок для отображения или анализа; - сопоставить сделки с данными книги ордеров с помощью поля seq (кросс-последовательность). Поддерживаемые продукты: спот, USDT-контракт, USDC-контракт, инверсный контракт, опцион. Возвращает до 1000 записей (для спота — до 60) в обратном хронологическом порядке. symbol обязателен для spot, linear и inverse. Для option baseCoin по умолчанию равен BTC. Не используйте эту конечную точку для текущей цены или статистики за 24 часа — используйте getTickers. Не используйте эту конечную точку для глубины книги ордеров — используйте getOrderbook. Примечания: - symbol обязателен для категорий spot, linear и inverse. - Для option baseCoin по умолчанию равен BTC, если не указан. - Аутентификация не требуется. Подсказка для агента: Используйте эту конечную точку, чтобы получить недавнюю публичную историю исполнения сделок для символа. Для текущей цены или статистики за 24 часа используйте getTickers. Для текущей глубины спроса/предложения используйте getOrderbook. Символ обязателен для spot/linear/inverse; для опционных запросов используйте параметр baseCoin.

Запрашивает справочный обменный курс для указанной торговой пары. Возвращает: - Цены покупки (несколько способов оплаты) - Цены продажи (несколько способов оплаты) - Метка времени цены - Информация о квоте транзакции Важно: Справочные цены даны только для ознакомления. Фактические цены сделок определяются эндпоинтом котировок. Примеры использования: - Показывать пользователям примерные курсы обмена - Сравнивать цены в разных способах оплаты - Рассчитывать ориентировочные суммы перед запросом котировки

Получает конфигурацию RFQ для аутентифицированной учетной записи, включая доступных контрагентов, типы стратегий, максимальное количество ног и минимальный объем заказа. Лимит запросов: 50 запросов в секунду. Совет: вызывайте эту конечную точку перед созданием RFQ, чтобы получить действительные коды контрагентов (counterparty deskCodes), разрешенные типы стратегий и торговые лимиты. Подсказка агенту: сначала вызовите эту конечную точку, чтобы узнать свой deskCode, доступных контрагентов, типы стратегий и торговые лимиты перед созданием RFQ или котированием.

Запрашивает исторические RFQ с возможностью фильтрации по ID, типу трейдера и статусу. Поддерживает курсорную пагинацию. Результаты сортируются по createdAt по убыванию. Эти данные не real-time. Используйте конечную точку Get RFQs (real-time) для получения актуальных данных. Когда указаны и rfqId, и rfqLinkId, учитывается только rfqId. Параметр rfqLinkId ограничивает результаты последними 3 месяцами и недействителен, когда traderType имеет значение "quote". Ограничение скорости: 50 запросов в секунду. Подсказка агенту: возвращает исторические (не в реальном времени) данные RFQ. Используйте Get RFQs Realtime для оперативных данных. Поддерживает пагинацию через курсор. rfqLinkId работает только в пределах последних 3 месяцев.

Запрашивает RFQ в реальном времени из RFQ engine. Возвращает все нефинальные RFQ, отсортированные по убыванию по createdAt. Если указаны оба параметра rfqId и rfqLinkId, учитывается только rfqId. Параметр rfqLinkId недействителен, когда traderType равен "quote". Лимит частоты: 50 запросов в секунду. Примечание: При экстремальной волатильности рынка этот интерфейс может работать с повышенной задержкой. Подсказка агенту: Используйте этот инструмент для данных RFQ в реальном времени. Для исторических данных используйте Get RFQs (rfq-list). Результаты сортируются по createdAt по убыванию. Параметр rfqLinkId игнорируется, когда traderType равен "quote".

Запрашивает параметры риск-лимитов по уровням для бессрочных и фьючерсных контрактов, включая лимиты размера позиции, ставки начальной/поддерживающей маржи и максимальное кредитное плечо для каждого уровня. Используйте эту конечную точку, когда вам нужно: - Понять уровни риска для контракта перед размещением крупных позиций - Получить максимальное кредитное плечо, разрешённое на каждом уровне риска (maxLeverage) - Проверить ставку начальной маржи (initialMargin) и ставку поддерживающей маржи (maintenanceMargin) для каждого уровня Поддерживаемые продукты: USDT контракт, USDC контракт, Inverse контракт Возвращает все уровни риска для указанного символа. Поддерживает пагинацию на основе курсора. Не используйте эту конечную точку для фильтра кредитного плеча на уровне инструмента — вместо этого используйте getInstrumentsInfo. Примечания: - Возвращает уровни риск-лимитов с соответствующими требованиями к марже и ограничениями кредитного плеча - Аутентификация не требуется Подсказка агенту: Используйте эту конечную точку для получения параметров уровня риска для символа контракта. category обязателен; symbol необязателен (пропустите, чтобы получить все символы для категории). Используйте это перед установкой кредитного плеча или размещением крупных ордеров, чтобы понять требования к марже. Для фильтра кредитного плеча на уровне инструмента используйте getInstrumentsInfo.

Извлекает данные глубины стакана, которые явно показывают размеры ордеров RPI (Retail Price Improvement) на каждом ценовом уровне вместе с обычными размерами ордеров без RPI. Используйте этот эндпоинт, когда вам нужно: - Определить ликвидность RPI, доступную на каждом ценовом уровне, отдельно от ликвидности без RPI - Различать поток ордеров RPI и не-RPI для анализа микроструктуры рынка - Получить доступ к полному стакану, включая ордера RPI (которые исключены из стандартного стакана) Поддерживаемые продукты: Spot, USDT-контракт, Inverse-контракт Каждый ценовой уровень возвращает массив из 3 элементов: [цена, размер не-RPI, размер RPI]. Возвращает до 50 уровней с каждой стороны. Не используйте этот эндпоинт, если вам нужна только обычная глубина стакана — используйте getOrderbook. Примечания: - Каждый ценовой уровень возвращает [цена, размер не-RPI, размер RPI] - Аутентификация не требуется Подсказка агенту: используйте этот эндпоинт, когда вам нужны именно размеры ордеров RPI в стакане. Для обычной глубины стакана без разбивки по RPI используйте getOrderbook. Формат ответа отличается от getOrderbook: каждый уровень содержит 3 значения [цена, размер не-RPI, размер RPI].

Запрашивает исторические точки данных NAV (Net Asset Value) для продукта RWA. Rate Limit: 20 запр./с (IP) Аутентификация не требуется. Примечания: - startTime по умолчанию равно 7 дням до endTime. - endTime по умолчанию равно текущему времени. - Временной промежуток (endTime - startTime) не должен превышать 180 дней.

Запрашивает историю заказов RWA. Поддерживает точный поиск по orderId или orderLinkId, или постраничный вывод, отфильтрованный по orderType / productId / временному диапазону. Ограничение частоты запросов: 10 запросов/с (UID) Примечания: - Если указаны orderId или orderLinkId, выполняется точный поиск, а остальные фильтры игнорируются. - Для постраничного вывода: startTime по умолчанию равен 7 дням назад, endTime по умолчанию - текущее время; самый ранний доступный момент - 7 дней назад.

Запрашивает позиции пользователя по RWA, включая эффективные доли, текущие суммы стейкинга/выкупа, накопленный бонус, текущую NAV и стоимость удержания. Лимит запросов: 10 запросов/с (UID)

Запрашивает список продуктов RWA, включая базовую APR, бонусную APR, NAV, лимиты стейкинга, точность и другие метаданные продукта. Ограничение скорости: 20 запросов/с (IP) Этот инструмент MCP не отправляет аутентификацию, поэтому поле userQuota в ответе всегда пусто. Квоту для конкретного пользователя здесь получить нельзя. Квоту для конкретного пользователя здесь получить нельзя.

Запрашивает серверное время Bybit, возвращает его с точностью до секунд и наносекунд. Используйте этот эндпоинт, когда вам нужно: - Синхронизировать ваши локальные часы с серверным временем Bybit перед формированием аутентифицированных запросов - Проверить совпадение временных меток, чтобы избежать ошибок временных меток запросов (код ошибки 10002) Возвращает timeSecond (метка времени Unix в секундах) и timeNano (с точностью до наносекунд). Не используйте этот эндпоинт для рыночных данных — вместо этого используйте getTickers или getMarketKline. Примечания: - В периоды экстремальной рыночной волатильности у этого эндпоинта может возрасти задержка - Аутентификация не требуется Подсказка агенту: Используйте этот эндпоинт для получения текущего серверного времени Bybit для синхронизации часов. Вызывайте его перед размещением ордеров, если подозреваете, что ваши локальные часы рассинхронизированы с сервером. Это служебный эндпоинт - не используйте его для рыночных данных; используйте getTickers или getMarketKline.

Запрашивает записи расчётов по сессиям для бессрочных контрактов USDC. - Единый аккаунт охватывает: USDC контракт (линейный) Правила временного диапазона: - Без обоих startTime и endTime: возвращает последние 30 дней по умолчанию - Указан только startTime: возвращает от startTime до startTime + 30 дней - Указан только endTime: возвращает от endTime - 30 дней до endTime - Указаны оба: endTime - startTime должно быть ≤ 30 дней Примечание: В периоды экстремальной волатильности рынка этот интерфейс может испытывать повышенную задержку или временные задержки в получении данных.

Запрашивает расчетную сумму погашения для одной или нескольких позиций Smart Leverage / Double Win. Требует разрешения Earn на API-ключе. Лимит запросов: 10 запросов/с (UID) Важно: Этот эндпоинт необходимо вызывать до размещения ордера на погашение. Сервер кэширует результат оценки на 10 минут. При размещении ордера на погашение поле estRedeemAmount должно совпадать с кэшированным значением. - Не более 5 ID позиций на запрос - Возвращает успех или неудачу для каждой позиции

Запрашивает идентификатор группы Self-Matching Prevention (SMP), связанный с аккаунтом.Возвращает 0, если аккаунт не принадлежит ни одной группе. Ограничение скорости: 10 запросов/с. Подсказка агенту: используйте этот вызов, чтобы проверить назначение группы SMP. Параметры не требуются. Возвращает smpGroup как целое число (0 — группа отсутствует). Группы SMP предотвращают самосовпадение между аккаунтами в одной группе.

Запрашивает доступную квоту заимствования для спотовой маржинальной торговли. Этот эндпоинт возвращает и максимальное торгуемое количество/сумму (включая заимствуемую часть), и фактически доступное количество/сумму без заимствования. - Поддерживает только Unified Trade Account (UTA) - Поддерживает только категорию spot Поведение: - Ответ различает только доступный баланс и доступный баланс плюс максимальные заимствуемые суммы в зависимости от статуса маржинальной торговли - Расчёт максимальной заимствуемой суммы учитывает лимиты платформы, параметры аккаунта UTA (IMR/MMR) и доступность пула капитала - При экстремальной волатильности рынка задержка может увеличиваться Подсказка агенту: TradFi: применяется только к токенам xStock (категория=spot). Не применяется к перпетуалам на акции или сырьевые товары.

Получает текущие настройки режима автоматического погашения для маржинальных торговых счетов. - Только унифицированный аккаунт - Если currency не передан, возвращает настройки для всех валют

Получает информацию о спотовом маржинальном кредитном плече для криптовалют. - Только для unified account - Если currency не передан, возвращает состояния всех монет.

Получает гибкий доступный остаток (оставшуюся доступную сумму для заимствования из пула кредитования) для указанной криптовалюты в спотовой маржинальной торговле.

Получает максимальную сумму, доступную для заимствования, для указанной криптовалюты в спотовой маржинальной торговле. - Только для унифицированного аккаунта.

Получает доступную сумму, которую можно погасить для конкретной криптовалюты в спотовой маржинальной торговле. - Только для Unified account - Сумма погашения = min(доступный баланс спотовой монеты, сумма займа монеты)

Запрашивает статус спотовой маржи и кредитное плечо единого аккаунта. - Только для единого аккаунта.

Запрашивает спецификации инструментов для спред-комбинаций торговых пар, включая тип контракта, статус торговли, размер тика цены, лимиты объёма заказа и детали инструментов составных ног. Используйте этот эндпоинт, когда вам нужно: - Узнать доступные спред-символы и их торговые ограничения перед размещением ордеров - Проверить точность цены (tickSize) и лимиты объёма (minSize, maxSize) для построения ордера - Получить инструменты составных ног (legs), из которых состоит спред-комбинация Возвращает постраничный список спред-инструментов. Используйте nextPageCursor из ответа, чтобы получить следующие страницы, передав его в параметр cursor. Не используйте этот эндпоинт для данных в реальном времени — используйте getSpreadTickers. Примечания: - Ответ может задерживаться в периоды высокой волатильности рынка - Поддерживает пагинацию на основе курсора - Аутентификация не требуется Подсказка агенту: используйте этот эндпоинт, чтобы узнать доступные спред-символы и их торговые ограничения. Вызывайте его перед созданием ордеров, чтобы получить tickSize, minSize и maxSize. Не используйте для цен в реальном времени — для текущей цены и статистики за 24ч используйте getSpreadTickers. Для пагинации передавайте nextPageCursor из предыдущего ответа в параметр cursor.

Запрашивает доступный баланс спред-кошелька для заданного символа и стороны. Примечания: - Этот эндпоинт требует аутентификации. - Возвращаемый доступный баланс (ab) обрезается до 8 знаков после запятой (не округляется).

Запрашивает открытые ордера в реальном времени для спред-торговых комбинаций. Возвращает активные (неисполненные или частично исполненные) ордера спред-комбинаций.

Получает данные глубины стакана спредов для указанного символа комбинации спреда. Возвращает снимок уровней цен бид и аск, а также поля sequence и timestamp для корреляции с WebSocket-потоками. Используйте этот эндпоинт, когда вам нужно: - Просмотреть текущую глубину бид/аск перед размещением спред-ордера - Получить лучшую цену бид/аск и доступный объём на каждом уровне - Скоррелировать с WebSocket-потоком стакана через поле u (идентификатор обновления) Возвращает до 25 уровней цен на каждую сторону. Используйте limit=1 (по умолчанию) только для лучших бид/аск; увеличьте limit для более глубокого анализа. Не используйте этот эндпоинт для 24-часовой статистики или последней цены сделки — используйте getSpreadTickers. Примечания: - Биды отсортированы по убыванию цены - Аски отсортированы по возрастанию цены - Поле u коррелирует с идентификатором обновления WebSocket-потока стакана - Аутентификация не требуется Подсказка агенту: Используйте этот эндпоинт для получения текущей глубины бид/аск для символа спреда. symbol должен быть действительной комбинацией спреда — получите её из getSpreadInstrumentsInfo, если неизвестна. Используйте limit=1 (по умолчанию) только для лучших бид/аск; увеличьте limit для более глубокого анализа стакана. Не используйте для 24-часовой статистики или последней цены — используйте getSpreadTickers.

Запрашивает историю ордеров спред-трейдинга. Возвращает закрытые (исполненные, отменённые, отклонённые) комбинированные ордера спреда. Примечания: - Полностью отменённые ордера хранятся до 24 часов. - Ордера с одной ногой, созданные через фьючерсный спред, доступны через основной эндпоинт истории ордеров с параметром createType=CreateByFutureSpread. Правила временного диапазона: - Если не указаны ни startTime, ни endTime: по умолчанию возвращаются последние 7 дней. - Указан только startTime: возвращает период с startTime до startTime + 7 дней. - Указан только endTime: возвращает период с endTime - 7 дней до endTime. - Указаны оба: разница endTime - startTime должна быть ≤ 7 дней.