Կրիպտո փոխանակման API. Գնանշումներ, պատվերներ և ավանդային հասցեներ

EIDEX Merchant API v1-ը կրիպտո փոխանակիչի API է՝ գնանշումներով, պատվերներով, ավանդային հասցեներով մեկ ինտեգրման կետի ներքո: Միացեք մեկ անգամ՝ մուտք գործելու կենդանի գնագոյացում, պատվերների կյանքի ցիկլի ամբողջական կառավարում, ավանդային հասցեների տրամադրում, դուրսբերումներ և իրադարձությունների վեբհուկեր՝ բոլորը հիմնական URL-ի միջոցով `https://eidex.io/api/merchant/v1`: Այս հղումը ներառում է 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 բանալիի միջոցով։

Ինչ է անում Կրիպտո փոխանակման API-ն

Գնանշումներ

`GET /tickers`-ը վերադարձնում է առկա առևտրային զույգերը մեկ հետևողական ձևաչափով, այնպես որ դուք ինքներդ կապ չեք պահպանում արտաքին վայրի հետ։ Գնագոյացումը և պատվերների կատարումը երկուսն էլ իրականացվում են մեր միացված գործընկեր փոխանակման միջոցով, ինչը API-ն դարձնում է մեկ ինտեգրման կետ գնանշումների և հաշվարկների համար։ Նույն տոկոսադրույքը սնուցում է ինչպես ձեր խանութը, այնպես էլ ձեր ներկայացրած պատվերը, այնպես որ հաճախորդի տեսած գինը համընկնում է այն գնի հետ, որով փոխանակումն իրականացնում է։

Պատվերներ

Առևտրի ամբողջական կյանքի ցիկլը. `POST /order`-ը ստեղծում է փոխանակման պատվեր (զույգ, ԳՆԵԼ/ՎԱՃԱՌԵԼ կողմ, ՇՈՒԿԱՅԱԿԱՆ/ՍԱՀՄԱՆԱՓԱԿ տեսակ), `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` webhook – ներկայումս գոյություն չունի REST մեթոդ՝ հետ կանչի կարգավիճակը հարցնելու համար:

Webhooks

`GET` և `POST /webhooks`, ինչպես նաև `DELETE /webhooks/{id}`-ը կառավարում են իրադարձությունների բաժանորդագրությունները: Այսօր առաքվում են երկու իրադարձություն՝ `deposit.confirmed` և `withdraw.completed`: Պատվերի կատարման իրադարձությունը (`order.filled`) պահպանված է ավելի ուշ թողարկման համար, ուստի պատվերների կարգավիճակները առայժմ հարցվում են `GET /order/{id}`-ի միջոցով:

Ձեր խանութը և ապրանքանիշը մնում են ձերը. API-ն տրամադրում է գնանշումներ, կատարում է պատվերներ և կատարում հաշվարկներ, մինչ դուք կառուցում եք հաճախորդի հետ աշխատող ինտերֆեյսը: Բոլոր գործողությունները կատարվում են ձեր առևտրական հաշվի ներքո. API-ն չունի յուրաքանչյուր հաճախորդի համար ենթահաշիվներ:

Ինչ է բացում Crypto Exchanger 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` webhook:

Հասցեների պահոց և բաժանորդագրություններ (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. Ձեր բեքենդը հարցման համար հասցե է ամրագրում՝ `POST /address/reserve`՝ network-ի և nonce-ի հետ միասին։ Նույն 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 բոտ

Նույն սխեման առանց կայքի. բոտը ինտերֆեյսն է, և նրա բեքենդը խոսում է նույն էնդփոյնթների հետ։ Երկխոսության տրամաբանությունը՝ զույգի ընտրություն, փոխարժեքի ցուցադրում, հասցեի տրամադրում, ավանդի ծանուցում՝ հիմնված է վեբհուկների վրա, ուստի կարիք չկա կարգավիճակները ցիկլով հարցնելու։ Այստեղ հարմար է տրամադրել առանձին բանալի READONLY և TRADING թույլտվություններով՝ վճարումները պահելով այլ սխեմայով։

White-Label Desk

Խանութը, ապրանքանիշը և հաճախորդների բազան ձերն են. հաշվարկային շերտը մեր կողմում է։ Սցենարը գործում է նույն կանչերով և տարբերվում է միայն նրանով, թե որքան խորն եք հարմարեցնում ինտերֆեյսը. կրիպտո խողովակաշարը մնում է անտեսանելի վերջնական օգտագործողի համար ձեր ապրանքանիշի հետևում։

Սահմանափակումներ և Իդեմպոտենտություն

API բանալու համար կիրառվում է րոպեում 60 հարցման սահմանափակում, որը տարածվում է բոլոր ծայրակետերի վրա։ Յուրաքանչյուր պատասխան պարունակում է `X-RateLimit-Limit` և `X-RateLimit-Remaining` վերնագրեր. սահմանաչափը գերազանցելու դեպքում վերադարձվում է `429`՝ `Retry-After` վերնագրով, որը պարունակում է վայրկյանները մինչև հաջորդ պատուհանը։

`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 մարմնի հետ, որը հաշվարկվում է բաժանորդագրության գաղտնիքով, որը տրվել է մեկ անգամ ստեղծման ժամանակ: Եթե ձեր վերջնակետը անհասանելի է, առաքումը կրկնվում է մինչև 5 անգամ՝ աճող ինտերվալներով: Մշակելուց առաջ ստուգեք ստորագրությունը:

Գաղտնիքը պահեք սերվերի կողմում. ձեր ինտերֆեյսը երբեք չպետք է պահի այն: Գործառնական կանոնները և յուրաքանչյուր կողմի պարտականությունները շարադրված են օգտագործման պայմաններում։

Ինչպես միանալ

Կրիպտո փոխանակիչի API-ի ամբողջական բնութագիրը հրապարակված է մեքենայաընթեռնելի ձևով eidex.io/merchant-openapi.json հասցեում և ուղղակիորեն ներմուծվում է Postman-ում, Insomnia-ում կամ հաճախորդի գեներատորում: Ամենաարագ ճանապարհը արագ մեկնարկի ուղեցույցն է. թողարկեք բանալիներ, ստուգեք `GET /tickers`, ապա ստեղծեք ձեր առաջին փորձնական պատվերը: