Kripto ayirboshlovchi API: Kotirovkalar, Buyurtmalar va Depozit manzillari

EIDEX Merchant API v1 — bu Kripto Ayirboshlash API: Kotirovkalar, Buyurtmalar, Depozit manzillari bitta integratsiya nuqtasida. Jonli narxlarga, toʻliq buyurtma hayot siklini boshqarishga, depozit manzilini berishga, yechib olishlarga va hodisa veb-xuklariga kirish uchun bir marta ulaning — bularning barchasi `https://eidex.io/api/merchant/v1` asosiy URL orqali. Ushbu maʼlumotnoma API dagi har bir yakuniy nuqtani, har bir kalit nima qila olishini nazorat qiluvchi ruxsat modelini, uch bosqichli tezkor ishga tushirishni va kotirovkadan toʻlovgacha boʻlgan toʻliq ayirboshlash oqimining ishlangan misolini qamrab oladi.

EIDEX Merchant API v1 — bu yagona integratsiya nuqtasiga ega kripto ayirboshlash API: jonli kotirovkalar, buyurtma yaratish va kuzatish, depozit manzilini boshqarish, yechib olishlar va hodisa veb-xuklar. Asosiy URL https://eidex.io/api/merchant/v1 va autentifikatsiya bir juft sarlavhalardan foydalanadi.

Oxirgi yangilanish: 2026-yil 26-iyul · Merchant API v1. Ushbu sahifa va spetsifikatsiya farq qiladigan joylarda mashina oʻqiy oladigan spetsifikatsiya ustuvor hisoblanadi.

Asosiy xulosalar

• 14 yakuniy nuqtabesh guruhga boʻlingan: kotirovkalar, buyurtmalar, manzillar, yechib olishlar, veb-ilmalar.
• Uchta ruxsat darajasi har bir kalit uchun — READONLY, TRADING, WITHDRAW — shuning uchun integratsiya faqat oʻziga kerakli narsani oladi.
• Daqiqasiga 60 ta soʻrov har bir kalit uchun, barcha oxirgi nuqtalar boʻylab taqsimlangan, har bir javobda limit sarlavhalari bilan.
• 15 ta blokcheyn tarmogʻi depozitlar uchun; juftlik roʻyxati qattiq kodlash oʻrniga `GET /tickers` dan jonli ravishda tortiladi.
• Sandbox yoʻq: ishlab chiqish jonli asosiy URL manziliga qarshi, READONLY kaliti orqali xavfsiz tarzda amalga oshiriladi.

Kripto birjasi API nima qiladi

Kotirovkalar

`GET /tickers` mavjud savdo juftliklarini bir xil formatda qaytaradi, shuning uchun siz tashqi joyga ulanishni oʻzingiz saqlamaysiz. Narxlar va buyurtmalarni bajarish bizning ulangan hamkor birjamiz orqali amalga oshiriladi, bu esa API ni kotirovkalar va hisob-kitoblar uchun yagona integratsiya nuqtasiga aylantiradi. Xuddi shu stavka sizning doʻkoningizni ham, siz yuborgan buyurtmani ham taʼminlaydi, shuning uchun mijoz koʻrgan narx birja toʻldiradigan narxga mos keladi.

Buyurtmalar

Toʻliq savdo hayot aylanishi: `POST /order` birja buyurtmasini yaratadi (juftlik, BUY/SELL tomoni, MARKET/LIMIT turi), `GET /order/{id}` uning holatini qaytaradi, `GET /orders` ularni roʻyxatga oladi va `POST /order/{id}/cancel` bekor qiladi. Sizning oldingi qismingiz oʻz mantigʻini saqlaydi.

Manzillar, depozitlar va yechib olishlar

`GET /deposit-address?network=` maʼlum bir zanjir uchun qabul qiluvchi manzilni chiqaradi (network parametri majburiy), `GET /deposit-addresses` chiqarilgan manzillarni roʻyxatga oladi. `POST /address/reserve` manzilni uning identifikatori (nonce) orqali soʻrovingizga qulflaydi va `POST /address/release` savdo tugagandan soʻng uni poolga qaytaradi. `GET /balances` joriy savdogar balanslari haqida hisobot beradi; `POST /withdraw` toʻlovlarni boshlaydi. Natija `withdraw.completed` webhook sifatida keladi — hozirda pul yechish holatini soʻrash uchun REST usuli mavjud emas.

Webhooklar

`GET` va `POST /webhooks` hamda `DELETE /webhooks/{id}` hodisalar obunalarini boshqaradi. Bugun ikkita hodisa yetkaziladi: `deposit.confirmed` va `withdraw.completed`. Buyurtma bajarish hodisasi (`order.filled`) keyingi reliz uchun zaxiraga olingan, shuning uchun buyurtma holatlari hozircha `GET /order/{id}` orqali soʻraladi.

Doʻkoningiz va brendingiz sizniki boʻlib qoladi: API kotirovkalarni taqdim etadi, buyurtmalarni bajaradi va hisob-kitoblarni amalga oshiradi, siz esa mijozlarga yoʻnaltirilgan interfeysni qurasiz. Barcha operatsiyalar sizning savdogar hisobingiz ostida ishlaydi — APIda har bir mijoz uchun sub-hisoblar mavjud emas.

Kripto ayirboshlovchi API kaliti nimani ochadi: kotirovkalar, buyurtmalar va depozit manzillari

Har bir kalit bir qator ruxsatlarni oʻz ichiga oladi va har bir ruxsat oʻzining operatsiyalar doirasini ochadi. Har bir integratsiyaga unga kerak boʻlgan minimalni bering: pul yechish huquqisiz kalit mablagʻlarni tashqariga chiqara olmaydi, hatto u sizib chiqqan taqdirda ham.

Oʻqish huquqi (READONLY):

• Har bir mavjud savdo juftligi uchun jonli kurslar — `GET /tickers`
• Har bir aktiv boʻyicha savdogar balanslari, erkin va zaxiradagi — `GET /balances`
• Sizga kerak boʻlgan zanjirdagi depozit manzili — `GET /deposit-address?network=`
• Sizga berilgan har bir depozit manzili — `GET /deposit-addresses`
• Kursorli sahifalash bilan buyurtmalar roʻyxati — `GET /orders`
• Muayyan buyurtmaning holati — `GET /order/{id}`

Savdo (TRADING):

• Buyurtma yaratish: juftlik, SOTIB OLISH/SOTISH tomoni, MARKET/LIMIT turi — `POST /order`
• Buyurtmani bekor qilish — `POST /order/{id}/cancel`

Yechib olish (WITHDRAW):

• Tashqi manzilga toʻlovni boshlash — `POST /withdraw`. Minimal miqdorlar va kunlik limitlar qoʻllaniladi; natija `withdraw.completed` webhook sifatida keladi.

Manzillar puli va obunalar (TRADING ruxsati; obunalar roʻyxatini koʻrish — READONLY):

• Manzilni identifikatori (nonce) orqali soʻrovingizga qulflash; bir xil nonce bilan chaqiruvni takrorlash bir xil manzilni qaytaradi — `POST /address/reserve`
• Savdo yopilgandan soʻng manzilni pulga qaytarish — `POST /address/release`
• Voqea obunalarini yaratish, roʻyxatlash va oʻchirish — `POST`/`GET /webhooks`, `DELETE /webhooks/{id}`

Kalit nimalarni bermaydi:

• Kalitlarni boshqarish — berish va bekor qilish API orqali emas, balki boshqaruv panelida amalga oshiriladi
• Hisob sozlamalarini oʻzgartirish, tekshiruvdan oʻtish yoki P2Pda savdo qilish
• Boshqa foydalanuvchilar nomidan harakat qilish — har bir chaqiruv oʻzingizning savdogar hisobingiz ostida ishlaydi

Uch qadamda tez boshlash

1-qadam. Kalitlaringizni oling.Boshqaruv panelingizda (Sozlamalar → API kalitlari) `X-API-Key` va `X-API-Secret`ni bering. Maxfiy kalit yaratishda bir marta koʻrsatiladi — uni darhol saqlang. Xuddi shu ekranda kalit ruxsatnomalari (READONLY / TRADING / WITHDRAW) va ruxsat etilgan IP manzillarning ixtiyoriy roʻyxati oʻrnatiladi.

2-qadam. Kotirovkalarni soʻrang.

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-qadam. Buyurtma yarating.`POST /order` `Idempotency-Key` sarlavhasini talab qiladi, bu sizni qayta urinishlarda takroriy savdolardan himoya qiladi. Kalit TRADING ruxsatiga ega boʻlishi kerak.

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"}'

Limit buyurtma uchun `"type":"LIMIT"` va `"price":"<price>"` qoʻshing. Toʻliq maydonlar roʻyxati va qabul qilingan qiymatlar uchun spetsifikatsiyaga qarang.

Shundan soʻng, depozit va yechib olish veb-xuklariga obuna boʻling va buyurtma holati uchun `GET /order/{id}` soʻrovini yuboring.

Yakuniy nuqta maʼlumotnomasi

Birja oqimi qanday ishlaydi

Oddiy stol savdosi kripto ayirboshlovchi APIga oltita chaqiruvdan iborat boʻlib, sizning backend va yakuniy nuqtalar oʻrtasidagi ketma-ketlik quyidagicha koʻrinadi:

NaN. Mijoz yoʻnalishni tanlaydi — sizning doʻkoningiz `GET /tickers` dan narxlarni tortadi.

NaN. Sizning backendingiz soʻrov uchun manzilni band qiladi: network va nonce bilan `POST /address/reserve`. Xuddi shu nonce bilan chaqiruvni takrorlash bir xil manzilni qaytaradi, shuning uchun takroriy yuborishlar oqimni buzmaydi.

NaN. Mijoz mablagʻlarni berilgan manzilga yuboradi.

NaN. `deposit.confirmed` veb-xuki keladi — shu nuqtadan boshlab kiruvchi toʻlov tasdiqlangan hisoblanadi.

Yoʻq. Sizning backend buyurtma yaratadi: `POST /order` `Idempotency-Key` sarlavhasi bilan; holat `GET /order/{id}` orqali soʻraladi.

Yoʻq. Toʻlov `POST /withdraw` bilan boshlanadi va bajarilishi `withdraw.completed` webhook orqali xabar qilinadi. Savdo yopilgach, manzil `POST /address/release` orqali poolga qaytadi.

Bir martalik soʻrovlar va soatiga oʻnlab savdolar oqimi uchun bir xil ketma-ketlik qoʻllaniladi: toʻsiq odatda API emas, balki zanjirni tasdiqlash vaqti hisoblanadi.

Integratsiya stsenariylari

Birja veb-sayti

Klassik sozlash: sahifadagi kalkulyator, `GET /tickers` dan olingan kurslar, oʻzingizning CRM-da kuzatilgan soʻrovlar. API narxlash, bajarish va hisob-kitoblarni qamrab oladi, savdo qoidalari, mijozlarni tekshirish va qoʻllab-quvvatlash esa sizning tomoningizda qoladi.

Telegram boti

Veb-saytsiz bir xil sxema: bot interfeys boʻlib, uning backendi bir xil endpointlar bilan ishlaydi. Dialog mantigʻi — juftlikni tanlash, kursni koʻrsatish, manzilni berish, depozit haqida xabar berish — webhooklar orqali amalga oshiriladi, shuning uchun holatlarni doimiy ravishda soʻrashga hojat yoʻq. Bu yerda READONLY va TRADING ruxsatnomalari bilan alohida kalit berish qulay, toʻlovlarni boshqa sxemada saqlagan holda.

White-Label Desk

Doʻkon, brend va mijozlar bazasi sizniki; hisob-kitob qatlami bizning tomonimizda joylashgan. Stsenariy bir xil chaqiruvlar asosida ishlaydi va faqat interfeysni qanchalik chuqur moslashtirishingiz bilan farq qiladi — kripto tizimi sizning brendingiz ortida oxirgi foydalanuvchi uchun koʻrinmas boʻlib qoladi.

Kurs cheklovlari va Idempotency

Har bir API kaliti uchun daqiqasiga 60 ta soʻrov chegarasi qoʻllaniladi va barcha endpointlar boʻyicha taqsimlanadi. Har bir javobda `X-RateLimit-Limit` va `X-RateLimit-Remaining` sarlavhalari mavjud; chegaradan oshib ketish `429` ni qaytaradi, `Retry-After` sarlavhasida keyingi oyna ochilguncha qolgan soniyalar koʻrsatiladi.

`POST /order` va `POST /withdraw` uchun `Idempotency-Key` sarlavhasi talab qilinadi — xuddi shu naqsh IETF Idempotency-Key draftda tasvirlangan va toʻlov APIlarida qoʻllaniladi. Xuddi shu kalit va tana bilan soʻrovni takrorlash dublikat yaratish oʻrniga saqlangan javobni qaytaradi, boshqa tana bilan bir xil kalit esa rad etiladi. Bu pul oʻtkazmalari uchun qayta urinishlarni xavfsiz qiladi.

Har bir hisob 10 tagacha faol API kalitini va 5 ta webhook obunasini qoʻllab-quvvatlaydi. Xatolar bitta JSON shaklida qaytadi — `{"code", "message", "request_id"}` — va `request_id` ni keltirish qoʻllab-quvvatlash soʻrovlarini tezlashtiradi.

Xavfsizlik va kalit ruxsatnomalari

Hisobga olish maʼlumotlari `X-API-Key` va `X-API-Secret` sarlavhalarida yuboriladi — hech qachon soʻrov satrida yoki soʻrov tanasida emas — shuning uchun ular brauzer tarixi va oraliq proksi jurnallaridan tashqarida qoladi. Maxfiy kalit hech qachon jurnalga yozilmaydi; ichki yozuvlar faqat maskalangan kalit prefiksini saqlaydi.

Kalit ruxsatnomalari kalit nima qila olishini belgilaydi: oʻqishlar uchun READONLY, buyurtmalar yaratish va bekor qilish, depozit manzillarini band qilish va boʻshatish hamda vebhuk obunalarini boshqarish uchun TRADING, toʻlovlar uchun WITHDRAW. Har bir integratsiyaga u talab qiladigan minimal ruxsatnomani bering — WITHDRAW ruxsatnomasisiz sizib chiqqan kalit mablagʻlarni tashqariga chiqara olmaydi.

Siz kalitni berishda IP-manzillarni oq roʻyxatga kiritishni CIDR belgisidagi manzillar yoki quyi tarmoqlarni roʻyxatga kiritish orqali sozlaysiz. Agar siz roʻyxatni boʻsh qoldirsangiz, kalit sukut boʻyicha istalgan manzildan qabul qilinadi — WITHDRAW kalitlari uchun har doim oq roʻyxatni aniq belgilashni tavsiya etamiz.

Webhooklar imzolangan: ishlov beruvchingizga har bir chaqiruvda `X-Webhook-Signature` sarlavhasi mavjud boʻlib, unda HMAC-SHA256 tanasining hisoblangan qiymati joylashgan boʻladi, u yaratishda bir marta berilgan obuna siri bilan hisoblanadi. Agar sizning yakuniy nuqtangiz mavjud boʻlmasa, yetkazib berish ortib boruvchi intervallar bilan 5 martagacha qayta uriniladi. Qayta ishlashdan oldin imzoni tekshiring.

Sirni server tomonida saqlang; sizning oldingi interfeysingiz uni hech qachon saqlamasligi kerak. Ishlash qoidalari va har bir tomonning majburiyatlari foydalanish shartlarida belgilangan.

Qanday ulanish kerak

Kripto ayirboshlovchi API uchun toʻliq spetsifikatsiya mashina oʻqiydigan shaklda eidex.io/merchant-openapi.json manzilida nashr etilgan va toʻgʻridan-toʻgʻri Postman, Insomnia yoki mijoz generatoriga import qilinadi. Eng tezkor yoʻl bu tezkor ishga tushirish qoʻllanmasi: kalitlarni bering, `GET /tickers` ni tekshiring, soʻngra birinchi sinov buyurtmangizni yarating.