Binance Опциондарының API интерфейсі және WebSocket

2022-09-08 09:41

Binance Опциондары саудасы Binance Futures API қосылым жинағы арқылы қолжетімді және Binance API сауда интерфейсін қосқан пайдаланушылар үшін ашық. 

1. Нарық деректерінің соңғы нүктелері

Әрбір сұрауға арналған Github сілтемесі сәйкес соңғы нүктелердің салмақтарына, параметрлеріне және жауаптарына қатынасты қамтамасыз етеді. 

Сұрау

Сипаттама

Соңғы нүкте және мәліметтер

Қосылымды тексеру

Rest API интерфейсіне қосылымды тексеру

АЛУ /eapi/v1/ping

Сервер уақытын тексеру

Rest API интерфейсіне қосылымды тексеріп, ағымдағы сервер уақытын алу

АЛУ /eapi/v1/time

Биржа ақпараты

Ағымдағы биржадағы сауда ережелері және таңба туралы ақпарат

АЛУ /eapi/v1/exchangeInfo 

Тапсырыс кітабы

Тапсырыс кітабының деректерін алу

АЛУ /eapi/v1/depth

Соңғы сауда тізімі

Соңғы нарықтық сауда деректерін алу

АЛУ /eapi/v1/trades

Ескі сауданы іздеу (MARKET_DATA)

Ескі нарықтағы сауда деректерін алу

АЛУ /eapi/v1/historicalTrades

K сызығы/Майшам деректері

Опциондық таңба үшін K сызығы/майшам жолақтары. К сызықтары олардың ашылу уақытымен анықталады

АЛУ /eapi/v1/klines

Опциондардың белгіленген бағасы

Опциондардың белгіленген бағасы және грек ақпараты

АЛУ /eapi/v1/mark

24 сағ тикер бағасының өзгерту статистикасы

24 сағаттық сырғымалы терезе бағасының өзгерту статистикасы

АЛУ /eapi/v1/ticker

Таңба бағасының тикері

Опциондардың негізгі активі үшін спот индексінің бағасын білу

АЛУ /eapi/v1/index

Тарихи орындау жазбалары

Тарихи орындау жазбаларын алу

АЛУ /eapi/v1/exerciseHistory

Ашық позиция

Белгілі бір жарамдылық мерзімінде негізгі актив үшін ашық позицияны алу

АЛУ /eapi/v1/openInterest

2. Шот/саудалардың соңғы нүктелері

Әрбір сұрауға арналған Github сілтемесі сәйкес соңғы нүктелердің салмақтарына, параметрлеріне және жауаптарына қатынасты қамтамасыз етеді.

Сұрау

Сипаттама

Соңғы нүкте және мәліметтер

Опциондық шот ақпараты (САУДА)

Ағымдағы шот туралы ақпаратты алу

АЛУ /eapi/v1/account (HMAC SHA256)

Қаражатты аудару (САУДА)

Қосымша мәліметтерді мына жерден қараңыз

Жаңа тапсырыс (САУДА)

Жаңа тапсырыс жіберу

ЖАРИЯЛАУ /eapi/v1/order (HMAC SHA256)

Бірнеше тапсырыс беру (САУДА)

Бірнеше опциондық тапсырыс жіберу

ЖАРИЯЛАУ /eapi/v1/batchOrders (HMAC SHA256)

Бір тапсырыс сұрауы (САУДА)

Тапсырыс күйін тексеру

АЛУ /eapi/v1/order (HMAC SHA256)

Опциондық тапсырыстан бас тарту (САУДА)

Белсенді тапсырыстан бас тарту

ЖОЮ /eapi/v1/order (HMAC SHA256)

Бірнеше опциондық тапсырыстан бас тарту (САУДА)

Бірнеше белсенді тапсырыстан бас тарту

ЖОЮ /eapi/v1/batchOrders (HMAC SHA256)

Белгілі бір таңба бойынша барлық опциондық тапсырыстардан бас тарту (САУДА)

Таңба бойынша барлық белсенді тапсырыстардан бас тарту

ЖОЮ /eapi/v1/allOpenOrders (HMAC SHA256)

Негізгі актив бойынша барлық опциондық тапсырыстардан бас тарту (САУДА)

Нақты бір негізгі актив бойынша барлық белсенді тапсырыстардан бас тарту

ЖОЮ /eapi/v1/allOpenOrdersByUnderlying (HMAC SHA256)

Ағымдағы ашық опциондық тапсырыстар бойынша сұрау (USER_DATA)

Ағымдағы барлық ашық тапсырыс бойынша сұрау, күйі: ACCEPTED PARTIALLY_FILLED

АЛУ /eapi/v1/openOrders (HMAC SHA256)

Опциондық тапсырыс журналы бойынша сұрау (САУДА)

5 күн ішінде аяқталған барлық тапсырыстар бойынша сұрау. Тапсырыс күйі: БАС ТАРТЫЛДЫ, ТОЛТЫРЫЛДЫ, ҚАБЫЛДАНБАДЫ

АЛУ /eapi/v1/historyOrders (HMAC SHA256)

Опциондық позиция туралы ақпарат (USER_DATA)

Позиция туралы ағымдағы ақпаратты алу

АЛУ /eapi/v1/position (HMAC SHA256)

Шоттық сауда тізімі (USER_DATA)

Белгілі бір шот пен таңба үшін сауда ақпаратын алу

АЛУ /eapi/v1/userTrades (HMAC SHA256)

Пайдаланушының орындау жазбасыd (USER_DATA)

Шоттың орындау жазбаларын алу

АЛУ /eapi/v1/exerciseRecord (HMAC SHA256)

Шотты қаржыландыру ағыны (USER_DATA)

Шотты қаржыландыру ағындары бойынша сұрау

АЛУ /eapi/v1/bill (HMAC SHA256)

3. WebSocket нарық ағыны

WebSocket бөлімінде тізімделген сұрауларды пайдаланып төменде көрсетілген кез келген ағынға жазылуға немесе жазылудан бас тартуға болады. 

Ағын

Ағын атауы

Сипаттама

Жаңарту жылдамдығы

Сауда ағындары

<symbol>@trade немесе <underlyingAsset>@trade

Сауда ағындары белгілі бір таңба немесе негізгі актив үшін өңделмеген сауда ақпаратын қамтиды, мысалы, ETH@trade

50 мс

Индекс ағыны

<symbol>@index

Негізгі (мысалы, ETHUSDT) индекс ағыны

1000 мс

Белгіленген баға

<underlyingAsset>@markPrice

Белгілі бір негізгі актив бойынша барлық опциондық таңба үшін белгіленген баға, мысалы, ETH@markPrice

1000 мс

K сызығы/Майшам ағындары

<symbol>@kline_<interval>

K сызығы/Майшам ағыны ағымдағы K сызығына/майшамға әрбір 1000 миллисекунд сайын (егер бар болса) жаңартулар жібереді

1000 мс

24 сағаттық тикер

<symbol>@ticker

Барлық таңба үшін 24 сағаттық тикер ақпараты. Тикер ақпараты өзгертілген таңбалар ғана жіберіледі

1000 мс

Негізгі актив және жарамдылық мерзімі бойынша 24 сағаттық тикер

<underlyingAsset>@ticker@<expirationDate>

Негізгі актив және жарамдылық мерзімі бойынша 24 сағаттық тикер ақпараты, мысалы, ETH@ticker@220930

1000 мс

Ашық позиция

<underlyingAsset>@openInterest@<expirationDate>

Белгілі бір жарамдылық мерзіміндегі негізгі активке арналған опциондық ашық позиция, мысалы, ETH@openInterest@221125

60 сек

Жаңа таңба ақпараты

option_pair

Жаңа таңба тізімінің ағыны

50 мс  

Жартылай кітап тереңдігі ағындары

<symbol>@depth<levels> немесе <symbol>@depth<levels>@100 мс немесе <symbol>@depth<levels>@1000 мс

Жоғары сұраныс пен ұсыныс. Жарамды деңгейлер – 10, 20, 50, 100

100 мс, 500 мс немесе 1000 мс (жаңарту жылдамдығы пайдаланылмаған кезде әдепкі)

Түрлі кітап тереңдігі ағындары

<symbol>@depth1000 

Тереңдік деңгейі 1000 мәніне орнатылғанда, ағын әр 50 мс сайын әртүрлі кітап тереңдігін қайтарады. Жергілікті тапсырыс кітабын дұрыс басқару үшін келесі нұсқауларды орындаңыз

50 мс

4. WebSocket пайдаланушы деректері ағындары

Сіз listenKey арқылы пайдаланушы деректерінің ағындарына қол жеткізе аласыз. WebSocket пайдаланушы деректерінің ағындары бөлімін қараңыз. 

Іс-шара

Іс-шара түрі

Сипаттама

Жаңарту жылдамдығы

Шот деректері

ACCOUNT_UPDATE

Келесі жағдайларда жаңарту:

  • Шот депозиті немесе шығару
  • Позиция туралы ақпараттың өзгеруі. Өзгерістер бар болған жағдайда P атрибутын қамтиды, кері жағдайда P атрибутын қамтымайды.
  • Грек жаңартуы
50 мс

Тапсырысты жаңарту

ORDER_TRADE_UPDATE

Келесі жағдайларда жаңарту:

  • Тапсырысты толтыру
  • Тапсырыс берілді
  • Тапсырыстан бас тартылды
50 мс

5. Маркет-мейкер соңғы нүктелері

Келесі API соңғы нүктелері тек маркет-мейкерлер үшін қолжетімді.  Әрбір сұрауға арналған Github сілтемесі сәйкес соңғы нүктелердің салмақтарына, параметрлеріне және жауаптарына қатынасты қамтамасыз етеді.

Сұрау

Сипаттама

Соңғы нүкте және мәліметтер

Опциондық маржа шотының ақпараты (USER_DATA)

Ағымдағы шот туралы ақпаратты алу

АЛУ /eapi/v1/marginAccount (HMAC SHA256)

Маркет-мейкерді қорғау конфигурациясын орнату (САУДА)

MMP конфигурациясын орнатыңыз. Маркет-мейкерді қорғау (MMP) – опциондық маркет-мейкер үшін қорғаныс механизмдерінің жиынтығы. Бұл механизм қысқа уақыт кезеңінде жаппай сауданың алдын алады. Маркет-мейкердің шоты шекті бұзған кезде, MMP іске қосылады. Барлық ағымдағы MMP тапсырысы жойылады және барлық жаңа MMP тапсырысы қабылданбайды. Маркет-мейкер бұл жағдайды нарықты қайта бағалау және тапсырыс бағасын өзгерту үшін пайдалана алады.

ЖАРИЯЛАУ /eapi/v1/mmpSet (HMAC SHA256)

Маркет-мейкерді қорғау конфигурациясын алу (САУДА)

MMP конфигурациясын алу

АЛУ /eapi/v1/mmp (HMAC SHA256)

Маркет-мейкерді қорғау конфигурациясын қайта орнату (САУДА)

MMP-ді қайта орнатып, MMP тапсырысын қайта бастау

ЖАРИЯЛАУ /eapi/v1/mmpReset (HMAC SHA256)

Барлық ашық тапсырыстан (тез өшіру) автоматты түрде бас тарту конфигурациясын орнату (САУДА)

Бұл соңғы нүкте автоматты бас тарту функциясының параметрлерін орнатады. Егер іске қосылу туралы хабарлама жіберілмесе, ол көрсетілген кері санау кезеңінің соңында негізгі таңбаның барлық ашық тапсырысынан (MMP және MMP емес тапсырыстар) бас тартады. Кері санақ кезеңінен кейін барлық ашық тапсырыс жойылады. Іске қосылу хабары жіберілмейінше немесе кері санақ уақытын 0-ге орнату арқылы автоматты бас тарту мүмкіндігі өшірілгенше, жаңа тапсырыстардан -2010 қате кодымен бас тартылады.

ЖАРИЯЛАУ /eapi/v1/countdownCancelAll (HMAC SHA256)  

Барлық ашық тапсырыстан (тез өшіру) автоматты түрде бас тарту конфигурациясын алу (САУДА)

Бұл соңғы нүкте әрбір негізгі таңба үшін автоматты бас тарту параметрлерін қайтарады. Тек белсенді автоматты бас тарту параметрлері қайтарылатынын ескеріңіз. Кері санақ уақыты 0 мәніне орнатылса (яғни кері санақ уақыты өшірілген болса), жауап негізгі таңбаны қайтармайды және жауапта сәйкес кері санақ уақытының параметрі қайтарылмайды.

АЛУ /eapi/v1/countdownCancelAll (HMAC SHA256) 

Барлық ашық тапсырыстан (тез өшіру) автоматты түрде бас тарту жүрек соғысы (САУДА)

Бұл соңғы нүкте кері санақ басталғаннан осы хабарды алғанға дейінгі уақытты қалпына келтіреді. Ол «жүрек соғысы» деп аталады. Негізгі параметрде негізгі таңбаны тізім ретінде (BTCUSDT және ETHUSDT қоспағанда) көрсету арқылы бірден бірнеше жүрек соғысын жаңартуға болады.

POST /eapi/v1/countdownCancelAllHeartBeat (HMAC SHA256)