1. افتح موقع Gate. ضع المؤشر أعلى أيقونة الملف الشخصي لفتح القائمة وانقر على "إدارة واجهة برمجة التطبيقات".
2. انقر على "إنشاء مفتاح API" في الصفحة.
3. إنشاء مفتاح API
إنشاء مفتاح APIv2:
① أذونات IP: يمكنك اختيار ما إذا كنت تريد ربط IP أم لا. ملاحظة: إذا لم تقم بالربط، فسيُسمح بالوصول من أي عنوان وسيكون المفتاح صالحًا لمدة 90 يومًا.
② نوع مفتاح API: اختر مفتاح API v2. يُسمح لكل مستخدم بإنشاء مجموعة واحدة فقط، وسيؤدي إنشاء مجموعة جديدة إلى استبدال القديمة. بعد ذلك، يمكنك ضبط الأذونات لتكون "قراءة وكتابة" أو "قراءة فقط".
③ قم بتأكيد التفاصيل وانقر على "إرسال".
ملاحظة:
ستنتهي صلاحية مفتاح API السابق فورًا عند إنشاء مفتاح جديد.
يمكن استخدام مفاتيح API للاستعلام عن الحسابات، التداول، السحب، وغيرها.
يرجى الحفاظ على مفاتيح API الخاصة بك آمنة وعدم مشاركتها مع أي شخص.
قم بإنشاء مفتاح APIv4
① ملاحظات المفتاح: تساعد على التعرف على المفتاح لاحقًا.
② أذونات IP: مثل APIv2، يمكنك اختيار ربط IP من عدمه.
③ نوع المفتاح: اختر API v4
④ نوع الحساب: كلاسيكي، تداول بالهامش، أو Testnet
⑤ الأذونات: "قراءة وكتابة" أو "قراءة فقط" (ملاحظة: لا يمكن ترك زوج العملات فارغًا)
⑥ قم بتأكيد التفاصيل وانقر على "إرسال"
4. سيظهر تذكير بالمخاطر بعد النقر فوق "إرسال". يرجى قراءة التحذير بعناية، ثم انقر "أوافق" أو "إلغاء" للمتابعة.
أدخل كلمة مرور الصندوق، وحدد طرق التحقق 2FA، ثم انقر على "تأكيد" للمتابعة.
5. بعد إنشاء مفتاح API، يمكنك عرض المفتاح أو تعديله أو حذفه.
6. إشعار:
① مفاتيح APIv2 وAPIv4 تدعم السحب والإيداع. لاستخدام API للسحب، يجب استخدام عنوان سبق استخدامه في سحب يدوي، ويجب أن يكون قد مرّ أكثر من 24 ساعة منذ ذلك.
② الفرق بين APIv2 وAPIv4:
• مفاتيح APIv2 وAPIv4 مستقلة عن بعضها
• APIv2 مخصص فقط للتداول الفوري، أما APIv4 يدعم التداول الفوري، التداول بالهامش، وتداول العقود
• لإنشاء مفتاح APIv2 جديد، مرر إلى أسفل صفحة مفاتيح APIv2. مفاتيح APIv4 تُنشأ من: "المركز الشخصي" > "الحسابات الفرعية وAPI" > "مفاتيح APIv4"
*اختر بين APIv2 وAPIv4 بناءً على متطلباتك الخاصة. راجع هذه المقالة لمعرفة آخر التحديثات.
إذا لم تساعدك المقالة، يرجى إرسال تذكرة دعم تتضمن المعلومات التالية:
- UID الخاص بك
- عنوان URL للطلب
- المعلمات المستخدمة
- وصف تفصيلي لطلبك
- هل المفتاح للتداول الفوري أم الهامش
- الشبكة: Mainnet أم Testnet
- لغة البرمجة (مع كود الطلب إن أمكن)
- هل تستخدم SDK؟ (إذا نعم، اذكر كيفية الاستخدام أو شارك على GitHub)
7. يمكن الوصول إلى مستندات واجهة برمجة التطبيقات (API) من خلال "الخدمات" > "المطورون (API)" في أسفل الصفحة.
8. قاعدة الحد من التردد
| Markets | Endpoints | Limits | Based On | Include |
|---|---|---|---|---|
| All public endpoints | Public endpoints | 200r/10s per endpoint | IP | Orderbook, Candlestick, Ticker, etc. |
| Wallet | Private endpoints | Withdrawal(POST /withdrawals) : 1r/3s UID transfer(POST /withdrawals/push) 1r/10s Transfer between trading accounts (POST /wallet/transfers) 80r/10s Transfer between main and sub accounts (POST /wallet/sub_account_transfers) 80r/10s Transfer from a sub-account to another sub-account (POST /wallet/sub_account_to_sub_account) 80r/10s Retrieve user's total balances (GET /wallet/total_balance) 80r/10s Retrieve sub account balances (GET /wallet/sub_account_balances) 80r/10s Query sub accounts' margin balances (GET /wallet/sub_account_margin_balances) 80r/10s Query sub accounts' futures account balances (GET /wallet/sub_account_futures_balances) 80r/10s Query subaccount's cross_margin account info(GET /wallet/sub_account_cross_margin_balances) 80r/10s The Others: 200r/10s per endpoint |
UID | Withdrawal. Query personal account balance. Query subaccount balance. |
| Spot | Private endpoints | The rate limit for batch/single order placement and amend an order are total of 10r/s (UID+Market) The rate limit for batch/single order cancellation is total of 200r/s The Others: 200r/10s per endpoint |
UID | Spot order placement and cancellation. Trade history and fee rates. |
| Perpetual Futures | Private endpoints | The rate limit for batch/single order placement and amend an order are total of 100r/s The maximum rate limit for the order cancellation (bulk/single) is 200r/s The Others: 200r/10s per endpoint |
UID | Futures order placement and cancellation Trade history and fee rates |
| Delivery | Private endpoints | The maximum rate limit for the order placement (bulk/single) is 500r/10s The maximum rate limit for the order cancellation (bulk/single) is 500r/10s The Others: 200r/10s per endpoint |
UID | Order placement and cancellation |
| Options | Private endpoints | The maximum rate limit for the order placement (bulk/single) is 200r/s The maximum rate limit for the order cancellation (bulk/single) is 200r/s The Others: 200r/10s per endpoint |
UID | Order placement and cancellation |
| Subaccount | Private endpoints | 80r/10s per endpoint | UID | Create a sub-account. Retrieve the list of sub-accounts. Disable or enable API key for a sub-account. |
| Unified | Private endpoints | Borrow or repay 15/10s | UID | Borrow or repay(POST /unified/loans) |
| Other Private endpoints | Private endpoints | 150r/10s per endpoint | UID | Earning, collateral etc |
يُحسب الحد الزمني لكل حساب رئيسي أو فرعي.
WebSocket:
- عدد الرسائل المرسلة: غير محدود
- عدد الاتصالات المسموحة لكل IP: ≤ 300
ملاحظة:
عند تكرار انتهاك الحد:
- إذا كانت الطلبات < معدل الانفجار (burst rate)، سيتم تأخير الاستجابة
- إذا كانت الطلبات > معدل الانفجار، سيتم رفض الطلبات تلقائيًا
