Криптоайырбастаушы API: Баға белгілеулері, Тапсырыстар және Депозиттік мекенжайлар

EIDEX Merchant API v1 — бұл Crypto Exchanger API: Quotes, Orders, Deposit Addresses бір интеграция нүктесінде. Нақты уақыттағы бағаларды, толық тапсырыс өмірлік циклін басқаруды, депозиттік мекенжайды шығаруды, алуды және оқиға вебхуктарын — барлығын `https://eidex.io/api/merchant/v1` базалық URL арқылы қол жеткізу үшін бір рет қосылыңыз. Бұл анықтама API-дегі әрбір соңғы нүктені, әрбір кілттің не істей алатынын басқаратын рұқсат моделін, үш қадамдық жылдам бастауды және баға белгілеуден төлемге дейінгі толық айырбас ағынының жұмыс істеген мысалын қамтиды.

EIDEX Merchant API v1 — бұл бір интеграция нүктесі бар крипто айырбастаушы API: нақты уақыттағы баға белгілеулер, тапсырыс жасау және қадағалау, депозиттік мекенжайды басқару, алу және оқиға вебхуктары. Базалық URL:https://eidex.io/api/merchant/v1, ал аутентификация тақырыптар жұбын пайдаланады.

Соңғы жаңартылған күні: 2026 жылғы 26 шілде · Merchant API v1. Осы бет пен спецификацияда айырмашылықтар болған жағдайда, машина оқи алатын спецификация басым болады.

Негізгі қорытындылар

• 14 соңғы нүктебес топқа бөлінген: баға белгілеулер, тапсырыстар, мекенжайлар, шығарулар, вебхуктар.
• Рұқсаттың үш деңгейіәрбір кілт үшін — READONLY, TRADING, WITHDRAW — интеграция тек қажеттісін алады.
• Минутына 60 сұранысәрбір кілт үшін, барлық соңғы нүктелер бойынша бөлінген, әр жауапта шектеу тақырыптарымен.
• 15 блокчейн желісідепозиттер үшін; жұптар тізімі қолмен кодталғаннан гөрі `GET /tickers` арқылы тікелей тартылады.
• Құмсалғыш жоқ: әзірлеу тікелей базалық URL мекенжайына қарсы жүргізіледі, READONLY кілті арқылы қауіпсіз.

Crypto Exchanger API не істейді

Баға белгілеулер

`GET /tickers` қолжетімді сауда жұптарын бір ізді форматта қайтарады, сондықтан сіз сыртқы орынға қосылымды өзіңіз басқармайсыз. Баға белгілеу және тапсырысты орындау екеуі де біздің қосылған серіктес биржамыз арқылы жүзеге асырылады, бұл API-ді баға белгілеулер мен есеп айырысулар үшін бірыңғай интеграция нүктесі етеді. Дәл сол мөлшерлеме сіздің дүкеніңізді де, сіз жіберген тапсырысты да қамтамасыз етеді, сондықтан тұтынушы көретін баға биржа толтыратын бағаға сәйкес келеді.

Тапсырыстар

Толық сауда өмірлік циклі: `POST /order` биржалық тапсырыс жасайды (жұп, BUY/SELL жағы, MARKET/LIMIT түрі), `GET /order/{id}` оның күйін қайтарады, `GET /orders` оларды тізімдейді, және `POST /order/{id}/cancel` жояды. Сіздің интерфейсіңіз өзінің логикасын сақтайды.

Мекенжайлар, Депозиттер және Шығарулар

`GET /deposit-address?network=` нақты тізбек үшін қабылдау мекенжайын береді (желі параметрі қажет), `GET /deposit-addresses` берілген мекенжайларды тізімдейді. `POST /address/reserve` сұрауыңызға мекенжайды оның идентификаторы (nonce) арқылы бекітеді, ал `POST /address/release` сауда жабылғаннан кейін оны пулға қайтарады. `GET /balances` ағымдағы саудагер баланстарын хабарлайды; `POST /withdraw` төлемдерді бастайды. Нәтиже `withdraw.completed` веб-ілмек ретінде келеді — қазіргі уақытта шығару күйін сұрау үшін REST әдісі жоқ.

Веб-ілмектер

`GET`, `POST /webhooks` және `DELETE /webhooks/{id}` оқиға жазылымдарын басқарады. Бүгінгі таңда екі оқиға жеткізіледі: `deposit.confirmed` және `withdraw.completed`. Тапсырысты орындау оқиғасы (`order.filled`) кейінірек шығару үшін сақталған, сондықтан тапсырыс күйлері қазірше `GET /order/{id}` арқылы сұралады.

Сіздің дүкеніңіз бен брендіңіз сізде қалады: API баға белгілерін береді, тапсырыстарды орындайды және есеп айырысуды басқарады, ал сіз клиентке бағытталған интерфейсті құрасыз. Барлық операциялар сіздің саудагер шотыңыз бойынша орындалады — API-да әр клиентке арналған қосалқы шоттар жоқ.

Крипто айырбастаушы API кілті не береді: баға белгілері, тапсырыстар және депозиттік мекенжайлар

Әрбір кілт рұқсаттар жиынтығын алып жүреді, және әрбір рұқсат өзінің операциялар ауқымын ашады. Әрбір интеграцияға қажетті минимумды беріңіз: шығару құқығы жоқ кілт қаражатты шығара алмайды, тіпті ол ағып кетсе де.

Оқуға рұқсат (READONLY):

• Әрбір қолжетімді сауда жұбы үшін нақты уақыттағы бағалар — `GET /tickers`
• Әр актив бойынша саудагер баланстары, бос және резервтелген — `GET /balances`
• Сізге қажет тізбектегі депозиттік мекенжай — `GET /deposit-address?network=`
• Сізге берілген әрбір депозиттік мекенжай — `GET /deposit-addresses`
• Курсорлық пагинациясы бар тапсырыс тізімі — `GET /orders`
• Нақты тапсырыстың күйі — `GET /order/{id}`

Сауда (TRADING):

• Тапсырыс жасау: жұп, BUY/SELL жағы, MARKET/LIMIT түрі — `POST /order`
• Тапсырысты болдырмау — `POST /order/{id}/cancel`

Шығару (WITHDRAW):

• Сыртқы мекенжайға төлемді бастау — `POST /withdraw`. Ең төменгі сомалар мен күнделікті лимиттер қолданылады; нәтиже `withdraw.completed` вебхукі ретінде келеді.

Мекенжай пулы және жазылымдар (TRADING рұқсаты; жазылымдар тізімін көру — READONLY):

• Мекенжайды оның идентификаторы (nonce) арқылы сұрауыңызға құлыптау; бір nonce арқылы қайталанатын қоңырау бір мекенжайды қайтарады — `POST /address/reserve`
• Сауда жабылғаннан кейін мекенжайды пулға қайтару — `POST /address/release`
• Оқиға жазылымдарын жасау, тізімдеу және жою — `POST`/`GET /webhooks`, `DELETE /webhooks/{id}`

Кілт не бермейді:

• Кілттерді басқару — беру және кері қайтару API арқылы емес, бақылау тақтасында жүзеге асырылады
• Есептік жазба параметрлерін өзгерту, тексеруді іске қосу немесе P2P-де сауда жасау
• Басқа пайдаланушылардың атынан әрекет ету — әрбір қоңырау сіздің жеке саудагер шотыңызбен орындалады

Үш қадамда жылдам бастау

1-қадам. Кілттеріңізді алыңыз.Бақылау тақтаңызда `X-API-Key` және `X-API-Secret` беріңіз (Параметрлер → API кілттері). Құпия жасау кезінде бір рет көрсетіледі — оны дереу сақтаңыз. Дәл осы экран кілт рұқсаттарын (READONLY / TRADING / WITHDRAW) және рұқсат етілген IP мекенжайларының қосымша тізімін орнатады.

2-қадам. Баға белгілеулерін сұраңыз.

curl -X GET "https://eidex.io/api/merchant/v1/tickers" \
  -H "X-API-Key: <your_api_key>" \
  -H "X-API-Secret: <your_api_secret>"

3-қадам. Тапсырыс жасаңыз.`POST /order` қайталау кезінде қайталанатын саудалардан қорғайтын `Idempotency-Key` тақырыбын талап етеді. Кілтте TRADING рұқсаты болуы керек.

curl -X POST "https://eidex.io/api/merchant/v1/order" \
  -H "X-API-Key: <your_api_key>" \
  -H "X-API-Secret: <your_api_secret>" \
  -H "Idempotency-Key: <unique_request_id>" \
  -H "Content-Type: application/json" \
  -d '{"pair":"BTCUSDT","side":"BUY","type":"MARKET","amount":"0.001"}'

Лимит ордер үшін `"type":"LIMIT"` және `"price":"<price>"` қосыңыз. Толық өрістер тізімі мен қабылданған мәндер үшін спецификацияны қараңыз.

Осыдан кейін, депозит және шығару вебхуктарына жазылыңыз және тапсырыс күйі үшін `GET /order/{id}` сұрауын жіберіңіз.

Соңғы нүкте анықтамасы

Биржалық ағын қалай жұмыс істейді

Әдеттегі үстел саудасы крипто айырбастаушы API-ге алты қоңырау шалуға дейін жетеді, және сіздің бэкэнд пен соңғы нүктелер арасындағы реттілік келесідей болады:

NaN. Клиент бағытты таңдайды — сіздің дүкеніңіз `GET /tickers` арқылы бағаларды тартады.

NaN. Сіздің бэкэндеңіз сұрау үшін адресті резервтейді: network және nonce арқылы `POST /address/reserve`. Бірдей nonce арқылы қоңырауды қайталау бірдей адресті қайтарады, сондықтан қайталанатын жіберулер ағынды бұзбайды.

NaN. Клиент шығарылған адрес бойынша қаражат жібереді.

NaN. `deposit.confirmed` вебхукі келеді — осы сәттен бастап кіріс төлем расталған болып саналады.

NaN. Сіздің бэкэндиңіз тапсырысты жасайды: `POST /order` `Idempotency-Key` тақырыбымен; мәртебе `GET /order/{id}` арқылы сұралады.

NaN. Төлем `POST /withdraw` арқылы басталады, ал орындалуы `withdraw.completed` вебхук арқылы хабарланады. Сауда жабылғаннан кейін, мекенжай `POST /address/release` арқылы пулға қайтарылады.

Бір реттік сұраулар мен сағатына ондаған сауда ағыны бірдей реттілікпен қамтылады: әдетте шектеу API емес, тізбекті растау уақыты болып табылады.

Интеграция сценарийлері

Биржа веб-сайты

Классикалық орнату: беттегі калькулятор, `GET /tickers` арқылы алынған бағалар, сіздің CRM жүйеңізде қадағаланатын сұраулар. API баға белгілеуді, орындауды және есеп айырысуды қамтиды, ал сауда ережелері, клиентті тексеру және қолдау сіздің тарапыңызда қалады.

Telegram Bot

Веб-сайтсыз бірдей схема: бот интерфейс болып табылады, және оның бэкэндиі бірдей соңғы нүктелермен сөйлеседі. Диалог логикасы — жұпты таңдау, бағаны көрсету, мекенжайды беру, депозит туралы хабарлама — вебхуктарда жұмыс істейді, сондықтан мәртебелерді циклде сұраудың қажеті жоқ. Мұнда READONLY және TRADING рұқсаттары бар бөлек кілтті шығару ыңғайлы, төлемдерді басқа схемада сақтай отырып.

White-Label Desk

Дүкен, бренд және клиенттік база сіздікі; есеп айырысу қабаты біздің тарапымызда орналасқан. Сценарий бірдей қоңыраулармен жұмыс істейді және интерфейсті қаншалықты терең теңшейтініңізге байланысты ғана ерекшеленеді — крипто-сантехника сіздің брендіңіздің артында соңғы пайдаланушыға көрінбейді.

Баға шектеулері және Idempotency

Әрбір API кілтіне минутына 60 сұрау салу шектеуі қолданылады және барлық соңғы нүктелерде ортақ болып табылады. Әрбір жауапта `X-RateLimit-Limit` және `X-RateLimit-Remaining` тақырыптары болады; шектеуден асып кетсе, келесі терезеге дейінгі секундтарды көрсететін `Retry-After` тақырыбымен `429` қайтарылады.

`POST /order` және `POST /withdraw` үшін `Idempotency-Key` тақырыбы қажет — бұл IETF Idempotency-Key draft құжатында сипатталған және төлем API-лерінде қолданылатын үлгі. Бірдей кілтпен және денемен сұрауды қайталау қайталанғанды жасаудың орнына сақталған жауапты қайтарады, ал әртүрлі денемен бірдей кілт қабылданбайды. Бұл ақша қозғалысы үшін қайталауларды қауіпсіз етеді.

Әрбір тіркелгі 10 белсенді API кілтін және 5 webhook жазылымын қолдайды. Қателер бір JSON пішінінде — `{"code", "message", "request_id"}` — қайтарылады және `request_id` келтіру қолдау сұрауларын жылдамдатады.

Қауіпсіздік және кілт рұқсаттары

Тіркелгі деректері `X-API-Key` және `X-API-Secret` тақырыптарында беріледі — ешқашан сұрау жолында немесе сұрау денесінде емес — сондықтан олар браузер тарихынан және аралық прокси журналдарынан тыс қалады. Құпия ешқашан тіркелмейді; ішкі жазбаларда тек маскаланған кілт префиксі сақталады.

Кілт рұқсаттары кілттің не істей алатынын шектейді: оқу үшін READONLY, тапсырыстарды жасау және жою, депозит мекенжайларын брондау және босату, вебхук жазылымдарын басқару үшін TRADING, төлемдер үшін WITHDRAW. Әрбір интеграцияға қажетті ең аз рұқсатты беріңіз — WITHDRAW рұқсаты жоқ ағып кеткен кілт қаражатты шығара алмайды.

Кілтті шығарған кезде IP-ті ақ тізімге енгізуді CIDR нотациясындағы мекенжайларды немесе ішкі желілерді тізімдеу арқылы конфигурациялайсыз. Егер сіз тізімді бос қалдырсаңыз, кілт әдепкі бойынша кез келген мекенжайдан қабылданады — WITHDRAW кілттері үшін әрқашан ақ тізімді нақты орнатуды ұсынамыз.

Вебхуктарға қол қойылған: сіздің өңдеушіңізге әрбір қоңырау `X-Webhook-Signature` тақырыбын алып жүреді, онда HMAC-SHA256 бар, ол жасау кезінде бір рет берілген жазылым құпиясымен есептелген дененің HMAC-SHA256. Егер сіздің соңғы нүктеңіз қолжетімсіз болса, жеткізу аралықтарды арттырумен 5 ретке дейін қайталанады. Өңдеу алдында қолтаңбаны тексеріңіз.

Құпияны сервер жағында сақтаңыз; сіздің интерфейсіңіз оны ешқашан ұстамауы керек. Жұмыс ережелері мен әр тараптың жауапкершіліктері пайдалану шарттарында көрсетілген.

Қалай қосылуға болады

Крипто айырбастаушы API-нің толық спецификациясы машина оқитын түрде eidex.io/merchant-openapi.json мекенжайында жарияланған және Postman, Insomnia немесе клиент генераторына тікелей импортталады. Ең жылдам жол - жылдам бастау нұсқаулығы: кілттерді шығарыңыз, `GET /tickers` тексеріңіз, содан кейін алғашқы сынақ тапсырысыңызды жасаңыз.