Вопросы и ответы по OKX API
Что означает термин «Парольная фраза»?
Это пароль, который вы указали при создании API-ключа. Вам нужно запомнить его самостоятельно. Если вы забудете пароль, восстановить его будет невозможно, и вам придется создать новый API-ключ.
Как создать API-ключ?
В приложении:
1. Войдите в свой аккаунт OKX > Выберите Меню (⋮⋮⋮) > Прокрутите вниз и выберите API > Создать API-ключ
2. Заполните название API > Выберите аккаунт и назначение > Введите белый список IP-адресов > Выберите разрешения > Введите парольную фразу
Веб-версия:
1. Войдите в свой аккаунт OKX > Перейдите в Профиль и выберите API и подключения > Создать API-ключ
2. Заполните название API-ключа > Выберите аккаунт и Используется для
3. Введите белый список IP-адресов > Выберите Разрешения > Введите Парольную фразу
Примечание:
IP-адреса помогают защитить ваш API-ключ. Вы можете привязать до 20 адресов к одному ключу, разделяя их запятой или пробелом.
Для просмотра информации об API и доступа к его интерфейсу требуется авторизация. Пожалуйста, храните свой пароль в безопасности. Если вы потеряете пароль, вы можете создать новый API, так как мы не можем восстановить существующие API.
Как управлять или редактировать API-ключ?
Чтобы управлять или редактировать ваш API-ключ на OKX:
Войдите в свой аккаунт OKX и перейдите в Профиль > API.
Вы увидите список ваших существующих API-ключей. Нажмите на тот, которым хотите управлять.
Отсюда вы можете:
Просмотрите имя API-ключа, разрешения и связанный белый список IP-адресов.
Измените имя ключа, разрешения (Чтение, Торговля, вывести средства) или привязанные IP-адреса.
Удалите ключ, если он больше не нужен.
Примечание: Вы не сможете просмотреть парольную фразу после её первоначального создания. Если вы её потеряете, вам потребуется удалить существующий ключ и создать новый. Всегда храните свои учетные данные в безопасности.
Как мне отличить спотовую торговлю от маржинальной, если я торгую через API?
Способ различения спотовой и маржинальной торговли через API может варьироваться в зависимости от типа вашего аккаунта и настроек. Рекомендуем обратиться к документации OKX API для получения наиболее точных и актуальных параметров, применимых к вашей конфигурации аккаунта.
Если вам нужна дополнительная информация, обратитесь к Ассистенту OKX за персональной помощью.
Как создать демонстрационный API-ключ диска?
Чтобы торговать через API демо-диска, необходимо создать API-ключ на демо-диске. Следуйте приведённым ниже шагам:
Войдите в аккаунт OKX > Торговля > Демо-торговля > Личный кабинет > Создать API-ключ демо-аккаунта > Начать демо-торговлю
Истекает ли срок действия API-ключа?
API-ключи, не привязанные к IP и имеющие разрешения на транзакции или вывод средств, будут автоматически удалены после 14 дней бездействия. API-ключи не будут считаться неактивными, если они используются для вызова приватных или связанных с аккаунтом интерфейсов, требующих Верификации личности, таких как просмотр баланса аккаунта, данных по выставленным счетам или размещение ордеров.
Только API-ключи с правами только для чтения, привязанные к IP-адресу или определённым разрешениям, не истекают.
Что означают разрешения Займы, получить и перевод?
Перевод: Позволяет ключу переводить средства между вашими счетами. Доступно для всех счетов.
Займы: Позволяет ключу заимствовать, погашать и управлять займами. Видно только если ваш аккаунт имеет необходимую возможность.
Получить: Позволяет ключу подписываться на продукты Получить и выводить их. Видно только если ваш аккаунт соответствует требованиям для использования этой функции.
Если у вашего API-ключа ранее были включены разрешения на Торговлю, все три разрешения будут автоматически активированы после этого обновления. Ручная настройка не требуется.
Можно ли размещать ордера в единицах валюты при размещении ордеров через интерфейс?
Нет; для ордеров на контракты интерфейс по умолчанию показывает количество контрактов. Если вам нужно рассчитать конвертацию между количеством контрактов и монет, вы можете обратиться к интерфейсу конвертации контрактов в монеты здесь.
Как получить коэффициент колебаний интерфейса?
Интерфейс не может напрямую получить увеличение или уменьшение цены, но это можно вычислить с помощью формулы расчёта.
Рост и падение стоимости последней цены транзакции по сравнению с ценой открытия K-линии 24 часа назад, делённое на 100% цены открытия K-линии 24 часа назад.
Данные по формуле выше можно получить через рыночный интерфейс здесь.
В чем причина ошибки "51000 Parameter posSide error" при размещении ордера?
Сначала необходимо проверить режим аккаунта: режим покупки и продажи/режим открытия и закрытия, который можно посмотреть здесь, чтобы получить posMode.
Примечание:
В случае открытия и закрытия позиций и размещения ордеров с использованием контракта требуется параметр posSide, в который указывается лонг или шорт.
Если это режим покупки и продажи, или криптовалютная или маржинальная транзакция проводится в режиме открытия и закрытия, posSide поддерживает только net или отсутствие передачи.
Какой интерфейс можно использовать для получения номинальной стоимости контракта и минимального количества ордера?
Вы можете использовать интерфейс для получения базовой информации о торговых продуктах здесь.
номинальная стоимость контракта: ctVal, минимальное количество ордера: minSz.
Каков формат instId?
Вы можете напрямую использовать интерфейс для получения основной информации о торговых продуктах здесь.
Как установить ордер стоп-лосс и тейк-профит?
Если ордер привязан к тейк-профиту или ордеру стоп-лосс, вы можете ознакомиться с интерфейсом ордера здесь: параметры массива attachAlgoOrds.
Однако, если это отдельный ордер стоп-лосс, вы можете ознакомиться с интерфейсом комиссионных по стратегии здесь.
Почему при установке триггерной цены для тейк-профита и ордера стоп-лосс возникает ошибка: 51046, 51047, 51048, 51049?
Правила установки триггерной цены стоп-лосса/триггерной цены тейк-профита: при продаже триггерная цена тейк-профита должна быть выше последней цены транзакции, а триггерная цена стоп-лосса — ниже последней цены транзакции; при покупке триггерная цена тейк-профита должна быть ниже последней цены транзакции, а триггерная цена стоп-лосса — выше последней цены транзакции.
Что означает «Ошибка интерфейса: 50102 Запрос временной метки истек»?
Эта ошибка возникает, когда метка времени истекла. Вам необходимо вызвать интерфейс системного времени, чтобы синхронизировать ваше локальное время с временем нашего сервера. Поддержание разницы во времени в пределах 30 секунд поможет избежать этой проблемы.
Примечание: время в заголовке запроса указано в UTC0. При вызове интерфейса серверного времени время предоставляется в UTC + 8.
Что означает «Ошибка интерфейса: 50101 APIKey не соответствует текущей среде»?
Это связано с несоответствием между API-ключом и текущей средой. Вызовы реального аккаунта требуют использования API-ключа реального аккаунта, а значение параметра x-simulated-trading в заголовке запроса должно быть 0. Вызовы симулированного аккаунта требуют использования API-ключа симулированного аккаунта, а значение параметра x-simulated-trading в заголовке запроса должно быть 1.
Что означает «Ошибка интерфейса: 51010 Запрос не поддерживается в текущем режиме аккаунта»?
Это связано с вашим режимом аккаунта. Если вы хотите открыть позицию с торговым плечом или контрактом в одной валюте, вам нужно переключиться на один из трёх других режимов, кроме спотового режима! Вы можете настроить это через настройки интерфейса здесь, либо на веб-сайте или в приложении.
Примечание: первый параметр должен быть установлен на странице или в приложении; опция настроек в главном меню страницы торговли — режим аккаунта.
Что означает «Ошибка интерфейса: 51121 Количество ордера должно быть кратно размеру лота»?
В API ордера на контракты измеряются в листах и должны быть кратны минимальному количеству ордера для валютной пары. Минимальное количество ордера можно узнать через поле minSz в интерфейсе продукта здесь.
"Ошибка вывода средств: 58207 Адрес вывода средств не находится в белом списке для освобождения от верификации"; почему верификация белого списка все еще выдает ошибку, если она отключена на странице вывода средств?
Чтобы вывести средства с помощью API-интерфейса, необходимо добавить адрес вывода средств на странице и отметить кнопку «не подтверждено Visa». Отключение верификации белого списка на странице не повлияет на работу интерфейса.
Что означает «Ошибка интерфейса: 50004 — тайм-аут запроса к API серверу» (это не означает, что запрос был успешным или неудачным, пожалуйста, проверьте результат запроса)?
Ошибка 50004 обычно вызвана чрезмерной нагрузкой на сервер. Время сбора комиссий за капитал — 8, 16 и 24 часа ежедневно. В это время нагрузка на сервер высокая. Рекомендуется распределять транзакции во времени, чтобы избежать пиков. Если ошибка 50004 возникает в другое время, можно повторить попытку позже. Если ордер был размещён с ошибкой 50004, это не отражает фактический результат запроса к интерфейсу. Запрос мог выполниться успешно или завершиться неудачей. Пожалуйста, ориентируйтесь на фактический результат.
Что означает ошибка «50119 API key не существует»?
Эта ошибка обычно возникает, когда домен вашего аккаунта не соответствует вашему региону.
Для пользователей из ЕЭЗ измените, пожалуйста, домен в вашем API-запросе на eea.okx.com вместо www.okx.com.
Для пользователей из США измените, пожалуйста, домен вашего API-запроса на us.okx.com вместо www.okx.com.
Если вы используете стороннее программное обеспечение для подключения к OKX и видите эту ошибку, пожалуйста, уточните у поставщика программного обеспечения, поддерживает ли оно региональные домены. Например, пользователи из ЕЭЗ должны подключаться через eea.okx.com, иначе запрос не будет выполнен.
Почему при привязке к стороннему программному обеспечению появляется ошибка «50110»?
Эта ошибка может возникать, если текущий тип API-ключа несовместим с привязкой стороннего программного обеспечения. Попробуйте запросить API-ключ типа «транзакция» без привязки списка IP-адресов, а затем повторно подключить стороннее программное обеспечение.
Как получить последнюю цену транзакции для определённой валютной пары?
Используйте детали здесь для тикеров и для тикера, перейдите сюда. Интерфейс тикеров используется для получения последних цен транзакций валютных пар пакетно, а тикер — для получения последних цен транзакций отдельных валютных пар.
Пример параметра ответа цены последней сделки в разделе Тикеры
Каковы требования для создания API-ключа?
Для создания API-ключа требуется минимальный баланс активов под управлением (AUM) в размере 100 USD.
Для создания API-ключа требуется активы под управлением (AUM) более 100 USD (AUM > 100U)
Для мастер-аккаунтов или субаккаунтов разрешено создавать API-ключи только для аккаунтов с AUM > 100U
Примечание: Это требование применяется только к пользователям из определённых регионов
Примечание:
Если у вас есть вопросы по WebSocket или другим темам, связанным с API, перейдите по ссылке на статью и отсканируйте QR-код внизу статьи с помощью приложения OKX, чтобы присоединиться к группе и связаться с нашим специалистом по поддержке API.
Как сканировать: в приложении нажмите Меню > значок Сканировать и отсканируйте QR-код.