آموزش استفاده از API XT برای معاملات خودکار

دستورالعمل‌های دسترسی به API XT

API REST
https://api.xt.com

به دلیل تأخیر بالا و پایداری ضعیف، دسترسی به API از طریق پروکسی توصیه نمی‌شود.

لطفاً هدر درخواست را به صورت زیر تنظیم کنید: Content-Type=application/x-www-form-urlencoded

محدودیت‌های سرعت
دریافت دارایی‌ها به 3 درخواست در ثانیه محدود می‌شود. سایر روش‌ها 10 درخواست در ثانیه برای هر کاربر و 1000 درخواست در دقیقه برای هر IP را محدود می‌کنند. تجاوز از این محدودیت منجر به قفل شدن حساب به مدت 10 دقیقه خواهد شد.

دستورالعمل‌های امضا
درخواست‌های API در حین انتقال اینترنتی بسیار مستعد دستکاری هستند. برای اطمینان از عدم تغییر درخواست‌ها، همه APIهای خصوصی، به جز APIهای عمومی (اطلاعات اولیه و داده‌های بازار)، باید با استفاده از کلید API شما امضا و تأیید شوند تا تأیید شود که پارامترها یا مقادیر در حین انتقال تغییر نکرده‌اند. هر کلید API باید مجوزهای مناسبی برای دسترسی به API مربوطه داشته باشد. به هر کلید API تازه ایجاد شده باید مجوزهایی اختصاص داده شود. انواع مجوزها عبارتند از: خواندن، معامله و برداشت. قبل از استفاده از یک API، لطفاً انواع مجوزهای هر API را بررسی کنید و تأیید کنید که کلید API شما مجوزهای مناسب را دارد.

یک درخواست معتبر شامل اجزای زیر است:

آدرس روش درخواست: این به آدرس سرور api.xt.com اشاره دارد، به عنوان مثال، api.xt.com/trade/api/v1/order.

کلید دسترسی API: کلید دسترسی در کلید API که برای آن درخواست داده‌اید.

مهر زمانی (nonce): مهر زمانی درخواست برنامه شما، یک عدد ۱۳ رقمی میلی‌ثانیه. این مهر زمانی برای تأیید اعتبار درخواست API شما استفاده خواهد شد.

امضا: مقدار امضای محاسبه شده، که برای اطمینان از معتبر بودن امضا و عدم دستکاری آن با استفاده از HmacSHA256 استفاده می‌شود.

مراحل امضا
درخواستی را که باید امضا شود، عادی‌سازی کنید. از آنجا که محاسبه امضای HMAC می‌تواند هنگام استفاده با محتوای متفاوت، نتایج کاملاً متفاوتی ایجاد کند، لطفاً قبل از محاسبه امضا، درخواست را عادی‌سازی کنید. مثال زیر درخواستی برای جستجوی جزئیات سفارش را نشان می‌دهد:

https://api.xt.com/trade/api/v1/getOrder?accesskey={AccessKey}&market={Market}&nonce={Timestamp}&id={OrderId}&signature={Signature}

نام پارامترها را به ترتیب ASCII مرتب کنید و آنها را با استفاده از کاراکتر ampersand (&) به هم متصل کنید. به عنوان مثال، نتیجه زیر پس از مرتب‌سازی نشان داده شده است:

accesskey=myAccessKey&id=123&market=btc_usdt&nonce=1562919832183

توجه داشته باشید که مقدار nonce یک مهر زمانی ۱۳ رقمی میلی‌ثانیه‌ای است.

از کلید مخفی به دست آمده در وب‌سایت برای امضای رشته پارامتر تولید شده در بالا با استفاده از HmacSHA256 استفاده کنید. برای مثال، نتیجه امضای پارامترهای فوق به صورت زیر است:

97b7b71741ca0aec6e0404a5b1c7cb2a78e7bd6c2a8088dbd84a20129dee4fe7

در نهایت، امضا را به پارامتری به نام signature اختصاص دهید و آن را به سرور ارسال کنید.

فرمت بازگشتی
تمام پاسخ‌های API در قالب JSON هستند.