Часто задаваемые вопросы по API (FAQ)

Binance
2018-06-05 09:38

Документация по APIНеофициальные примеры использования API 

Каковы ограничения?

Обзор
Существует три различных типа ограничений, каждый из которых может быть изменен в любое время:
  1. Строгие ограничения
  2. Ограничения ML (Machine Learning/машинного обучения)
  3. Ограничения WAF (Web Application Firewall/фаирвола веб-приложений)
Строгие ограничения:
  • 1200 единиц веса запроса в минуту (обратите внимание: этот показатель не обязательно соответствует 1200 запросам)
  • 50 ордеров за 10 секунд
  • 160 000 ордеров за сутки
Строгие ограничения доступны в конечной точке [/ api / v3 / exchangeInfo].
Ограничения машинного обучения:
Торговое поведение оценивается относительно среднего пользователя. В случае слишком сильных отклонений вы будете заблокированы на определенный срок: от 5 минут до 3 дней.
Предположим, ваш показатель свидетельствует о нарушении в торговле. Показатель вырастет в случае: 
  • постоянного «фронтраннинга», или «опережения на единицу» лучшей ставки бид/аск в книге ордеров;
  • массового создания ордеров и их очень быстрой отмены без исполнения;
  • низкого «уровня конверсии»; «уровень конверсии» – отношение количества сделок к общему количеству созданных и отмененных ордеров за сутки (количество сделок / (ордера + отмены));
  • низкого «веса»; «вес» – отношение общего количества активов в сделках к общему количеству созданных и отмененных ордеров за сутки (общее количество активов в сделках / (ордера + отмены));
  • если торговые пары с BNB в качестве базового или котируемого актива увеличивают показатель нарушений.
Мы не сможем дать вам более подробную информацию, чем та, что представлена выше. Пользователям предлагается разработать свою идеальную торговую систему экспериментальным путем или обсудить оптимальное поведение с другими пользователями API.
Ограничения WAF (Web Application Firewall/фаирвола веб-приложений)
Мы не предоставляем точных сведений о собственных правилах WAF, но если вы столкнулись с ошибкой HTTP 403, значит, вы нарушили его правило. Вероятнее всего, это связано с чрезмерным количеством запросов в течение 5 минут. При этом, если ваш запрос отнесли к категории вредоносных, это может стать причиной более длительной блокировки.

Ограничат ли мой аккаунт, API-ключ или IP-адрес в случае превышения лимитов?

В случае строгих ограничений превышение минутного лимита совокупного веса запросов (в настоящий момент – 1200) приведет к блокировке IP. Лимит ордеров (в настоящий момент – 50 за 10 секунд и 160 000 в сутки) будет зависеть от аккаунта. В случае превышения лимита ордеров пользователям также будет запрещено создавать новые ордера на сайте (или в других наших приложениях).
В случае лимитов машинного обучения к аккаунтам будут применяться ограничения. В случае ограничения пользователя системой машинного обучения причину и продолжительность можно будет узнать через конечную точку [/sapi/v1/account/status], указанную в документации API.
Ограничения фаервола веб-приложений будут применяться только по IP. Обычно блокировка WAF длится 5 минут. Однако, если сервер определит запрос пользователя как вредоносный, продолжительность может увеличиться.

Я был ограничен за превышение лимитов, но я исправил свой код. Снимут ли блокировку раньше?

Нет. Вы должны дождаться окончания блокировки.

Я вижу ошибку HTTP 403 при использовании API. Почему?

Вы нарушили правила WAF (брандмауэра веб-приложений), вероятнее всего, нарушив ограничение скорости или отправив вредоносный запрос, описанный в разделе ограничений в данном документе. Обычно продолжительность подобной блокировки составляет 5 минут.

Почему мои WebSocket соединения сбрасываются/отключаются?

Активные WebSocket соединения получают пинг каждые 3 минуты. Если мы не получим правильно сформулированный отклик, соединение будет прервано.
В случае потоков пользовательских данных, если сообщение об активном соединении не будет получено хотя бы раз в 60 минут, срок действия listen key заканчивается. Вы сможете найти подробное описание в документации API.

Я использую сторонний сервис/wrapper, и он не работает. Вы можете помочь?

К сожалению, мы не поддерживаем сторонние сервисы или инструменты. Пожалуйста, обратитесь за помощью в компанию и/или к разработчикам.
Кроме того, вводить ваши API-ключи Binance и/или секретные ключи на любой сторонней платформе небезопасно. Однако вы можете пользоваться подобными сервисами по своему усмотрению.
Также обращаем ваше внимание на то, что мы не оказываем общую поддержку программирования.

Я ничего не менял, но внезапно стал получать сообщения об ошибках. Что произошло?

К сожалению, мы не можем предоставить поддержку по вопросам, связанным с вашим личным проектом. Если вы используете сторонний wrapper/ инструмент, обратитесь за помощью в службу поддержки/разработки компании.

Мне нужен доступ к секретному ключу, но на экране отображается лишь «***». Как мне его получить? 

Из соображений безопасности и в соответствии с условиями проекта, секретные ключи доступны только во время создания API-ключа. После этого ключ всегда скрыт. Если вы потеряли его или не зафиксировали, вам придется создать новый API-ключ и использовать новый ключ с новым секретным ключом.

Могу ли я увеличить свои лимиты или выделенный поток/пропускную способность?

К сожалению, в настоящее время мы не предлагаем подобную услугу. Вы должны иметь возможность работать с нашими ограничениями. 

Мой API-ключ исчез. Помогите!

Существуют лишь два возможных объяснения для «исчезновения» API-ключа.
  1. Если вы были неактивны в последнее время и использовали API до 7 марта 2018 года, возможно, ваши API-ключи были удалены для обеспечения безопасности вашего аккаунта.
  2. Если же вы решили отключить свой аккаунт, это приведет к удалению всех без исключения активных API-ключей.
Вы сможете беспрепятственно создать новые API-ключи.

Я вижу ошибку «Error -1021» (Сообщение: Timestamp for this request is outside of the recvWindow). Как это исправить?

Обычно эта ошибка возникает только в случае десинхронизации времени сервера и системного времени. Возможно, вам потребуется синхронизировать системные часы. Этот процесс зависит от операционной системы.
В случае Windows вы по собственному усмотрению можете воспользоваться таким инструментом, как Atomic Clock. Пользователи Linux и Mac могут попробовать совершить синхронизацию через «ntpdate» в командной строке.
Если проблема не решена, вероятно, она связана с задержкой (проблемой в сети). Может потребоваться настройка recvWindow.

Могу ли я узнать о новых функциях API?

Если вы не нашли искомые функций в нашей документации, можно предположить, что мы не оказываем их поддержку. Если вы желаете предложить новую функцию, вы можете обратиться в службу поддержки со своим предложением, и мы рассмотрим его.

Я считаю, что в работе API есть проблема. Как сообщить о ней?

Если вы считаете, что проблема связана с системой, а не с вашим проектом, предоставьте доказательства в поддержку своей претензии в нашем API чате в Telegram. Мы во всем разберемся. Обратите внимание: мы не считаем неубедительные сообщения полноценными претензиями. Более того, в данной группе не оказывают официальную поддержку средств программирования; это группа сообщества пользователей Binance API.