Поширені запитання щодо 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-адреси або конкретних дозволів, не мають терміну дії.
Що таке дозволи Позика, заробляти / отримувати та переказувати?
Переказувати: Дозволяє ключу переказувати кошти між вашими рахунками. Доступно для всіх рахунків.
Позика: Дозволяє ключу позичати, погашати та керувати позиками. Видно лише за наявності у вашому акаунті необхідної функціональної можливості.
Заробляти / отримувати: Дозволяє ключу підписуватися на продукти Earn та викупати їх. Видно лише, якщо ваш акаунт має необхідну функціональну можливість.
Якщо ваш API Key раніше мав увімкнені дозволи на Торгівлю, усі три дозволи будуть автоматично активовані після цього оновлення. Ніяких ручних налаштувань не потрібно.
Чи можна розміщувати ордери в одиницях валюти при розміщенні ордерів через інтерфейс?
Ні; для ордерів на контракти інтерфейс за замовчуванням показує кількість у контрактах. Якщо вам потрібно розрахувати конвертацію між кількістю контрактів і монетами, ви можете звернутися до інтерфейсу конвертації контрактів у монети тут.
Як отримати коефіцієнт коливання інтерфейсу?
Інтерфейс не може безпосередньо отримати збільшення або зменшення ціни, але це можна обчислити за допомогою формули.
Зростання та падіння вартості останньої ціни транзакції порівняно з ціною відкриття 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 не існує»?
Ця помилка зазвичай виникає, коли домен вашого акаунта не відповідає вашому регіону.
Для користувачів EEA змініть, будь ласка, доменне ім'я вашого 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)
Для головних акаунтів або субакаунтів лише акаунти з AUM > 100U мають право створювати API-ключі
Примітка: Ця вимога застосовується лише до користувачів у певних регіонах
Примітка:
Якщо у вас є питання щодо WebSocket або інших тем, пов’язаних з API, натисніть на посилання статті та відскануйте QR-код у нижній частині статті за допомогою застосунку OKX, щоб приєднатися до групи та звернутися до нашого спеціаліста з підтримки API.
Як сканувати: у додатку натисніть Меню > іконку Сканування та відскануйте QR-код.