Поширені запитання про API на OKX

Що таке парольна фраза?

Це пароль, який ви ввели під час подання заявки на створення ключ API. Вам потрібно його запам’ятати. Якщо ви його забудете, то не зможете відновити, і потрібно буде створити новий ключ API.

Як створити ключ API демодиску?

Щоб торгувати під ключем API демодиску, потрібно створити ключ API на демодиску. Виконайте такі кроки:

Увійдіть у свій акаунт OKX > Торгівля > Демо-торгівля > Особистий центр > Створення ключа API для демо-акаунта > Почати демо-торгівлю.

Чи ключ API припиняє дію?

Якщо ключ API не прив’язаний до IP-адреси й має дозволи на транзакції або зняття коштів, його буде автоматично видалено через 14 днів неактивності. Ключі API не вважаються неактивними, якщо вони використовуються для виклику приватних інтерфейсів або інтерфейсів, пов’язаних з акаунтом, на яких потрібна верифікація особи, наприклад перегляд балансу акаунта, платіжних даних або розміщення ордерів.

Ключі API лише для читання, прив’язані до IP-адреси або певних дозволів, не припиняють дії.

Чи можна через інтерфейс розміщувати ордери в USDT або валютах?

Ні; у разі розміщення контрактних ордерів інтерфейс за умовчанням вибирає кількість контрактів. Якщо вам потрібно зробити розрахунки для конвертації між кількістю контрактів і монет, перейдіть в інтерфейс конвертації контрактів у монети тут.

Як дізнатися частоту коливання в інтерфейсі?

Інтерфейс не надає даних про підвищення або зниження ціни безпосередньо, але їх можна розрахувати за допомогою відповідної формули.

Величина зростання й падіння останньої ціни транзакції порівняно з ціною відкриття K-лінії 24 години тому/100% ціни відкриття K-лінії 24 години тому.

Наведені вище дані формули можна отримати через ринковий інтерфейс тут (last-open24h)/open24h.

Чим зумовлене повідомлення про помилку «51000: помилка параметра posSide» під час розміщення ордера?

Щоб отримати posMode, потрібно перевірити режим акаунта, режим купівлі та продажу / режим відкриття та закриття, який можна переглянути тут.

Примітка.

• У разі відкриття та закриття позицій і розміщення ордерів у контракті параметр posSide є обов’язковим, і вводиться значення «лонг» або «шорт».

• Якщо це режим купівлі та продажу, а також криптовалютна транзакція або транзакція з кредитним плечем, що здійснюється в режимі відкриття та закриття, на posSide підтримується лише чиста передача або відсутність передачі.

Під яким інтерфейсом можна отримати номінальну вартість контракту й мінімальну кількість ордера?

Ви можете скористатися інтерфейсом для отримання основної інформації про торгові продукти тут.

номінальна вартість контракту: ctVal, мінімальна кількість ордера: minSz.

Який формат instId?

Ви можете безпосередньо використати інтерфейс для отримання основної інформації про торгові продукти тут.

Приклад формату instId:

Монета/кредитне плече монети: BTC-USDT

Безстроковий контракт: стандарт монет: BTC-USD-SWAP, стандарт U: BTC-USDT-SWAP Усі літери повинні бути великими

Контракт розрахунків: стандарт валюти: BTC-USD-210326, стандарт U: BTC-USDT-210326 останні дві цифри року + поточний тиждень, наступний тиждень, поточний місяць, наступний місяць, поточний квартал або час наступного кварталу

Опціонні контракти: кол-опціони BTC-USD-210326-2000-C, пут-опціони BTC-USD-210326-2000-P

Як виставити стоп-лос і тейк-профіт?

Якщо ордер додано до тейк-профіту чи стоп-лосу, дивіться інтерфейс ордера тут: параметри масиву attachAlgoOrds.

Однак, якщо йдеться про окремий ордер «стоп-лос», дивіться інтерфейсу комісійних за стратегією тут.

Чому з’являється повідомлення про помилку під час виставлення тригерної ціни тейк-профіту та стоп-лосу: 51046, 51047, 51048, 51049?

Правила виставлення тригерної ціни стоп-лосу/тригерної ціни тейк-профіту — під час продажу тригерна ціна тейк-профіту більша за останню ціну транзакції, а тригерна ціна стоп-лосу менша за останню ціну транзакції; а під час купівлі тригерна ціна тейк-профіту менша за останню ціну транзакції, а тригерна ціна стоп-лосу більша за останню ціну транзакції.

У чому полягає «Помилка інтерфейсу 50102: строк дії запиту мітки часу минув»?

Ця помилка виникає, коли спливає строк дії мітки часу. Щоб синхронізувати місцевий час з часом нашого сервера, потрібно звернутися тут до інтерфейсу часу системи. Якщо зберегти різницю часу в межах 30 секунд, ця проблема може зникнути.

Примітка. Час у заголовку запиту часу поданий у форматі UTC0. Під час виклику інтерфейсу часу сервера час вказується в UTC+8.

У чому полягає «Помилка інтерфейсу 50101: ключ API не відповідає поточному середовищу»?

Вона пов’язана з невідповідністю між ключем API і поточним середовищем. Для звернень до реальних акаунтів потрібно використовувати ключ API реального акаунта, а значення параметра «х-симульована торгівля» в заголовку запиту повинно бути 0. Для звернень до демонстраційних акаунтів потрібно використовувати ключ API демоакаунта, а значення параметра «х-симульована торгівля» в заголовку запиту повинно бути 1.

У чому полягає «Помилка інтерфейсу 51010: запит не підтримується в поточному режимі акаунта»?

Вона пов’язана з режимом акаунта. Якщо ви хочете розмістити ордер з кредитним плечем або ордер на контракт з однією валютою, вам потрібно внести поправки на інші три режими, окрім спотового! Це можна зробити в налаштуваннях інтерфейсу тут, на сайті або в застосунку.

Примітка. Перший параметр треба встановити на сторінці або в застосунку; значення параметра в головному меню сторінки «Торгівля» — Режим акаунта.

У чому полягає «Помилка інтерфейсу 51121: Кількість ордера має бути кратною розміру лоту»?

У API контрактні ордери складаються в одиницях листів і повинні бути кратними мінімальній кількості ордера у валютній парі. Мінімальну кількість ордера можна отримати через поле minSz інтерфейсу продукту тут.

«Помилка зняття коштів 58207: адреси для зняття коштів немає в білому списку без перевірки». Чому в результаті перевірки за білим списком однаково повідомляється про помилку, коли вона закривається на сторінці зняття коштів?

Щоб зняти монети через інтерфейс API, необхідно додати адресу зняття на сторінці й перевірити кнопкою «Не перевірено Visa». Якщо перевірку за білим списком вимкнено на сторінці, це не вплине на функціонування інтерфейсу.

Що таке «Помилка інтерфейсу 50004: вичерпано час запиту кінцевої точки API» (не означає, що запит було виконано або не виконано, перевірте результат запиту)?

Помилка 50004 зазвичай виникає через надмірне навантаження на сервер. 08:00, 16:00 і 00:00 — це години стягнення комісії за використання капіталу щодня. Наразі спостерігається високе навантаження на сервер. У такі періоди транзакції рекомендується розподіляти. Якщо помилка 50004 проявляється в інші періоди, спробу можна повторити пізніше. Якщо ордер розміщено з помилкою 50004, вона не відображає фактичний результат запиту інтерфейсу. Запит може бути виконаним або невиконаним. Потрібно переглянути фактичний результат.

Примітка. Якщо у вас є інші запитання або запити щодо API, зв’яжіться з нами, зісканувавши цей код у застосунку.