Як використовувати API

2026-02-11 UTC
640 156 Прочитайте
134

1. Відкрийте сайт Gate. Наведіть курсор на іконку профілю, щоб розгорнути меню, і натисніть "Управління API".

1

2. Натисніть на сторінці "Створити ключ API".

2

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)” внизу сторінки.

7

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 — запит буде відхилено


Наданий тут зміст призначений лише для ознайомлення та освітніх цілей і не є фінансовою, інвестиційною, торговою чи юридичною порадою, а також не є пропозицією або закликом купувати чи продавати будь-які цифрові активи. Gate не надає жодних прямих чи непрямих заяв або гарантій щодо точності, повноти чи актуальності інформації, що міститься тут. Функціонал продукту, інтерфейси, правила та структура комісій можуть оновлюватися або змінюватися у будь-який час. Для отримання найактуальнішої інформації звертайтеся до останніх оголошень і фактичних даних, що відображаються на платформі Gate.
Інвестиції в цифрові активи пов'язані зі значними ризиками, а ціни можуть суттєво коливатися. Ви можете втратити всю суму своїх інвестицій. Приймайте рішення обережно, враховуючи власний фінансовий стан і рівень толерантності до ризику після повного розуміння супутніх ризиків. За потреби рекомендується звернутися до незалежного професійного фінансового чи юридичного радника.
Щоб отримати додаткову інформацію про потенційні ризики, зверніться до Розкриття інформації про ризики та Угоди користувача Gate.
Зареєструйтесь зараз, щоб отримати шанс виграти до $10,000!
signup-tips