سوالات رایج

سوال 1: عدم توانایی برداشت وجوه حتی پس از اضافه کردن آدرس به لیست سفید

دلایل:

1. لیست سفید در صفحه برداشت و لیست سفید برداشت API مستقل از یکدیگر هستند.

2. آدرس‌هایی که از طریق [صفحه برداشت] > [مدیریت آدرس برداشت] اضافه می‌شوند، برای برداشت‌های API قابل استفاده نیستند.

راه حل:

1. به صفحه مدیریت لیست سفید برداشت API مراجعه کنید: https://www.coinex.com/apikey

2. آدرس برداشت را به لیست سفید مخصوص API اضافه کنید.

سوال 2: خطای access_id not exist

دلایل رایج:

(1) کلیدهای API جدید معمولاً حدود 10 دقیقه زمان نیاز دارند تا فعال شوند. فراخوانی API بلافاصله پس از ایجاد ممکن است باعث این خطا شود.

(2) access_id نادرست.

(3) تأیید امضای نامعتبر.

(4) هدر درخواست نادرست.

راه حل:

(1) به [مستندات API کوینکس] مراجعه کنید تا نحوه ساخت یک درخواست احراز هویت HTTP را یاد بگیرید.

(2) نمونه:

سوال 3: خطای 3008/4001 service unavailable

دلیل: این خطا ممکن است هنگام لغو سفارش‌ها در دوره‌های بار سرور بالا رخ دهد.

راه حل:

(1) به لغو سفارش‌های مهم اولویت دهید.

(2) پس از 1-2 ثانیه دوباره تلاش کنید.

(3) اگر پاسخ code: 0 را برمی‌گرداند اما سفارش لغو نمی‌شود:

• درخواست و پاسخ کامل را ثبت کنید.

• با پشتیبانی مشتری تماس بگیرید و اطلاعات حساب اصلی/فرعی را برای کمک ارائه دهید.

سوال 4: خطای اشتباه پارامتر

دلیل: این معمولاً زمانی رخ می‌دهد که پارامترهای آپلود شده با انواع مشخص شده در مستندات API مطابقت ندارند.

راه حل: با استفاده از نقطه پایانی POST /spot/cancel-order به عنوان مثال:

(1) نام‌ها و انواع پارامترها را با دقت با مستندات API مقایسه کنید.

(2) به تفاوت‌های بین انواع عددی و رشته‌ای توجه ویژه داشته باشید.

سوال 5: محدودیت‌های نرخ API چیست؟

محدودیت‌های نرخ به محدودیت‌های نرخ کوتاه‌مدت و بلندمدت تقسیم می‌شوند که می‌توان از طریق هدر پاسخ شناسایی کرد:

1. محدودیت‌های نرخ کوتاه‌مدت: اگر مقدار X-RateLimit-Limit بیشتر از 0 باشد، محدودیت نرخ کوتاه‌مدت فعال نشده است.

محدودیت کوتاه‌مدت از مکانیسم سطل توکن استفاده می‌کند، با محدودیت‌های نرخ مستقل برای حساب‌های اصلی و فرعی.

• خطای رایج پس از فعال شدن: کد: 213، 4213

• پیام: لطفاً خیلی مکرر تلاش نکنید.

2. محدودیت‌های نرخ بلندمدت: اگر X-RateLimit-LongPeriod-{period}-Remaining برگردانده شود، محدودیت‌های نرخ بلندمدت فعال شده‌اند. سیستم حجم و کیفیت درخواست کاربر را ارزیابی می‌کند تا تصمیم بگیرد آیا محدودیت‌هایی را بر مجموع درخواست‌ها در یک دوره طولانی‌تر اعمال کند. پس از فعال شدن، نرخ درخواست برای تمام نقاط پایانی (به جز لغو سفارش) به 1 درخواست در ثانیه محدود می‌شود.

• خطای رایج: کد: 213، 4213

• قضاوت اضافی از طریق هدر پاسخ مورد نیاز است.

سایر سوالات رایج

سوال 1: چگونه تأخیر درخواست API را کاهش دهیم؟

سرورها در AWS توکیو مستقر شده‌اند و از تعادل بار بین منطقه‌ای پشتیبانی می‌کنند. می‌توانید یک منطقه نزدیک را برای به حداقل رساندن تأخیر انتخاب کنید.

مناطق در دسترس:

• ap-northeast-1a

• ap-northeast-1c

• Ap-northeast-1d

سوال 2: آیا برای برداشت‌های API به 2FA نیاز است؟

به دلایل امنیتی:

1. قبل از استفاده از برداشت‌های API، باید وارد شوید و از طریق 2FA مجوز دهید.

2. پس از اضافه کردن آدرس‌های برداشت به [لیست سفید برداشت]، می‌توانید برداشت‌های API را آغاز کنید

بدون نیاز به تایید دو مرحله‌ای بیشتر.

سوال 3: آیا می‌توان آدرس‌های لیست سفید برداشت را از طریق API اضافه کرد؟

در حال حاضر، افزودن آدرس‌های لیست سفید برداشت از طریق API پشتیبانی نمی‌شود. لطفاً به [مدیریت API] > [لیست سفید برداشت] مراجعه کنید تا به صورت دستی یا گروهی آدرس‌ها را اضافه کنید.

سوال 4: اشتباه امضای نادرست

راه حل‌ها:

1. بررسی کنید که آیا access_id و secret_key به درستی پیکربندی شده‌اند.

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

3. اگر از کتابخانه شخص ثالث برای امضا استفاده می‌کنید، مطمئن شوید که به درستی پیکربندی شده است.

سوال 5: اشتباه بررسی Tonce - Tonce صحیح باید در محدوده یک دقیقه از زمان فعلی باشد

راه حل:

(1) اطمینان حاصل کنید که مهر زمانی برای تمام درخواست‌های API به میلی‌ثانیه است.

مثال:

(2) تأیید کنید که کامپیوتر شما همگام‌سازی خودکار زمان را فعال کرده است.

سوال 6: چگونه موجودی در دسترس واقعی و ارزش خالص یک حساب فیوچرز را بازیابی کنیم؟

(1) از نقطه پایانی /assets/futures/balance برای بازیابی فیلد در دسترس استفاده کنید، که نشان‌دهنده موجودی در دسترس فعلی حساب فیوچرز است.

(2) نقاط پایانی API در حال حاضر از بازگرداندن ارزش خالص حساب پشتیبانی نمی‌کنند. ارزش خالص مجموع سودها و زیان‌های محقق شده و محقق نشده است.

(3) سودها و زیان‌های محقق نشده مقادیر ثابتی نیستند و ممکن است با تغییرات موقعیت نوسان داشته باشند. برای نتایج دقیق، محاسبات دستی لازم است.

(4) برای فرمول‌های محاسبه، به مستندات "نحوه محاسبه درآمد حساب قرارداد خطی و PNL" مراجعه کنید.

سوال 7: چگونه داده‌های بازگشتی از API WebSocket را پردازش کنیم؟

API WebSocket داده‌ها را در قالب رشته JSON فشرده‌شده برمی‌گرداند، که قبل از استفاده باید فشرده‌زدایی شود (مثلاً با استفاده از ماژول gzip).

اشتباه رایج:

utf-8 codec can't decode byte 0x8b in position 1: invalid start byte

سوال 8: اگر یک پلتفرم مالیاتی شخص ثالث خطا گزارش دهد، چه باید کرد؟

سرویس‌های V1 در 25 سپتامبر 2024 (مصادف با 4 مهر 1403) متوقف شدند. خطا ممکن است به دلیل عدم ارتقاء کد پلتفرم به V2 باشد. لطفاً برای کمک با پلتفرم مالیاتی مربوطه تماس بگیرید.

سوال 9: چگونه یک اتصال WebSocket موفق را تأیید کنیم؟

پس از اشتراک موفق، یک پاسخ نتیجه اشتراک دریافت خواهید کرد.

پس از آن، به‌روزرسانی‌های پیام‌های مشترک شده را دریافت خواهید کرد:

سوال 10: چرا اتصال WebSocket به طور خودکار قطع می‌شود؟ چگونه اتصال را حفظ کنیم؟

(1) قطع شدن WebSocket معمولاً به دلیل مشکلات شبکه است. لطفاً بررسی کنید که آیا اتصال شبکه پایدار است.

(2) برای حفظ اتصال WebSocket، باید از server.ping برای زنده نگه داشتن آن استفاده کنید.

(3) اگر به مدت 1 دقیقه با سرور ارتباطی نباشد، اتصال WebSocket به طور خودکار قطع می‌شود. توصیه می‌شود یک فاصله ارسال در محدوده 60 ثانیه از طریق رابط ping تنظیم کنید تا اتصال فعال بماند.

برای سایر خطاهای API، لطفاً اینجا کلیک کنید تا با پشتیبانی مشتری تماس بگیرید و اطلاعات زیر را برای کمک به حل مشکل ارائه دهید:

(1) ایمیل حساب اصلی یا نام کاربری حساب فرعی.

(2) جزئیات کامل درخواست و پاسخ.

مهم: برای جلوگیری از ضررهای غیرضروری، access_id و secret_key را در پیام‌های خطا به اشتراک نگذارید.