سؤالات متداول API

1. از کجا می‌توانم کلید API ایجاد کنم؟

لطفاً برای راهنمای کامل و مرحله‌به‌مرحله ایجاد کلید API، به راهنمای ایجاد API Key مراجعه کنید.

 

2. آیا کلیدهای API تاریخ انقضا دارند؟

بله. توبیت برای حفظ امنیت حساب شما، سیاست انقضا بر اساس تنظیمات امنیتی اعمال می‌کند. کلیدهای API که بدون محدودیت IP ساخته شوند، به‌صورت خودکار هر 90 روز منقضی می‌شوند و برای ادامه استفاده باید کلید جدید ایجاد کنید.
اما کلیدهایی که دارای لیست سفید IPهای مورد اعتماد باشند (حداکثر تا 15 IP برای هر کلید)، منقضی نخواهند شد. ما به‌شدت توصیه می‌کنیم از IP Whitelisting استفاده کنید تا هم امنیت حساب افزایش یابد و هم اتصال شما به API به‌صورت پایدار و بدون قطعی ادامه پیدا کند.

 

3. آیا می‌توانم سطح دسترسی یک API Key موجود را تغییر دهم؟

به‌صورت پیش‌فرض، تمام کلیدهای API جدید با دسترسی فقط خواندنی (Read-Only) ساخته می‌شوند.

شما می‌توانید در زمان ایجاد یا پس از آن، دسترسی «معامله» ( Write) را فعال کنید، اما این امکان فقط برای کاربرانی در دسترس است که احراز هویت پیشرفته را تکمیل کرده باشند. کاربرانی که احراز هویت پیشرفته را انجام نداده‌اند، فقط می‌توانند از کلیدهای Read-Only برای مشاهده داده‌های بازار و مانیتور کردن حساب استفاده کنند.

 

4. آیا برای استفاده از API ملزم به تکمیل فرآیند احراز هویت (KYC) هستم؟

الزام انجام احراز هویت (KYC) بر اساس سطح دسترسی مورد نظر شما به API تعیین می‌شود:

 

دسترسی فقط خواندن: انجام KYC الزامی نیست.

دسترسی خواندن/نوشتن: معامله‌گران موظف‌اند احراز هویت پیشرفته (KYC) را تکمیل کنند تا مجوز انجام معاملات و برداشت سرمایه برای آن‌ها فعال شود.

5. من یک همکار Toobit هستم. آیا پیکربندی API ویژه‌ای برای من وجود دارد؟

فرآیند اولیه راه‌اندازی API برای تمامی معامله‌گران یکسان بوده و تفاوتی در این مرحله وجود ندارد. شما می‌توانید کلیدهای API خود را از طریق بخش مدیریت API در حساب کاربری خود ایجاد و مدیریت نمایید.

 

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

 

به‌منظور دسترسی به مستندات کامل مربوط به همکاران:

لطفاً مستقیماً با نماینده توسعه کسب‌وکار (BD) اختصاصی خود تماس حاصل نمایید.

 

برای دریافت پشتیبانی فنی در خصوص یکپارچه‌سازی سیستم‌ها: نماینده BD شما قادر است آدرس دقیق اندپوینت‌ها و ساختارهای احراز هویت مورد نیاز برای دسترسی به داده‌های اختصاصی همکاران را در اختیار شما قرار دهد.

 

6. API Secret خود را گم کرده‌ام. چه کار باید بکنم؟

به دلایل امنیتی، API Secret فقط یک‌بار در زمان ایجاد نمایش داده می‌شود و بعد از آن قابل بازیابی نیست.
اگر Secret شما گم شده یا احتمال لو رفتن آن وجود دارد، باید:

• فوراً کلید API قدیمی را از بخش مدیریت API حذف کنید.

• یک جفت API Key جدید ایجاد نمایید.

• تنظیمات اپلیکیشن‌ها و ربات‌های خود را با اطلاعات جدید به‌روزرسانی کنید.

 

7. آدرس پایه API چیست؟

https://api.toobit.com

 

8. آیا API از WebSocket پشتیبانی می‌کند؟

بله. توبیت یک WebSocket API برای دریافت داده‌های لحظه‌ای ارائه می‌دهد.
برای جزئیات اتصال و لیست استریم‌ها، به مستندات WebSocket API مراجعه کنید.

 

9. کدهای خطای API را از کجا پیدا کنم؟

لیست کامل کدهای خطا در بخش مستندات Error Codes در دسترس است.

 

10. آیا توبیت محیط تست (Testnet / Sandbox) جداگانه دارد؟

در حال حاضر، توبیت یک تست‌نت خارجی مجزا ارائه نمی‌دهد. اما شما می‌توانید با استفاده از جفت‌ارزهای Demo Trading در محیط اصلی پلتفرم، منطق ربات و اتصال API خود را بدون استفاده از دارایی واقعی تست کنید. این روش از همان ساختار API واقعی استفاده می‌کند و کاملاً امن است.

 

11. آیا می‌توان سفارش فیوچرز را بر اساس مقدار USDT ثبت کرد، نه تعداد قرارداد؟

بله. API از هر دو روش پشتیبانی می‌کند. شما می‌توانید سفارش فیوچرز را با تعیین تعداد قراردا یا مقدار USDT یا هر دو ثبت نمایید. جزئیات بیشتر در مستندات مربوطه موجود است.

 

12. محدودیت نرخ درخواست‌ها (Rate Limits) چگونه است؟

در پاسخ API مربوط به مسیر زیر:

/api/v1/exchangeInfo

 

آرایه‌ای به نام rateLimits وجود دارد که شامل محدودیت‌های مربوط به:

• REQUEST_WEIGHT

• ORDERS

می‌باشد. برای جزئیات دقیق‌تر به مستندات مربوطه مراجعه کنید.

 

13. فرمت داده‌های درخواست و پاسخ چگونه است؟

تمامی اندپوینت‌ها خروجی خود را به‌صورت یک آبجکت JSON یا یک آرایه JSON برمی‌گردانند.