Часто задаваемые вопросы
Вопрос 1: Не удается вывести средства даже после добавления адреса в белый список
Причины:
1. Белый список на странице вывода и белый список вывода API независимы друг от друга.
2. Адреса, добавленные через страницу [Вывод] > [Управление адресами вывода], не применимы для вывода через API.
Решение:
- Перейдите на страницу управления белым списком для API: https://www.coinex.com/apikey
- Добавьте адрес вывода в белый список, предназначенный для API.
Вопрос 2: Ошибка access_id not exist
Распространенные причины:
(1) Недавно созданным API-ключам обычно требуется около 10 минут для активации. Вызов API сразу после создания может вызвать эту ошибку.
(2) Неверный access_id.
(3) Недействительная проверка подписи.
(4) Неверный заголовок запроса.
Решение:
(1) Обратитесь к [Документации по API CoinEx], чтобы узнать, как формировать HTTP-запрос с аутентификацией.
(2) Пример:
Вопрос 3: Ошибка 3008/4001 service unavailable
Причина: эта ошибка может возникнуть при отмене ордеров в периоды высокой нагрузки на сервер.
Решение:
(1) Отдавайте приоритет отмене важных ордеров.
(2) Повторите попытку через 1-2 секунды.
(3) Если в ответе возвращается code: 0, но ордер не отменен:
- Сохраните полный запрос и ответ.
- Обратитесь в службу поддержки и предоставьте информацию об основном аккаунте/субаккаунте для получения помощи.
Вопрос 4: Ошибка Invalid Parameter
Причина: обычно ошибка возникает, когда переданные параметры не соответствуют типам, указанным в документации API.
Решение: на примере конечной точки POST /spot/cancel-order:
(1) Тщательно сверяйте имена и типы параметров с документацией API.
(2) Обратите особое внимание на различия между числовыми и строковыми типами.
Вопрос 5: Каковы ограничения скорости (rate limits) для API?
Ограничения скорости делятся на краткосрочные и долгосрочные, которые можно определить через заголовок ответа (Response Header):
1. Краткосрочные ограничения скорости: если значение X-RateLimit-Limit больше 0, краткосрочное ограничение скорости не было активировано.
Краткосрочное ограничение использует механизм «token bucket», при этом для основного и субаккаунтов действуют независимые ограничения.
- Распространенная ошибка после активации: code: 213, 4213
- Сообщение: Please don't try too frequently.
2. Долгосрочные ограничения скорости: если возвращается X-RateLimit-LongPeriod-{period}-Remaining, значит активированы долгосрочные ограничения скорости. Система оценивает объем и качество запросов пользователя, чтобы решить, накладывать ли ограничения на общее количество запросов в течение более длительного периода. После активации скорость запросов для всех конечных точек (кроме отмены ордеров) будет ограничена 1 запросом в секунду.
- Распространенная ошибка: сode: 213, 4213
- Для дополнительной проверки необходимо использовать заголовки ответа (Response Header).
Другие распространенные вопросы
Вопрос 1: Как уменьшить задержку API-запросов?
Серверы развернуты на AWS Tokyo и поддерживают межрегиональную балансировку нагрузки. Вы можете выбрать ближайший регион для минимизации задержки.
Доступные зоны:
- ap-northeast-1a
- ap-northeast-1c
- ap-northeast-1d
Вопрос 2: Требуется ли 2FA для вывода средств через API?
В целях безопасности:
1. Перед использованием вывода через API вы должны войти в систему и авторизоваться через 2FA.
2. После добавления адресов вывода в [Белый список вывода] вы можете совершать вывод через API без повторной проверки 2FA.
Вопрос 3: Можно ли добавлять адреса в белый список для вывода через API?
В настоящее время добавление адресов в белый список для вывода через API не поддерживается. Перейдите в [Управление API] > [Белый список вывода] для ручного или массового добавления адресов.
Вопрос 4: Ошибка Signature incorrect
Решения:
1. Проверьте, правильно ли настроены access_id и secret_key.
2. Убедитесь, что тело запроса и параметры, используемые для генерации подписи, полностью совпадают. Предварительно обработайте параметры запроса как строки и убедитесь, что они не изменились до и после подписи.
3. Если для подписи используется сторонняя библиотека, убедитесь, что она настроена корректно.
Вопрос 5: Ошибка Tonce check error - Correct tonce should be within one minute of the current time
Решение:
(1) Убедитесь, что временная метка (timestamp) для всех API-запросов указана в миллисекундах.
Пример:
(2) Убедитесь, что на вашем компьютере включена автоматическая синхронизация времени.
Вопрос 6: Как получить актуальный доступный баланс и чистую стоимость фьючерсного счета?
(1) Используйте конечную точку /assets/futures/balance для получения поля available, которое показывает текущий доступный баланс фьючерсного счета.
(2) Конечные точки API в настоящее время не поддерживают возврат чистой стоимости счета. Чистая стоимость — это сумма реализованной и нереализованной прибыли и убытков.
(3) Нереализованные прибыль и убытки не являются фиксированными значениями и могут колебаться с изменениями позиций. Для получения точных результатов требуются ручные расчеты.
(4) Формулы расчета можно найти в документации «Как рассчитать эквити и PNL в линейных контрактах».
Вопрос 7: Как обрабатывать данные, возвращаемые WebSocket API?
WebSocket API возвращает данные в сжатом формате JSON, который необходимо распаковать перед использованием (например, с помощью модуля gzip).
Распространенная ошибка:
utf-8 codec can't decode byte 0x8b in position 1: invalid start byte
Вопрос 8: Что делать, если сторонняя налоговая платформа выдает ошибку?
Работа сервисов V1 была прекращена 25.09.2024. Ошибка может быть вызвана тем, что платформа не обновила код до версии V2. Пожалуйста, обратитесь за помощью к соответствующей налоговой платформе.
Вопрос 9: Как подтвердить успешное соединение с WebSocket?
При успешной подписке вы получите ответ с результатом подписки.
После этого вы будете получать обновления подписанных сообщений:
Вопрос 10: Почему соединение WebSocket автоматически разрывается? Как поддерживать соединение?
(1) Разрывы соединения WebSocket обычно происходят из-за проблем с сетью. Пожалуйста, проверьте стабильность интернет-соединения.
(2) Для поддержания соединения WebSocket вам необходимо использовать server.ping для поддержания его активности.
(3) Если в течение 1 минуты нет связи с сервером, соединение WebSocket автоматически разрывается. Рекомендуется устанавливать интервал отправки через интерфейс ping не более 60 секунд, чтобы поддерживать соединение активным.
Для других ошибок API нажмите ЗДЕСЬ, чтобы связаться со службой поддержки и предоставьте следующую информацию для решения проблемы:
(1) Электронная почта основного аккаунта или имя субаккаунта.
(2) Полные детали запроса и ответа.
Важно: НЕ указывайте access_id и secret_key в сообщениях об ошибках, чтобы избежать возможных потерь.