Binance com 403 error the request could not be satisfied

How To Fix Binance 403 Error

A quick fix to the Binance 403 error.

While Binance is one of the top cryptocurrency exchanges of 2022, it isn’t without its errors, with error code 403 impacting some users trying to use the platform. Similar to Coinbase connection issues, Binance too is vulnerable to occassional server meltdowns

Binance is a leading crypto exchange that recentlu launched its Binance NFT marketplace. Being one of the prominent crypto exchanges, it allows users and investors to trade 500+ cryptocurrencies across all domains.

However, there might be times when Binance is susceptible to occasional downtime, just like the Coinbase server issues. In this case, Binance may show users the error code 403 to prevent them from accessing the website. Let’s take a look at how Binance’s error 403 can be resolved in a few quick steps.

How To Fix Binance 403 Error?

A 403 error usually occurs when a server doesn’t allow a user to access a given webpage. To fix this error, you may need to follow these simple tricks.

• Try refreshing the page. A random 403 error may pop up due to a temporary server glitch. Refreshing the page may help sort it.

• Clear the cache memory of your phone/desktop’s browser may also help eliminate the 403 error.
• According to a Reddit user, Binance 403 error may also pop up due to depositing too much money without verifying the ID. Verify your credentials with Binance before proceeding ahead to avoid the 403 error.
• Check with Binance’s official website and see if their server is experiencing its periodic maintenance or downtime. This may also be the reason why you are getting a 403 error.
• Using a different browser or waiting 30 minutes after refreshing the page may also help eliminate the 403 error.

What Is Binance 403 Error?

A Binance 403 error is a temporary error that may pop up when a server is unable to process the request initiated by the user.

It might happen due to several reasons, such as when an exchange is undergoing a specified downtime orits periodic server maintenance.

It is always better to check the status page of the particular crypto exchange to stay on top of all details and notices.

Источник

Ошибка 403 пот подключении к сайту, как её исправить?

26 ответов

Ставьте VPN и нет не когда проблем

главное чтоб впн не закинул в запрет юрисдикцию. уже были тут примеры, кто впн подключал и попадал к примеру на США — у Америки свой домен Бинанс и на обычном Бинансе словит блок. или по фьючерсам например — не во всех странах можно фьючерсами торговать — тоже можно с впн блок на торги поймать.

первый раз слышу 2 года на впн сижу

Я пробовал пару раз, мне блочили торговлю, каждый из этих раз)

хз может впн левый какой

здесь прям писали. не так давно и не один раз.. как раз под участившиеся случаи «ошибка 403». блок на торги и требование проходить полную верификацию.

чего далеко ходить. я такое поймал на прошлой неделе. не посмотрел что впн на сша переключился

финляндия южная корея все норм

сша запрещенная юрисдикция. у них отдельный бинанс

Ага типо аккаунт,подозрительный айпи и тд.в целях безопасности и тд

ну я и говорю. если в запрет юрисдикцию не попасть, то норм. если.

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

Ну вот если я включаю ВПН не выходя из приложения, то норм, можно торговать. А тогда я пробовал ВПН из-за ошибки 403, там нужно было логиниться, и почему то торговать было нельзя, после входа, сообщение выскакивало по этому поводу.

Все жалуются что там якобы бот и ничего не отвечает,много таких жалоб в основном!

ну вообще да. подозрительно. когда в моменте коротком времени пользователь заходит из разных стран. если как Эдвард пишет, пользуется давно и постоянно, непрерывно — это нормально. а если из за ошибки, которая решается простым действием — сменой источника интернета буквально на несколько секунд, постоянно менять «страну пребывания» через впн, логично могут заподозрить неладное. и блокнуть до выяснения.

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

Источник

403 error binance что делать

Frequently Asked Questions

Posted request, but faced 403 ERROR.#

Solution: Please carefully check your request path is following document, for example:

Posted request, but faced error with code «100001001».#

• Please check if you used GET, POST method should be used.
• Please check if you didn’t put content-type: application/json in request header
• Please check if you didn’t post body in request

Posted request, but faced error with code «400002»#

Solution A#

Please check if your sign logic is incorrect. You can test with below parameters:

The generated payload must be (there MUST be one new line at the end):

Signature Should be:

Solution B#

Please check if your json request body used ‘, should use «

Solution C#

Please check if your code changed the request json body after signing. Some may reformat the json.

Solution D#

Please check if you made the signature to upper case

Posted request, but faced error with code «400003»#

• Please check the request header field ‘BinancePay-Timestamp’, it should be UnixTimestamp in milliseconds, not in seconds.
• Please check if the request timestamp was within 1s to Binance Server.

Failed to verify the signature in webhook notification#

Solution A#

Please check if your sign logic is incorrect. Test your code logic with these parameters, if it’s not successful, then you need double check your code logic.

Источник

Ошибка HTTP 403 блокирует доступ к сайту – как выяснить, почему

Ошибка 403 Forbidden – это код состояния HTTP, который означает, что доступ к странице или ресурсу, который вы пытались открыть, по какой-то причине абсолютно запрещен.

Различные веб-серверы сообщают об ошибке 403 по-разному, большинство из которых похожи на те, что мы перечислили ниже. Иногда владелец веб-сайта настраивает уникальную форму отображения HTTP-ошибки 403 Forbidden, но это встречается не так уж часто.

Как появляется ошибка 403

Это наиболее распространенные воплощения ошибки 403:

403 Forbidden HTTP 403 Запрещено: у вас нет прав доступа к [каталогу] на этом сервере Запрещено Ошибка 403 Ошибка HTTP 403.14 – запрещено Ошибка 403 – Запрещено Ошибка HTTP 403 – запрещено

Ошибка 403 Forbidden отображается внутри окна браузера, как обычная веб-страница. Ошибка 403, как и все ошибки этого типа, могут быть обнаружены в любом браузере в любой операционной системе.

В Internet Explorer сообщение Сайт отказался показать эту веб-страницу указывает на ошибку 403 Forbidden. Только проверьте, в строке заголовка IE должно быть написано 403 Forbidden или что-то подобное.

Ошибка 403, получаемая при открытии ссылок с помощью программ Microsoft Office, генерирует сообщение «Невозможно открыть [url]». Не удается загрузить запрошенную вами информацию в программу MS Office».

Центр обновления Windows также может сообщать об ошибке HTTP 403, но он будет отображаться его код ошибки 0x80244018 или со следующим сообщением: WU_E_PT_HTTP_STATUS_FORBIDDEN.

Причина ошибок 403 Forbidden

Ошибки 403 почти всегда вызваны тем, что вы пытаетесь получить доступ к тому, к чему у вас нет доступа. Ошибка 403, по сути, говорит: «Уходи и не возвращайся сюда».

Веб-серверы Microsoft IIS предоставляют более конкретную информацию о причине ошибок 403, добавляя после 403 числовой суффикс, как в HTTP-ошибке 403.14, это означает, что в доступе к списку каталогов отказано. Вы можете увидеть полный список на сайте Microsoft.

Как исправить ошибку 403 Forbidden

Проверьте наличие ошибок URL и убедитесь, что вы указываете реальное имя и расширение файла веб-страницы, а не просто каталог. Большинство веб-сайтов настроены на запрет просмотра каталогов, поэтому сообщение 403 Forbidden при попытке отобразить папку вместо конкретной страницы является нормальным и ожидаемым.

Это, безусловно, самая распространенная причина, по которой веб-сайт возвращает ошибку 403 Forbidden. Убедитесь, что вы полностью изучили эту возможность, прежде чем тратить время на устранение неполадок ниже.

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

Очистите кеш вашего браузера. Проблемы с кэшированной версией просматриваемой страницы могут вызывать ошибку 403.

Войдите на сайт, предполагая, что это возможно и уместно. Сообщение 403 Forbidden может означать, что вам необходим дополнительный доступ, прежде чем вы сможете просматривать страницу.

Как правило, веб-сайт выдает ошибку 401, когда требуется специальное разрешение, но иногда вместо этого используется 403 Forbidden.

Очистите файлы cookie вашего браузера, особенно если вы обычно заходите на этот сайт без проблем.

Пока мы говорим о файлах cookie, убедитесь, что они включены в вашем браузере или, по крайней мере, для этого веб-сайта, если вы действительно вошли в систему для доступа к этой странице. В частности, ошибка 403 Forbidden указывает, что файлы cookie могут быть использованы для получения надлежащего доступа.

Свяжитесь с сайтом напрямую. Возможно, ошибка 403 Forbidden является системной ошибкой, её видят все остальные, и веб-сайт ещё не знает об этой проблеме.

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

Обратитесь к поставщику услуг Интернета, если вы всё ещё получаете ошибку 403, особенно если вы уверены, что веб-сайт работает у других прямо сейчас.

Вполне возможно, что ваш общедоступный IP-адрес или весь ваш интернет-провайдер попал в черный список, что может привести к ошибке 403 Forbidden, обычно на всех страницах одного или нескольких сайтов.

Вернитесь позже. После того, как вы убедились, что страница, к которой вы обращаетесь, правильная и что ошибка HTTP 403 видна не только вам, просто посетите страницу позже, когда проблема будет устранена.

Ошибки подобные 403 Forbidden

Следующие сообщения также являются ошибками на стороне клиента и связаны с ошибкой 403 Forbidden: 400 Bad Request, 401 Unauthorized, 404 Not Found и 408 Request Timeout.

Также существует несколько кодов состояния HTTP на стороне сервера, например, популярная 500 Internal Server Error.

Источник

Как исправить ошибку 403 на сайте, способы устранения ошибок

Ошибка сервера 403 (Forbidden Error) означает, что вам запрещен доступ к странице, файлу или папке, URL которых вы ввели в адресной строке. Причин может быть много:

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

Точно определить, что именно вызывает ошибку, сложно — в сообщении о ней обычно нет никакой полезной информации. Ниже мы описываем, что можно сделать для устранения ошибки 403 Forbidden в наиболее распространенных случаях.

Как исправить ошибку 403 владельцу сайта

Если вам поступают жалобы от посетителей сайта о 403 ошибке, прежде всего убедитесь, что ее причина не на стороне пользователя. Возможно, посетитель написал URL с ошибкой или находится в стране, в которой запрещен ваш сайт. Полный перечень причин смотрите в разделе «Что делать пользователю при появлении 403 ошибки».

Если причина все-таки в сайте, последовательно проверьте пункты ниже.

Расположение и имя индексного файла

Индексный файл открывается первым при обращении к сайту, и если сервер его не находит — выдается ошибка 403 forbidden. Проверьте, чтобы:

• файл назывался правильно. В зависимости от CMS это может быть index.php, index.html или index.htm;
• файл лежал в корневом каталоге или, если речь о поддомене — в корневом каталоге поддомена.

Права доступа

Если вы выставили неправильные права доступа на папку или файл, например, вместо «4» (чтение) поставили «0» (запрет доступа), то посетителю будет выдаваться ошибка сервера 403 Forbidden. Проверьте, какие права стоят в админке сайта:

• на папки стандартно должен быть доступ вида 755;
• на файлы — 644.

Уточните у разработчика сайта, какие права нужны для той папки или файла, по которой выдается 403 ошибка.

Плагины WordPress

На сайтах с CMS WordPress причиной ошибки с кодом 403 могут стать некорректно работающие плагины. Чтобы быстро проверить, в этом ли причина, сделайте следующее:

• С помощью панели управления хостингом или FTP найдите раздел wp-content.
• В нем вам понадобится директория plugins. Переименуйте папку, но так, чтобы вы потом могли найти ее и восстановить прежнее название.
• После переименования все плагины wordpress перестанут работать.
• Теперь откройте страницу, на которой появлялось сообщение о 403 ошибке. Если страница теперь нормально загружается, причина, скорее всего, в одном из плагинов.
• Переименуйте папку с плагинами обратно, после чего последовательно отключайте плагины по одному (можно таким же способом, как выше — переименовывая его папку) и проверяйте, исчезла ли после этого ошибка.

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

Другие причины ошибки 403

Иногда причиной появления ошибки сервера 403 может стать:

• Неправильное расположение файлов сайта. Например, вы могли при работе с FTP случайно перенести файлы из корневой папки во вложенную директорию. Проверьте, чтобы файлы располагались так, как требует CMS и структура хостинга.
• Неправильные настройки .htaccess (если на хостинге используется Apache-сервер). Переименуйте файл .htaccess, например, в .htaccess-старый, и он перестанет восприниматься сервером. Если после этого ошибка исчезла или изменился ее код — дело в директивах, прописанных в .htaccess. Исправить их поможет разработчик сайта или другой веб-программист.
• Блокировка сайта на уровне хостинга. Хостинг-провайдер может заблокировать сайт из-за нарушений договора, превышения ограничений по тарифу и других причин. Проверьте, получали ли вы соответствующее уведомление на почту.
• Блокировка по IP. Возможно, IP-адрес посетителя находится в списке заблокированных или не добавлен в список разрешенных для подключения. Такие ограничения обычно ставят на доступ к страницам админки сайта. Проверьте настройки доступа.
• Блокировка брандмауэром ModSecurity. Это ПО блокирует действия пользователей, которые считает вредоносными, и выдает в ответ на них 403 ошибку. Иногда ModSecurity ошибается и блокирует вполне добропорядочных посетителей. Добавьте в него исключение, если у вас VPS или выделенный сервер, или обратитесь с этой просьбой к хостеру, если сайт на виртуальном хостинге.

Что делать пользователю при появлении 403 ошибки?

Причина проблемы может находиться на стороне посетителя, а не сайта. Что может сделать пользователь, чтобы исправить ошибку сервера 403 forbidden:

• Проверить правильность URL. Причина может быть в элементарной опечатке.
• Обновить страницу с помощью Ctrl F5. Это действие — универсальная первая помощь при любых проблемах с отображением сайта в браузере. Возможно, какие-то неверные данные закешировались, а при обновлении по Ctrl F5 вы игнорируете кэш браузера и загружаете страницу с сайта напрямую. Можно также почистить кэш.
• Почистить cookie. В куках могут храниться устаревшие данные авторизации, которые сервер не принимает и отвечает ошибкой.
• Залогиниться на сайте. Возможно, папка или файл, которые вы хотите открыть, доступны только авторизованным пользователям, поэтому вам выдается ошибка 403 forbidden (нет доступа).
• Попробовать зайти через VPN. Ваш IP может быть заблокирован на сайте по какой-то причине. Блокировка может стоять и на все посещения из вашей страны или региона. Попробуйте зайти на сайт с IP-адресом другой страны.
• Проверить с другого устройства. Если на другом компьютере при попытке зайти на эту страницу вы также получаете ошибку с кодом 403 — скорее всего, проблема на самом сайте. Обратитесь к его владельцу.
• Отключите экономию трафика, если Error 403 появляется только на мобильном устройстве. Из-за этой функции сайт может не получать нужных для предоставления доступа данных, например, о вашем местоположении.
• Подождать и попробовать позже. Бывает, что сайт только что «переехал» на другой хостинг и настройки DNS просто не успели обновиться.
• Обратиться к провайдеру. Ошибка может быть связана с неверной конфигурацией его оборудования, внесением сайта в «черные списки» или выполнением запрещающих директив государственных органов.

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

Источник

28 Jun 2022 8:53 AM +00:00 UTC

26

ответов

Перейти к контенту

Бинанс 403 ошибка (403 error binance)

Часто приходит вопрос от пользователей биржи – выходит 403 ошибка на бинанс. А именно такой текст:

403 ERROR
The request could not be satisfied.

В переводе на русский это значит:

403 ОШИБКА
Просьба не могла быть удовлетворена.

Полный текст ошибки публиковать не будем, понятно о чем идет речь. Бинанс говорит, что ваш запрос заблокирован и сейчас мы не можем подключиться к серверу для этого приложения или веб-сайта. Ссылаются на большие объемы трафика или ошибку конфигурации. СОветуют повторить попытку спустя некоторое время или обратиться в техническую поддержку сайта.

Регистрируйся с указанием реферального ID: AHJUCEJW и получай скидку до 40% на комиссии в бинанс на все операции.

Ошибка 403 на Бинансе – что делать?

В сети мало информации по поводу этой ошибки при обращении к бирже. 403 error binance может возникать как на сайте, так и в приложении. Возникает она из-за проблем с интернетом. В этом случае помогает банальная перезагрузка роутера или смена устройства. Например, если вы пытались зайти на Бинанс на ПК и поймали 403 ошибку – зайдите через приложение. И наоборот.

Вторая ситуация при которой возникает 403 error binance – большое количество попыток входа/выхода в личный кабинет с одного ip адреса. Большое – это 25 и более за 3 часа. Решается сменой IP, включением vpn, либо простым ожиданием (час или более).

Источник

How To Fix Binance 403 Error

A quick fix to the Binance 403 error.

While Binance is one of the top cryptocurrency exchanges of 2022, it isn’t without its errors, with error code 403 impacting some users trying to use the platform. Similar to Coinbase connection issues, Binance too is vulnerable to occassional server meltdowns

Binance is a leading crypto exchange that recentlu launched its Binance NFT marketplace. Being one of the prominent crypto exchanges, it allows users and investors to trade 500+ cryptocurrencies across all domains.

However, there might be times when Binance is susceptible to occasional downtime, just like the Coinbase server issues. In this case, Binance may show users the error code 403 to prevent them from accessing the website. Let’s take a look at how Binance’s error 403 can be resolved in a few quick steps.

How To Fix Binance 403 Error?

A 403 error usually occurs when a server doesn’t allow a user to access a given webpage. To fix this error, you may need to follow these simple tricks.

• Try refreshing the page. A random 403 error may pop up due to a temporary server glitch. Refreshing the page may help sort it.

• Clear the cache memory of your phone/desktop’s browser may also help eliminate the 403 error.
• According to a Reddit user, Binance 403 error may also pop up due to depositing too much money without verifying the ID. Verify your credentials with Binance before proceeding ahead to avoid the 403 error.
• Check with Binance’s official website and see if their server is experiencing its periodic maintenance or downtime. This may also be the reason why you are getting a 403 error.
• Using a different browser or waiting 30 minutes after refreshing the page may also help eliminate the 403 error.

What Is Binance 403 Error?

A Binance 403 error is a temporary error that may pop up when a server is unable to process the request initiated by the user.

It might happen due to several reasons, such as when an exchange is undergoing a specified downtime orits periodic server maintenance.

It is always better to check the status page of the particular crypto exchange to stay on top of all details and notices.

Источник

Ошибка 403 пот подключении к сайту, как её исправить?

26 ответов

Ставьте VPN и нет не когда проблем

главное чтоб впн не закинул в запрет юрисдикцию. уже были тут примеры, кто впн подключал и попадал к примеру на США — у Америки свой домен Бинанс и на обычном Бинансе словит блок. или по фьючерсам например — не во всех странах можно фьючерсами торговать — тоже можно с впн блок на торги поймать.

первый раз слышу 2 года на впн сижу

Я пробовал пару раз, мне блочили торговлю, каждый из этих раз)

хз может впн левый какой

здесь прям писали. не так давно и не один раз.. как раз под участившиеся случаи «ошибка 403». блок на торги и требование проходить полную верификацию.

чего далеко ходить. я такое поймал на прошлой неделе. не посмотрел что впн на сша переключился

финляндия южная корея все норм

сша запрещенная юрисдикция. у них отдельный бинанс

Ага типо аккаунт,подозрительный айпи и тд.в целях безопасности и тд

ну я и говорю. если в запрет юрисдикцию не попасть, то норм. если.

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

Ну вот если я включаю ВПН не выходя из приложения, то норм, можно торговать. А тогда я пробовал ВПН из-за ошибки 403, там нужно было логиниться, и почему то торговать было нельзя, после входа, сообщение выскакивало по этому поводу.

Все жалуются что там якобы бот и ничего не отвечает,много таких жалоб в основном!

ну вообще да. подозрительно. когда в моменте коротком времени пользователь заходит из разных стран. если как Эдвард пишет, пользуется давно и постоянно, непрерывно — это нормально. а если из за ошибки, которая решается простым действием — сменой источника интернета буквально на несколько секунд, постоянно менять «страну пребывания» через впн, логично могут заподозрить неладное. и блокнуть до выяснения.

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

Источник

403 error бинанс что это

Frequently Asked Questions

Posted request, but faced 403 ERROR.#

Solution: Please carefully check your request path is following document, for example:

Posted request, but faced error with code «100001001».#

• Please check if you used GET, POST method should be used.
• Please check if you didn’t put content-type: application/json in request header
• Please check if you didn’t post body in request

Posted request, but faced error with code «400002»#

Solution A#

Please check if your sign logic is incorrect. You can test with below parameters:

The generated payload must be (there MUST be one new line at the end):

Signature Should be:

Solution B#

Please check if your json request body used ‘, should use «

Solution C#

Please check if your code changed the request json body after signing. Some may reformat the json.

Solution D#

Please check if you made the signature to upper case

Posted request, but faced error with code «400003»#

• Please check the request header field ‘BinancePay-Timestamp’, it should be UnixTimestamp in milliseconds, not in seconds.
• Please check if the request timestamp was within 1s to Binance Server.

Failed to verify the signature in webhook notification#

Solution A#

Please check if your sign logic is incorrect. Test your code logic with these parameters, if it’s not successful, then you need double check your code logic.

Источник

Change Log

2022-12-13

• Add u and pu in stream @depth1000 to get diff orderbook update.

2022-12-09

• Add updateId field u in GET /eapi/v1/depth
• Add parameter underlying in GET /eapi/v1/exerciseHistory to query exercise histroy by underlying

2022-11-18

• New endpoint GET /eapi/v1/openInterest is added to get options open interest for specific underlying on certain expiration date.

• New stream @openInterest@ is added for real-time option open interest feed.

2022-11-16

• New trade stream @trade is added for all option trades on specific underlying asset.
• Adjust format in stream option_pair .

2022-11-03

• New endpoint for Auto-Cancel All Open Orders will be added on 2022-11-07:
  • POST /eapi/v1/countdownCancelAll ：Set Auto-Cancel All Open Orders (Kill-Switch) Config
  • GET /eapi/v1/countdownCancelAll ：Get Auto-Cancel All Open Orders (Kill-Switch) Config
  • POST /eapi/v1/countdownCancelAllHeartBeat ：Auto-Cancel All Open Orders (Kill-Switch) Heartbeat

2022-09-20

• New streams @markPrice and @ticker@ are added.
• Streams will be deprecated on 2022/10/30.

2022-09-14

• Adjust endpoint field strikePrice , makerFeeRate , takerFeeRate , minQty , maxQty , initialMargin , maintenanceMargin , minInitialMargin , minMaintenanceMargin to string in endpoint GET /eapi/v1/exchangeInfo
• Only finished orders within 5 days can be queried in GET /eapi/v1/historyOrders

2022-09-05

• Adjust response result in endpoint DELETE /eapi/v1/allOpenOrdersByUnderlying

2022-08-22

• Add rateLimits information in endpoint GET /eapi/v1/exchangeInfo
• Parameters symbol set to not mandatory in GET /eapi/v1/userTrades

General Info

General API Information

• Some endpoints will require an API Key. Please refer to this page
• The base endpoint is: **https://eapi.binance.com
• All endpoints return either a JSON object or array.
• Data is returned in ascending order. Oldest first, newest last.
• All time and timestamp related fields are in milliseconds.

HTTP Return Codes

• HTTP 4XX return codes are used for for malformed requests; the issue is on the sender’s side.
• HTTP 403 return code is used when the WAF Limit (Web Application Firewall) has been violated.
• HTTP 429 return code is used when breaking a request rate limit.
• HTTP 418 return code is used when an IP has been auto-banned for continuing to send requests after receiving 429 codes.
• HTTP 5XX return codes are used for internal errors; the issue is on Binance’s side.
• HTTP 503 return code is used when:
  1. If there is an error message «Unknown error, please check your request or try again later.» returned in the response, the API successfully sent the request but not get a response within the timeout period.
     It is important to NOT treat this as a failure operation; the execution status is UNKNOWN and could have been a success;
  2. If there is an error message «Service Unavailable.» returned in the response, it means this is a failure API operation and the service might be unavailable at the moment, you need to retry later.
  3. If there is an error message «Internal error; unable to process your request. Please try again.» returned in the response, it means this is a failure API operation and you can resend your request if you need.

Error Codes and Messages

• Any endpoint can return an ERROR

The error payload is as follows:

• Specific error codes and messages defined in Error Codes.

General Information on Endpoints

• For GET endpoints, parameters must be sent as a query string .
• For POST , PUT , and DELETE endpoints, the parameters may be sent as a query string or in the request body with content type application/x-www-form-urlencoded . You may mix parameters between both the query string and request body if you wish to do so.
• Parameters may be sent in any order.
• If a parameter sent in both the query string and request body , the query string parameter will be used.

LIMITS

• The /eapi/v1/exchangeInfo rateLimits array contains objects related to the exchange’s RAW_REQUEST , REQUEST_WEIGHT , and ORDER rate limits. These are further defined in the ENUM definitions section under Rate limiters (rateLimitType) .
• A 429 will be returned when either rate limit is violated.

Binance has the right to further tighten the rate limits on users with intent to attack.

IP Limits

• Every request will contain X-MBX-USED-WEIGHT-(intervalNum)(intervalLetter) in the response headers which has the current used weight for the IP for all request rate limiters defined.
• Each route has a weight which determines for the number of requests each endpoint counts for. Heavier endpoints and endpoints that do operations on multiple symbols will have a heavier weight .
• When a 429 is received, it’s your obligation as an API to back off and not spam the API.
• Repeatedly violating rate limits and/or failing to back off after receiving 429s will result in an automated IP ban (HTTP status 418).
• IP bans are tracked and scale in duration for repeat offenders, from 2 minutes to 3 days.
• The limits on the API are based on the IPs, not the API keys.

It is strongly recommended to use websocket stream for getting data as much as possible, which can not only ensure the timeliness of the message, but also reduce the access restriction pressure caused by the request.

Order Rate Limits

• Every order response will contain a X-MBX-ORDER-COUNT-(intervalNum)(intervalLetter) header which has the current order count for the account for all order rate limiters defined.
• Rejected/unsuccessful orders are not guaranteed to have X-MBX-ORDER-COUNT-** headers in the response.
• The order rate limit is counted against each account.

Endpoint Security Type

• Each endpoint has a security type that determines the how you will interact with it.
• API-keys are passed into the Rest API via the X-MBX-APIKEY header.
• API-keys and secret-keys are case sensitive.
• API-keys can be configured to only access certain types of secure endpoints. For example, one API-key could be used for TRADE only, while another API-key can access everything except for TRADE routes.
• By default, API-keys can access all secure routes.

Security Type	Description
NONE	Endpoint can be accessed freely.
TRADE	Endpoint requires sending a valid API-Key and signature.
USER_DATA	Endpoint requires sending a valid API-Key and signature.
USER_STREAM	Endpoint requires sending a valid API-Key.
MARKET_DATA	Endpoint requires sending a valid API-Key.

• TRADE and USER_DATA endpoints are SIGNED endpoints.

SIGNED (TRADE and USER_DATA) Endpoint Security

• SIGNED endpoints require an additional parameter, signature , to be sent in the query string or request body .
• Endpoints use HMAC SHA256 signatures. The HMAC SHA256 signature is a keyed HMAC SHA256 operation. Use your secretKey as the key and totalParams as the value for the HMAC operation.
• The signature is not case sensitive.
• Please make sure the signature is the end part of your query string or request body .
• totalParams is defined as the query string concatenated with the request body .

Timing Security

• A SIGNED endpoint also requires a parameter, timestamp , to be sent which should be the millisecond timestamp of when the request was created and sent.
• An additional parameter, recvWindow , may be sent to specify the number of milliseconds after timestamp the request is valid for. If recvWindow is not sent, it defaults to 5000.

Serious trading is about timing. Networks can be unstable and unreliable, which can lead to requests taking varying amounts of time to reach the servers. With recvWindow , you can specify that the request must be processed within a certain number of milliseconds or be rejected by the server.

SIGNED Endpoint Examples for POST /eapi/v1/order

Here is a step-by-step example of how to send a vaild signed payload from the Linux command line using echo , openssl , and curl .

Key	Value
apiKey	dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83
secretKey	2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9

Parameter	Value
symbol	BTCUSDT
side	BUY
type	LIMIT
timeInForce	GTC
quantity	1
price	9000
recvWindow	5000
timestamp	1591702613943

Example 1: As a query string

HMAC SHA256 signature:

symbol=BTC-210129-40000-C
&side=BUY
&type=LIMIT
&timeInForce=GTC
&quantity=1
&price=2000
&recvWindow=5000
&timestamp=1611825601400

Example 2: As a request body

HMAC SHA256 signature:

symbol=BTC-210129-40000-C
&side=BUY
&type=LIMIT
&timeInForce=GTC
&quantity=1
&price=2000
&recvWindow=5000
&timestamp=1611825601400

Example 3: Mixed query string and request body

HMAC SHA256 signature:

Note that the signature is different in example 3. There is no & between «GTC» and «quantity=1».

Public Endpoints Info

Terminology

• symbol refers to the symbol name of a options contract symbol
• underlying refers to the underlying symbol of a options contract symbol
• quoteAsset refers to the asset that is the price of a symbol.
• settleAsset refers to the settlement asset when options are exercised

ENUM definitions

Options contract type

Order side

Position side

Time in force

• GTC — Good Till Cancel
• IOC — Immediate or Cancel
• FOK — Fill or Kill

Response Type (newOrderRespType)

Order types (type)

Order status (status)

Kline/Candlestick chart intervals:

m -> minutes; h -> hours; d -> days; w -> weeks; M -> months

Rate limiters (rateLimitType)

Rate limit intervals (interval)

Filters

Filters define trading rules on a symbol or an exchange.

Symbol filters

PRICE_FILTER

The PRICE_FILTER defines the price rules for a symbol. There are 3 parts:

• minPrice defines the minimum price / stopPrice allowed; disabled on minPrice == 0.
• maxPrice defines the maximum price / stopPrice allowed; disabled on maxPrice == 0.
• tickSize defines the intervals that a price / stopPrice can be increased/decreased by; disabled on tickSize == 0.

Any of the above variables can be set to 0, which disables that rule in the price filter . In order to pass the price filter , the following must be true for price / stopPrice of the enabled rules:

• sell order price >= minPrice
• buy order price maxPrice
• ( price — minPrice ) % tickSize == 0

LOT_SIZE

The LOT_SIZE filter defines the quantity (aka «lots» in auction terms) rules for a symbol. There are 3 parts:

• minQty defines the minimum quantity allowed.
• maxQty defines the maximum quantity allowed.
• stepSize defines the intervals that a quantity can be increased/decreased by.

In order to pass the lot size , the following must be true for quantity :

• quantity >= minQty
• quantity maxQty
• ( quantity — minQty ) % stepSize == 0

Market Data Endpoints

Test Connectivity

Test connectivity to the Rest API.

Weight: 1

Parameters: NONE

Check Server Time

Test connectivity to the Rest API and get the current server time.

Weight: 1

Parameters: NONE

Exchange Information

Current exchange trading rules and symbol information

Weight: 1

Parameters: NONE

Order Book

Weight: 1

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES	Option trading pair, e.g BTC-200730-9000-C
limit	INT	NO	Default:100 Max:1000.Optional value:[10, 20, 50, 100, 500, 1000]

Recent Trades List

Get recent market trades

Weight: 5

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES	Option trading pair, e.g BTC-200730-9000-C
limit	INT	NO	Number of records Default:100 Max:500

Old Trades Lookup (MARKET_DATA)

Get older market historical trades.

Weight: 20

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES	Option trading pair, e.g BTC-200730-9000-C
fromId	LONG	NO	The UniqueId ID from which to return. The latest deal record is returned by default
limit	INT	NO	Number of records Default:100 Max:500

Kline/Candlestick Data

Kline/candlestick bars for an option symbol. Klines are uniquely identified by their open time.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES	Option trading pair, e.g BTC-200730-9000-C
interval	STRING	YES	Time interval
startTime	LONG	NO	Start Time 1592317127349
endTime	LONG	NO	End Time
limit	INT	NO	Number of records Default:500 Max:1500

• If startTime and endTime are not sent, the most recent klines are returned.

Option Mark Price

Option mark price and greek info.

Weight: 5

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO	Option trading pair, e.g BTC-200730-9000-C

24hr Ticker Price Change Statistics

24 hour rolling window price change statistics.

Weight:
5

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO	Option trading pair, e.g BTC-200730-9000-C

Symbol Price Ticker

Get spot index price for option underlying.

Weight:
1

Parameters:

Name	Type	Mandatory	Description
underlying	STRING	YES	Spot pair（Option contract underlying asset, e.g BTCUSDT)

Historical Exercise Records

EXTRINSIC_VALUE_EXPIRED -> Expired OTM

Get historical exercise records.

Weight:
3

Parameters:

Name	Type	Mandatory	Description
underlying	STRING	NO	Underlying index like BTCUSDT
startTime	LONG	NO	Start Time
endTime	LONG	NO	End Time
limit	INT	NO	Number of records Default:100 Max:100

Open interest

Get open interest for specific underlying asset on specific expiration date.

Parameters:

Name	Type	Mandatory	Description
underlyingAsset	STRING	YES	underlying asset, e.g ETH/BTC
expiration	STRING	YES	expiration date, e.g 221225

Account/Trades Endpoints

Option Account Information (TRADE)

GET /eapi/v1/account (HMAC SHA256)

Get current account information.

Weight: 3

Parameters:

Name	Type	Mandatory	Description
recvWindow	LONG	NO
timestamp	LONG	YES

Funds Transfer (TRADE)

POST /eapi/v1/transfer (HMAC SHA256)

Transfer fund between spot and option account.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
currency	STRING	YES	Asset type, e.g USDT
type	ENUM	YES	IN: Transfer from spot account to option account OUT: Transfer from option account to spot account
amount	DECIMAL	YES	Amount
recvWindow	LONG	NO
timestamp	LONG	YES

New Order (TRADE)

POST /eapi/v1/order (HMAC SHA256)

Send a new order.

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES	Option trading pair, e.g BTC-200730-9000-C
side	ENUM	YES	Buy/sell direction: SELL, BUY
type	ENUM	YES	Order Type: LIMIT(only support limit)
quantity	DECIMAL	YES	Order Quantity
price	DECIMAL	NO	Order Price
timeInForce	ENUM	NO	Time in force method（Default GTC）
reduceOnly	BOOLEAN	NO	Reduce Only（Default false）
postOnly	BOOLEAN	NO	Post Only（Default false）
newOrderRespType	ENUM	NO	«ACK», «RESULT», Default «ACK»
clientOrderId	STRING	NO	User-defined order ID cannot be repeated in pending orders
isMmp	BOOLEAN	NO	is market maker protection order, true/false
recvWindow	LONG	NO
timestamp	LONG	YES

Some parameters are mandatory depending on the order type as follows:

Type	Mandatory parameters
LIMIT	timeInForce, quantity, price

Place Multiple Orders (TRADE)

POST /eapi/v1/batchOrders (HMAC SHA256)

Send multiple option orders.

Weight: 5

Parameters:

Name	Type	Mandatory	Description
orders	LIST	YES	order list. Max 5 orders
recvWindow	LONG	NO
timestamp	LONG	YES

Where batchOrders is the list of order parameters in JSON:

• example: /eapi/v1/batchOrders?orders=[<«symbol»:»BTC-210115-35000-C», «price»:»100″,»quantity»:»0.0002″,»side»:»BUY»,»type»:»LIMIT»>]

Name	Type	Mandatory	Description
symbol	STRING	YES	Option trading pair, e.g BTC-200730-9000-C
side	ENUM	YES	Buy/sell direction: SELL, BUY
type	ENUM	YES	Order Type: LIMIT (Only support LIMIT)
quantity	DECIMAL	YES	Order Quantity
price	DECIMAL	NO	Order Price
timeInForce	ENUM	NO	Time in force method（Default GTC）
reduceOnly	BOOLEAN	NO	Reduce Only（Default false）
postOnly	BOOLEAN	NO	Post Only（Default false）
newOrderRespType	ENUM	NO	«ACK», «RESULT», Default «ACK»
clientOrderId	STRING	NO	User-defined order ID cannot be repeated in pending orders
isMmp	BOOLEAN	NO	is market maker protection order, true/false

Some parameters are mandatory depending on the order type as follows:

Type	Mandatory parameters
LIMIT	timeInForce, quantity, price

• Parameter rules are same with New Order
• Batch orders are processed concurrently, and the order of matching is not guaranteed.
• The order of returned contents for batch orders is the same as the order of the order list.

Cancel Option Order (TRADE)

DELETE /eapi/v1/order (HMAC SHA256)

Cancel an active order.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES	Option trading pair, e.g BTC-200730-9000-C
orderId	LONG	NO	Order ID, e.g 4611875134427365377
clientOrderId	STRING	NO	User-defined order ID, e.g 10000
recvWindow	LONG	NO
timestamp	LONG	YES

At least one instance of orderId and clientOrderId must be sent.

Cancel Multiple Option Orders (TRADE)

DELETE /eapi/v1/batchOrders (HMAC SHA256)

Cancel an active order.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES	Option trading pair, e.g BTC-200730-9000-C
orderIds	LIST	NO	Order ID, e.g [4611875134427365377,4611875134427365378]
clientOrderIds	LIST	NO	User-defined order ID, e.g [«my_id_1″,»my_id_2»]
recvWindow	LONG	NO
timestamp	LONG	YES

At least one instance of orderId and clientOrderId must be sent.

Cancel all Option orders on specific symbol (TRADE)

DELETE /eapi/v1/allOpenOrders (HMAC SHA256)

Cancel all active order on a symbol.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES	Option trading pair, e.g BTC-200730-9000-C
recvWindow	LONG	NO
timestamp	LONG	YES

Cancel All Option Orders By Underlying (TRADE)

DELETE /eapi/v1/allOpenOrdersByUnderlying (HMAC SHA256)

Cancel all active orders on specified underlying.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
underlying	STRING	YES	Option underlying, e.g BTCUSDT
recvWindow	LONG	NO
timestamp	LONG	YES

Query Current Open Option Orders (USER_DATA)

GET /eapi/v1/openOrders (HMAC SHA256)

Query current all open orders, status: ACCEPTED PARTIALLY_FILLED

Weight: 1 for a single symbol; 40 when the symbol parameter is omitted

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO	return all orders if don’t pass, Option trading pair, e.g BTC-200730-9000-C,
orderId	LONG	NO	Returns the orderId and subsequent orders, the most recent order is returned by default
startTime	LONG	NO	Start Time
endTime	LONG	NO	End Time
limit	INT	NO	Number of result sets returned Default:100 Max:1000
recvWindow	LONG	NO
timestamp	LONG	YES

Query Option Order History (TRADE)

GET /eapi/v1/historyOrders (HMAC SHA256)

Query all finished orders within 5 days, finished status: CANCELLED FILLED REJECTED.

Weight: 3

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	YES	Option trading pair
orderId	LONG	NO	Returns the orderId and subsequent orders, the most recent order is returned by default
startTime	LONG	NO	Start Time, e.g 1593511200000
endTime	LONG	NO	End Time, e.g 1593512200000
limit	INT	NO	Number of result sets returned Default:100 Max:1000
recvWindow	LONG	NO
timestamp	LONG	YES

Option Position Information (USER_DATA)

GET /eapi/v1/position (HMAC SHA256)

Get current position information.

Weight: 5

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO	Option trading pair, e.g BTC-200730-9000-C
recvWindow	LONG	NO
timestamp	LONG	YES

Account Trade List (USER_DATA)

GET /eapi/v1/userTrades (HMAC SHA256)

Get trades for a specific account and symbol.

Weight: 5

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO	Option symbol, e.g BTC-200730-9000-C
fromId	LONG	NO	Trade id to fetch from. Default gets most recent trades, e.g 4611875134427365376
startTime	LONG	NO	Start time, e.g 1593511200000
endTime	LONG	NO	End time, e.g 1593512200000
limit	INT	NO	Default 100; max 1000
recvWindow	LONG	NO
timestamp	LONG	YES

User Exercise Record (USER_DATA)

GET /eapi/v1/exerciseRecord (HMAC SHA256)

Get account exercise records.

Weight: 5

Parameters:

Name	Type	Mandatory	Description
symbol	STRING	NO	Option trading pair, e.g BTC-200730-9000-C
startTime	LONG	NO	startTime
endTime	LONG	NO	endTime
limit	INT	NO	default 1000, max 1000
recvWindow	LONG	NO
timestamp	LONG	YES

Account Funding Flow (USER_DATA)

GET /eapi/v1/bill (HMAC SHA256)

Query account funding flows.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
currency	STRING	YES	Asset type, e.g USDT
recordId	LONG	NO	Return the recordId and subsequent data, the latest data is returned by default, e.g 100000
startTime	LONG	NO	Start Time, e.g 1593511200000
endTime	LONG	NO	End Time, e.g 1593512200000
limit	INT	NO	Number of result sets returned Default:100 Max:1000
recvWindow	LONG	NO
timestamp	LONG	YES

Websocket Market Streams

• The baseurl of the websocket interface is: *wss://nbstream.binance.com/eoptions/*
• Streams can be access either in a single raw stream or a combined stream
• Raw streams are accessed at /ws/
• Combined streams are accessed at /stream?streams= / /
• Example:
• wss://nbstream.binance.com/eoptions/ws/BTC-210630-9000-P@ticker

A single connection is only valid for 24 hours; expect to be disconnected at the 24 hour mark

The websocket server will send a ping frame every 5 minutes. If the websocket server does not receive a pong frame back from the connection within a 15 minute period, the connection will be disconnected. Unsolicited pong frames are allowed.

WebSocket connections have a limit of 10 incoming messages per second.

A connection that goes beyond the limit will be disconnected; IPs that are repeatedly disconnected may be banned.

A single connection can listen to a maximum of 200 streams.

Considering the possible data latency from RESTful endpoints during an extremely volatile market, it is highly recommended to get the order status, position, etc from the Websocket user data stream.

Combined stream events are wrapped as follows:

All symbols for streams are lowercase

A single connection is only valid for 24 hours; expect to be disconnected at the 24 hour mark

The websocket server will send a ping frame every 5 minutes. If the websocket server does not receive a pong frame back from the connection within a 15 minute period, the connection will be disconnected. Unsolicited pong frames are allowed.

WebSocket connections have a limit of 10 incoming messages per second.

A connection that goes beyond the limit will be disconnected; IPs that are repeatedly disconnected may be banned.

A single connection can listen to a maximum of 200 streams.

Considering the possible data latency from RESTful endpoints during an extremely volatile market, it is highly recommended to get the order status, position, etc from the Websocket user data stream.

Live Subscribing/Unsubscribing to streams

• The following data can be sent through the websocket instance in order to subscribe/unsubscribe from streams. Examples can be seen below.
• The id used in the JSON payloads is an unsigned INT used as an identifier to uniquely identify the messages going back and forth.

Subscribe to a stream

<
«method»: «SUBSCRIBE»,
«params»:
[
«BTC-210630-9000-P@ticker»,
«BTC-210630-9000-P@depth»
],
«id»: 1
>

Unsubscribe to a stream

Listing Subscriptions

<
«method»: «LIST_SUBSCRIPTIONS»,
«id»: 3
>

Setting Properties

Currently, the only property can be set is to set whether combined stream payloads are enabled are not. The combined property is set to false when connecting using /ws/ («raw streams») and true when connecting using /stream/ .

Retrieving Properties

Error Messages

Error Message	Description
	Parameter used in the SET_PROPERTY or GET_PROPERTY was invalid
	Value should only be true or false
	Property name provided was invalid
	Parameter id had to be provided or the value provided in the id parameter is an unsupported type
	Possible typo in the provided method or provided method was neither of the expected values
	Unnecessary parameters provided in the data
	Property name was not provided
	method was not provided in the data
	JSON data sent has incorrect syntax. ## Trade Streams

Trade Streams

The Trade Streams push raw trade information for specific symbol or underlying asset. E.g.ETH@trade

Stream Name:
@trade or @trade

Update Speed: 50ms

Index Price Streams

Underlying(e.g ETHUSDT) index stream.

Stream Name:
@index

Update Speed: 1000ms

Mark Price

The mark price for all option symbols on specific underlying asset. E.g.ETH@markPrice

Stream Name:
@markPrice

Update Speed: 1000ms

Kline/Candlestick Streams

The Kline/Candlestick Stream push updates to the current klines/candlestick every 1000 milliseconds (if existing).

Kline/Candlestick chart intervals:

m -> minutes; h -> hours; d -> days; w -> weeks; M -> months

«1m», «3m», «5m», «15m» «30m» «1h», «2h», «4h», «6h», «12h», «1d», «3d», «1w»,

Stream Name:
@kline_

Update Speed: 1000ms

24-hour TICKER

24hr ticker info for all symbols. Only symbols whose ticker info changed will be sent.

Stream Name:
@ticker

Update Speed: 1000ms

24-hour TICKER by underlying asset and expiration data

24hr ticker info by underlying asset and expiration date. E.g.ETH@ticker@220930

Stream Name:
@ticker@

Update Speed: 1000ms

Open Interest

Option open interest for specific underlying asset on specific expiration date. E.g.ETH@openInterest@221125

Stream Name:
@openInterest@

Update Speed: 60s

New Symbol Info

New symbol listing stream.

Stream Name:
option_pair

Update Speed: 50ms

Partial Book Depth Streams

Top bids and asks, Valid levels are are 10, 20, 50, 100.

Stream Names: @depth OR @depth @100ms OR @depth @1000ms .

Update Speed: 100ms or 1000ms, 500ms(default when update speed isn’t used)

Diff. Book Depth Streams

When depth level is set to 1000, stream returns diff book depth pushed every 50ms. Please follow the subsequent instructions on how to manage a local order book correctly.

Stream Names: @depth1000

Update Speed: 50ms

How to manage a local order book correctly

1. Open a diff. Book depth stream to wss://nbstream.binance.com/eoptions/stream?streams=ETH-221230-1200-P@depth1000.
2. Buffer the events you receive from the stream. For same price, latest received update covers the previous one.
3. Get a depth snapshot from https://eapi.binance.com/eapi/v1/depth?symbol=ETH-221230-1200-P&limit=1000 .
4. Drop any event from the websocket stream where u is u from the step 3
5. The first processed event should have u > u from step 3 AND pu = u from step 3
6. While listening to the stream, each new event’s pu should be equal to the previous event’s u , otherwise initialize the process from step 3.
7. The data in each event is the absolute quantity for a price level.
8. If the quantity is 0, remove the price level.
9. Receiving an event that removes a price level that is not in your local order book can happen and is normal.

User Data Streams

• The base API endpoint is: https://eapi.binance.com
• A User Data Stream listenKey is valid for 60 minutes after creation.
• Doing a PUT on a listenKey will extend its validity for 60 minutes.
• Doing a DELETE on a listenKey will close the stream and invalidate the listenKey .
• Doing a POST on an account with an active listenKey will return the currently active listenKey and extend its validity for 60 minutes.
• Connection method for Websocket：
  • Base Url: wss://nbstream.binance.com/eoptions/
  • User Data Streams are accessed at /ws/
  • Example: wss://nbstream.binance.com/eoptions/ws/XaEAKTsQSRLZAGH9tuIu37plSRsdjmlAVBoNYPUITlTAko1WI22PgmBMpI1rS8Yh

• A single connection is only valid for 24 hours; expect to be disconnected at the 24 hour mark

Start User Data Stream (USER_STREAM)

Start a new user data stream. The stream will close after 60 minutes unless a keepalive is sent. If the account has an active listenKey , that listenKey will be returned and its validity will be extended for 60 minutes.

Weight: 1

Parameters:

Keepalive User Data Stream (USER_STREAM)

Keepalive a user data stream to prevent a time out. User data streams will close after 60 minutes. It’s recommended to send a ping about every 60 minutes.

Weight: 1

Parameters:

Close User Data Stream (USER_STREAM)

Close out a user data stream.

Weight: 1

Parameters:

Event: Account data

• Update Speed: 50ms
• Update under the following conditions:
  • Account deposit or withdrawal
  • Position info change. Includes a P attribute if there are changes, otherwise does not include a P attribute.
  • Greek update

Event: Order update

• Update Speed: 50ms
• Update under the following conditions:
  • Order fills
  • Order placed
  • Order cancelled

Market Maker Endpoints

Market maker endpoints only work for option market makers, api users will get error when send requests to these endpoints.

Option Margin Account Information (USER_DATA)

GET /eapi/v1/marginAccount (HMAC SHA256)

Get current account information.

Weight: 3

Parameters:

Name	Type	Mandatory	Description
recvWindow	LONG	NO
timestamp	LONG	YES

Set Market Maker Protection Config (TRADE)

POST /eapi/v1/mmpSet (HMAC SHA256)

Set config for MMP. Market Maker Protection(MMP) is a set of protection mechanism for option market maker, this mechanism is able to prevent mass trading in short period time. Once market maker’s account branches the threshold, the Market Maker Protection will be triggered. When Market Maker Protection triggers, all the current MMP orders will be canceled, new MMP orders will be rejected. Market maker can use this time to reevaluate market and modify order price.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
underlying	STRING	TRUE	underlying, e.g BTCUSDT
windowTimeInMilliseconds	LONG	TRUE	MMP Interval in milliseconds; Range (0,5000]
frozenTimeInMilliseconds	LONG	TRUE	MMP frozen time in milliseconds, if set to 0 manual reset is required
qtyLimit	DECIMAL	TRUE	quantity limit
deltaLimit	DECIMAL	TRUE	net delta limit
recvWindow	LONG	NO
timestamp	LONG	YES

Get Market Maker Protection Config (TRADE)

Get /eapi/v1/mmp (HMAC SHA256)

Get config for MMP.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
underlying	STRING	TRUE	underlying, e.g BTCUSDT
recvWindow	LONG	NO
timestamp	LONG	YES

Reset Market Maker Protection Config (TRADE)

POST /eapi/v1/mmpReset (HMAC SHA256)

Reset MMP, start MMP order again.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
underlying	STRING	TRUE	underlying, e.g BTCUSDT
recvWindow	LONG	NO
timestamp	LONG	YES

Set Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE)

POST /eapi/v1/countdownCancelAll (HMAC SHA256)

This endpoint sets the parameters of the auto-cancel feature which cancels all open orders (both market maker protection and non market maker protection order types) of the underlying symbol at the end of the specified countdown time period if no heartbeat message is sent. After the countdown time period, all open orders will be cancelled and new orders will be rejected with error code -2010 until either a heartbeat message is sent or the auto-cancel feature is turned off by setting countdownTime to 0.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
underlying	STRING	YES	Option underlying, e.g BTCUSDT
countdownTime	LONG	YES	Countdown time in milliseconds (ex. 1,000 for 1 second). 0 to disable the timer. Negative values (ex. -10000) are not accepted. Minimum acceptable value is 5,000
recvWindow	LONG	NO
timestamp	LONG	YES

• This rest endpoint sets up the parameters to cancel your open orders in case of an outage or disconnection.
• Example usage: Call this endpoint with a countdownTime value of 10000 (10 seconds) to turn on the auto-cancel feature. If the corresponding countdownCancelAllHeartBeat endpoint is not called within 10 seconds with the specified underlying symbol, all open orders of the specified symbol will be automatically canceled. If this endpoint is called with an countdownTime of 0, the countdown timer will be stopped.
• The system will check all countdowns approximately every 1000 milliseconds, please note that sufficient redundancy should be considered when using this function. We do not recommend setting the countdown time to be too precise or too small.

Get Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE)

GET /eapi/v1/countdownCancelAll (HMAC SHA256)

This endpoint returns the auto-cancel parameters for each underlying symbol. Note only active auto-cancel parameters will be returned, if countdownTime is set to 0 (ie. countdownTime has been turned off), the underlying symbol and corresponding countdownTime parameter will not be returned in the response.

Weight: 1

Parameters:

Name	Type	Mandatory	Description
underlying	STRING	NO	Option underlying, e.g BTCUSDT
recvWindow	LONG	NO
timestamp	LONG	YES

• countdownTime = 0 means the function is disabled.

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (TRADE)

POST /eapi/v1/countdownCancelAllHeartBeat (HMAC SHA256)

This endpoint resets the time from which the countdown will begin to the time this messaged is received. It should be called repeatedly as heartbeats. Multiple heartbeats can be updated at once by specifying the underlying symbols as a list (ex. BTCUSDT,ETHUSDT) in the underlyings parameter.

Weight: 10

Parameters:

Name	Type	Mandatory	Description
underlyings	STRING	YES	Option Underlying Symbols, e.g BTCUSDT,ETHUSDT
recvWindow	LONG	NO
timestamp	LONG	YES

• The response will only include underlying symbols where the heartbeat has been successfully updated.

Error Codes

Here is the error JSON payload:

Errors consist of two parts: an error code and a message.
Codes are universal,but messages can vary.

Источник