Կրիպտո փոխանակման 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, ապա ստեղծեք ձեր առաջին փորձնական պատվերը: