1. Відкрийте сайт Gate. Наведіть курсор на іконку профілю, щоб розгорнути меню, і натисніть "Управління API".
2. Натисніть на сторінці "Створити ключ API".
3. Створення ключа API
Створіть ключ APIv2:
① Дозволи IP: Ви можете обрати, чи прив’язувати IP.
Примітка: якщо не прив’язати IP, ключ буде дійсний 90 днів і дозволить доступ з будь-якої адреси.
② Тип ключа API: Виберіть API v2 Key. Кожен користувач може створити лише один ключ, новий перезапише попередній.
③ Дозволи: "Читання і запис" або "Тільки читання".
④ Підтвердьте дані та натисніть "Надіслати".
Примітка: Попередній ключ API одразу стає недійсним після створення нового.
API-ключі можна використовувати для запиту інформації, торгівлі, виведення коштів тощо.
Зберігайте ключі в безпеці та не передавайте їх іншим!
Створення ключа APIv4
① Коментар до ключа API: допомагає ідентифікувати ключ.
② Дозволи IP: Оберіть, чи прив’язувати IP. Якщо ні — ключ дійсний 90 днів.
③ Тип ключа API: Виберіть API v4 Key.
④ Тип рахунку: Класичний / Маржинальна торгівля / Testnet.
⑤ Дозволи: "Читання і запис" або "Тільки читання". Примітка: валютна пара не може бути порожньою.
⑥ Підтвердіть дані та натисніть "Надіслати".
4. Після натискання "Надіслати" з’явиться вікно з нагадуванням про ризики.
Уважно прочитайте його та натисніть "Я приймаю" або "Скасувати", щоб продовжити.
Введіть пароль фонду, виберіть метод 2FA-аутентифікації, натисніть "Підтвердити".
5. Після створення ключа API ви зможете переглядати, редагувати або видаляти його.
6. Зверніть увагу:
① Ключі APIv2/4 мають дозвіл на поповнення та виведення коштів.
Щоб використовувати API для виводу, необхідно використовувати адресу, яка раніше використовувалася вручну, і з моменту останнього ручного виводу має пройти щонайменше 24 години.
② Різниця між APIv2 та APIv4:
• Ключі APIv2 та APIv4 є незалежними.
• APIv2 підтримує лише спотову торгівлю.
• APIv4 підтримує спотову, маржинальну і контрактну торгівлю.
• Створення APIv2 — внизу сторінки "APIv2 Keys".
• APIv4 створюється в розділі “Особистий кабінет” → “Субрахунок і API” → “Ключі APIv4”.
Виберіть APIv2 чи APIv4 залежно від ваших потреб. Перевіряйте статтю на наявність оновлень.
Якщо ця стаття не дала відповіді, відкрийте тікет. У тікеті вкажіть:
- Ваш UID
- URL початкового запиту
- Параметри та детальний опис запиту
- Тип API (спотова чи маржинальна торгівля, mainnet чи testnet)
- Мова програмування (якщо є — додайте код запиту)
- Чи використовуєте SDK (якщо так, опишіть, як саме або залиште коментар у GitHub)
7. Документація API доступна в розділі “Сервіси” – “Розробникам (API)” внизу сторінки.
8. Обмеження частоти запитів
| Markets | Endpoints | Limits | Based On | Include |
|---|---|---|---|---|
| All public endpoints | Public endpoints | 200r/10s per endpoint | IP | Orderbook, Candlestick, Ticker, etc. |
| Wallet | Private endpoints | Withdrawal(POST /withdrawals) : 1r/3s UID transfer(POST /withdrawals/push) 1r/10s Transfer between trading accounts (POST /wallet/transfers) 80r/10s Transfer between main and sub accounts (POST /wallet/sub_account_transfers) 80r/10s Transfer from a sub-account to another sub-account (POST /wallet/sub_account_to_sub_account) 80r/10s Retrieve user's total balances (GET /wallet/total_balance) 80r/10s Retrieve sub account balances (GET /wallet/sub_account_balances) 80r/10s Query sub accounts' margin balances (GET /wallet/sub_account_margin_balances) 80r/10s Query sub accounts' futures account balances (GET /wallet/sub_account_futures_balances) 80r/10s Query subaccount's cross_margin account info(GET /wallet/sub_account_cross_margin_balances) 80r/10s The Others: 200r/10s per endpoint |
UID | Withdrawal. Query personal account balance. Query subaccount balance. |
| Spot | Private endpoints | The rate limit for batch/single order placement and amend an order are total of 10r/s (UID+Market) The rate limit for batch/single order cancellation is total of 200r/s The Others: 200r/10s per endpoint |
UID | Spot order placement and cancellation. Trade history and fee rates. |
| Perpetual Futures | Private endpoints | The rate limit for batch/single order placement and amend an order are total of 100r/s The maximum rate limit for the order cancellation (bulk/single) is 200r/s The Others: 200r/10s per endpoint |
UID | Futures order placement and cancellation Trade history and fee rates |
| Delivery | Private endpoints | The maximum rate limit for the order placement (bulk/single) is 500r/10s The maximum rate limit for the order cancellation (bulk/single) is 500r/10s The Others: 200r/10s per endpoint |
UID | Order placement and cancellation |
| Options | Private endpoints | The maximum rate limit for the order placement (bulk/single) is 200r/s The maximum rate limit for the order cancellation (bulk/single) is 200r/s The Others: 200r/10s per endpoint |
UID | Order placement and cancellation |
| Subaccount | Private endpoints | 80r/10s per endpoint | UID | Create a sub-account. Retrieve the list of sub-accounts. Disable or enable API key for a sub-account. |
| Unified | Private endpoints | Borrow or repay 15/10s | UID | Borrow or repay(POST /unified/loans) |
| Other Private endpoints | Private endpoints | 150r/10s per endpoint | UID | Earning, collateral etc |
Обмеження частоти діє окремо для кожного субрахунку або головного акаунту.
WebSocket:
- Обмеження повідомлень на сервер: немає
- Кількість підключень на IP: ≤ 300
УВАГА:
Якщо обмеження перевищується неодноразово:
- Запит < burst rate — буде затримка
- Запит > burst rate — запит буде відхилено
