1. Откройте веб-сайт Gate. Наведите курсор поверх значка профиля, чтобы развернуть меню, и нажмите "Управление API".
2. Нажмите на кнопку “Создать API ключ” на странице.
3. Создайте API ключ
Создание ключа APIv2
① Разрешения IP: Вы можете выбрать, привязывать ли IP.
Примечание: Если вы выберете не привязывать, ключ API разрешит доступ с любого адреса и будет действителен в течение 90 дней.
② Тип ключа API: Выберите ключ API версии 2. Каждый пользователь может создать только 1 набор, и новый будет перезаписывать предыдущий. Затем вы можете установить: “Чтение и запись” или “Только для чтения”.
③ Подтвердите данные и нажмите “Отправить”, чтобы отправить его.
Примечание: Срок действия предыдущего API-ключа истекает сразу после создания нового.
API-ключи можно использовать для запроса информации об учетной записи, а также для торговли, вывода средств и других операций.
Пожалуйста, храните свои API-ключи в безопасности и никогда не делитесь ими с другими!
Создание ключа APIv4
① Примечания к ключу API: Помогает идентифицировать и запомнить ключ.
② Разрешения IP: Вы можете выбрать, привязывать ли IP. Если не привязывать — ключ действителен 90 дней.
③ Тип ключа API: Выберите API версии 4.
④ Тип учетной записи: Классическая / Маржинальная торговля / Тестовая сеть.
⑤ Разрешения: “Чтение и запись” или “Только для чтения”. Валютная пара обязательна.
⑥ Подтвердите данные и нажмите “Отправить”.
4. Напоминание о риске появится после того, как вы нажмете “Отправить”.
Пожалуйста, внимательно прочитайте предупреждения и нажмите “Я принимаю” или “Отмена” для продолжения.
Введите пароль фонда, выберите методы двухфакторной аутентификации и нажмите “Подтвердить” для продолжения.
5. После создания API-ключа вы можете просматривать, редактировать или удалять его.
6. Примечание:
① Ключи APIv2/4 поддерживают ввод и вывод средств.
Для вывода через API вы должны использовать адрес, по которому уже производился ручной вывод, и с момента последнего вывода должно пройти более 24 часов.
② Различия между APIv2 и APIv4:
• APIv2 и APIv4 — независимые ключи.
• APIv2 подходит только для спотовой торговли, а APIv4 поддерживает спот, маржу и фьючерсы.
• Ключи APIv2 создаются внизу страницы "APIv2", а ключи APIv4 — в "Личный центр" → "Субаккаунт и API" → "APIv4 ключи".
Выбирайте подходящий тип API в зависимости от ваших нужд. Следите за обновлениями функций в официальных статьях.
Если статья не помогла решить проблему, создайте тикет и укажите следующую информацию:
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 — будет отклонён.
