API документация 丨 API библиотеки с отворен код и примери
Какви са ограниченията?
Общ преглед
Има три различни типа ограничения, които подлежат на промяна по всяко време:
- Твърди ограничения
- ML (машинно обучение) ограничения
- Ограничения на WAF (защитна стена за уеб приложения)
Твърди ограничения
- Тегло на заявки от 6000 за минута (имайте предвид, че това не е непременно същото като 6000 заявки)
- 50 поръчки за 10 секунди
- 160 000 поръчки за 24 часа
Нашите твърди ограничения са посочени в крайната точка [/api/v3/exchangeInfo].
Ограничения на машинното обучение
Поведението при търговия се оценява спрямо средния потребител. Ако се отклоните твърде много, ще бъдете баннати за определен период от време, вариращ между 5 минути и 3 дни.
Да приемем, че имате резултат за търговска злоупотреба. Резултатът ви ще се увеличи, ако:
- Многократно използвате действия „с предимство“ (one-up) или „изпреварващи“ (front-run) действия за най-добри оферти за „купува/продава“ (Bid/Ask) в книгата с поръчки.
- Бързо създаване и анулиране на вашата спам поръчка, без да извършвате сделки.
- Вашият „курс на конвертиране“ е нисък. „Курсът на конвертиране“ се определя като вашия брой сделки, разделен на общия брой създадени и анулирани поръчки за период от 24 часа (Брой сделки / (Поръчки + Анулирания)).
- Вашата „тежест“ е ниска. „Тежест“ се дефинира като общото ви търгувано количество, разделено на общото количество създадени и анулирани поръчки за период от 24 часа (Общо търгувано количество / (Поръчки + Анулирания)).
- Когато търгувате двойки, които имат BNB като основен или котировъчен актив, резултатът ви за злоупотреба ще се увеличи.
По-конкретна информация от горната няма да бъде предоставена. Моля, използвайте метода на проба и грешка, за да постигнете идеалния си модел на търговия или обсъдете оптималното поведение с други потребители на API.
Ограничения на защитната стена на уеб приложението
Въпреки че не предоставяме точни подробности за нашите WAF правила, ако получите грешка HTTP 403, вие сте нарушили правило. Най-вероятно това ще бъде резултат от прекомерни заявки в рамките на 5 минути. Ако обаче изпращате заявка, която може да се възприеме като злонамерена, това също може да доведе до забрана с по-голяма продължителност.
Ако надвиша ограниченията, ще бъда ли ограничен по акаунт, API код или IP адрес?
За твърдите ограничения, надвишаването на общото ограничение на заявката за минута (в момента 6000) ще доведе до забрана на IP адреса. Ограниченията на поръчките (в момента са 50 пъти/10 секунди и 160 000 пъти/24 часа) ще зависят от акаунта. Ако ограничението за поръчки е надвишено, за вас също ще бъде ограничено създаването на нови поръчки на уебсайта (или други наши приложения).
За ограниченията на машинното обучение ще се прилагат ограничения за акаунтите. Ако сте били ограничени от ML системата, можете да проверите причината и продължителността, като използвате крайната точка [/sapi/v1/account/status] (отбелязана в нашата документация за API).
Ограниченията на защитната стена за уеб приложения ще се прилагат само чрез IP. Обикновено забраната за WAF ще продължи 5 минути. Ако обаче сървърът е интерпретирал заявката на потребител като злонамерена, тя може да бъде удължена.
Бях ограничен за надвишаване на ограниченията, но поправих кода си. Ще отмените ли забраната ми по-рано?
Не. Трябва да изчакате, докато забраната приключи.
Защо получих HTTP 403 грешка при използване на API?
Нарушили сте правилата на WAF (защитна стена за уеб приложения), най-вероятно чрез нарушаване на ограничението за скоростта или изпращане на злонамерена заявка (както е посочено в раздела за ограничения в този документ). Обикновено тези забрани продължават период от 5 минути.
Защо връзките ми на WebSocket се отказват/прекъсват?
На всеки 3 минути активните връзки WebSocket ще получат пинг. Ако не отговорите с правилно рамкиран пинг, връзката ви ще бъде прекъсната.
За потоци от потребителски данни, ако поддържането на активността не бъде получено поне веднъж на всеки 60 минути, ключът за слушане ще изтече. Това също е описано подробно в нашата API документация.
Използвам услуга/обвивка на трета страна и тя не работи. Можете ли да помогнете?
За съжаление, не поддържаме услуги или инструменти на трети страни. Моля, обърнете се към услугата и/или разработчиците за допълнителна помощ.
Освен това е риск за сигурността е да въвеждате своите ключове за Binance API и/или секретни ключове във всяка платформа на трета страна. Моля, използвайте тези услуги по ваше усмотрение.
Имайте предвид, че ние също избягваме да предоставяме обща помощ при програмирането.
Въпреки че не правя промени, изведнъж получавам грешки. Какво стана?
За съжаление не можем да осигурим поддръжка за проблеми с вашето лично изпълнение. Ако използвате обвивка/инструмент на трета страна, моля, свържете се с техния екип за поддръжка/разработка за съдействие.
Трябва да вляза в секретния си код, но той показва „***“. Как да извлека това?
От съображения за сигурност, по дизайн, секретните кодове са видими само по време на създаването на API ключа. Всеки път след тази точка той ще бъде маскиран. Ако сте загубили или не сте записали своя API ключ, ще трябва да създадете нов и да го използвате с нов таен ключ.
Мога ли да увелича ограниченията си или специалния поток/честотна лента?
За съжаление в момента това не се предлага. Би трябвало да е възможно да се работи с предоставените ограничения.
Моят API код е изчезнал.
Има само две вероятни обяснения за „изчезването“ на API ключ:
- Ако не сте били активни наскоро и сте използвали приложния програмен интерфейс (API) преди 7 март 2018 г., възможно е ключът(овете) ви за приложния програмен интерфейс (API) да са били премахнати, за да се гарантира сигурността на вашия акаунт.
- Ако сте деактивирали акаунта си, това е довело до изтриването на всичките ви активни API ключове.
Би трябвало да можете да създадете нов API код без проблеми.
Получавам „Грешка -1021 (Съобщение: Времевото клеймо за тази заявка е извън recvWindow)“. Как мога да разреша това?
Обикновено тази грешка възниква само ако времето на сървъра и вашето системно време не се синхронизират. Може да се наложи да синхронизирате системния си часовник. Този процес обаче варира в зависимост от операционната система.
За Windows по ваше усмотрение можете да използвате инструмент като "Атомен часовник". Потребителите на Linux и Mac могат да опитат да се синхронизират с "ntpdate" чрез командния ред.
Ако проблемът продължава, може да е свързан с латентност (мрежов проблем). Моля, опитайте да коригирате своя recvWindow.
Мога ли да поискам нови функционалности на API?
Ако не виждате в нашата документация функционалността, която искате, трябва да приемете, че не я предоставяме. Ако искате да направите предложение за функция, можете да отворите тикет към отдела за поддръжка и той ще бъде прегледан.
Вярвам, че има проблем с API. Как да го докладвам?
Ако смятате, че има проблем със системата, а не с вашето внедряване, моля, предоставете доказателства в подкрепа на твърдението си, като се свържете с нас в нашия форум за разработчици и ние ще направим разследване. Моля, обърнете внимание, че не приемаме неясни съобщения като легитимни оплаквания.
Последна актуализация на 24 октомври 2023 г.