ليس في KuCoin مفتاح اسمه «للقراءة فقط». مفتاحها للقراءة هو المفتاح الذي له صلاحية General ولا شيء غيرها. يقرأ SetupBook تنفيذاتك بمفتاح كهذا، فتصل صفقاتك في العقود الآجلة USDT-M والسوق الفوري إلى يوميتك دون أي كتابة. وتطلب KuCoin أيضًا عبارة مرور حين تنشئ المفتاح، ويحتاجها SetupBook. يستغرق ذلك نحو خمس دقائق.
يعرض هذا الدليل كل خطوة بالصور. ولمعرفة كيف ترتبط كل المنصات اقرأ نظرة عامة على كل الاتصالات. وإن كنت تستخدم MEXC أيضًا فانظر دليل MEXC.
قبل أن تبدأ
- حساب SetupBook مع Pro. ربط المنصات جزء من Pro، وكل يومية تبدأ بـ 14 يومًا منه: ابدأ 14 يومًا مجانًا.
- حساب KuCoin. تطلب KuCoin فحص أمان حين تنشئ مفتاحًا: كلمة مرور التداول، إضافة إلى رمز من بريدك ورمز من تطبيق المصادقة.
- مكان تدوّن فيه عبارة المرور، مثل مدير كلمات المرور.
- خمس دقائق.
المفتاح يقرأ فقط. تضع علامة على General وتترك Spot وFutures وMargin وEarn وWithdrawal فارغة. لا يضع SetupBook أمرًا أبدًا ولا ينقل أموالًا. يخزّن المفتاح وعبارة المرور مختومين على الخادم ويستخدمهما لقراءة تنفيذاتك.
1. افتح API Management وأنشئ مفتاحًا
في موقع KuCoin انقر صورتك الرمزية، واختر API Management واضغط Create API. تسألك KuCoin ما غرض المفتاح: اختر API Trading، وهو الخيار الذي ينشئ مفتاحًا خاصًا بك. ثم اكتب API name (سمِّه SetupBook) وAPI passphrase.
2. فعّل General ولا شيء غيره
في خطوة الصلاحيات ضع علامة على General. تصفها KuCoin بأنها محصورة في عمليات القراءة: معلومات الحساب وكشوفه ومعلومات الأوامر. اترك Spot وFutures وMargin وEarn وWithdrawal فارغة، واترك أي مربع آخر فارغًا أيضًا. قد تختلف الكلمات في النموذج قليلًا من منطقة إلى أخرى (يسمّي الموقع الأوروبي هذه الخطوة API Restrictions)، فابحث عن مربع General.
تقييد IP: تقول مساعدة KuCoin إن المفتاح الذي يتداول يجب ربطه بعنوان IP. مفتاحك لا يتداول، فاترك التقييد معطّلًا. وإن أصرّ النموذج على عنوان رغم ذلك، فاسألنا عبر نموذج الملاحظات أسفل الاتصالات: لا نستطيع بعد أن نعطيك عنوانًا ثابتًا تسمح به. ومع مفتاح للقراءة فقط لا يمكن التداول ولا السحب في الحالتين.
3. انسخ المفتاح والسر وعبارة المرور
أكّد فحص الأمان. تعرض KuCoin API key وsecret. انسخهما إلى مكان آمن، مع عبارة المرور. لا تستطيع KuCoin استعادة أي من الثلاثة إذا ضاع، فإن فقدت واحدًا فأنشئ مفتاحًا جديدًا.
4. الصق الثلاثة في SetupBook
في SetupBook افتح الحسابات ← الاتصالات واضغط إضافة اتصال. اختر KuCoin. الصق المفتاح في مفتاح API والسر في سر API وعبارة المرور في عبارة المرور.
تحت الأسواق ضع علامة على ما تتداوله: عقود USDT الدائمة (العقود الآجلة USDT-M) وفوري. وللسوق الفوري، لا تملك KuCoin استدعاء «ماذا تداولت»، فاكتب الأزواج التي تتداولها في أزواج السوق الفوري، مفصولة بفواصل، مثل BTC-USDT, ETH-USDT. أزواج العملات التي تملكها تُضاف من تلقاء نفسها. أما العقود الآجلة فلا تحتاج قائمة.
اترك إلى الحساب على إنشاء من حساب المنصة، أو اختر أحد حساباتك، واضغط تحقق من المفتاح واربط.
لا تخبر KuCoin المفتاحَ بصلاحياته، فلا يستطيع SetupBook تنبيهك إن وضعت علامة على مربع تداول خطأً. انظر إلى صلاحيات المفتاح في KuCoin مرة واحدة للتأكد.
5. تابع أول مزامنة
تبدأ أول مزامنة فورًا. تصل العقود الآجلة إلى نحو ثلاثة أشهر للخلف؛ ويُقرأ السوق الفوري زوجًا زوجًا بقدر ما تقدّمه KuCoin. وحين تنتهي يعرض الاتصال نشط ووقت آخر مزامنة وعدد الصفقات. بعد ذلك يبحث SetupBook عن تنفيذات جديدة كل ساعة، ويمكنك الضغط على زامن الآن في أي لحظة.
ما تحصل عليه:
- مراكز لا تنفيذات متفرقة. تُجمَّع التنفيذات في مراكز بالطريقة نفسها التي يعمل بها استيراد الملفات، فالمركز الذي أُغلق على ثلاثة أجزاء صفقة واحدة بثلاثة مخارج.
- حجم العقد. يساوي عقد العقود الآجلة مقدارًا ثابتًا من العملة (عقد BTC المسمّى XBTUSDTM يساوي 0.001 BTC)، ويستخدم SetupBook ذلك، فيطابق الحجم والنتيجة ما في KuCoin.
- حقول مقفلة. الرمز والاتجاه والأوقات والأسعار والحجم والرسوم والنتيجة الصافية تأتي من KuCoin وتبقى دقيقة (وهي تغذّي صافي الربح والخسارة لديك). أما الخطة وجودة الإعداد والأخطاء والملاحظات ولقطات الشاشة فتبقى لك.
- المنطقة الزمنية. أوقات KuCoin بتوقيت UTC، فلا شيء تضبطه.
- غير مشمول. العقود المسعّرة بالعملة (inverse) ومدفوعات التمويل لا تُقرأ.
تجريبي أو حقيقي
يربط SetupBook حسابات KuCoin الحقيقية فقط. ليس لدى KuCoin تداول تجريبي يستطيع SetupBook قراءته.
استبدال مفتاح
افتح قائمة الاتصال، واختر تعديل واضغط استبدال المفتاح. الصق المفتاح والسر وعبارة المرور الجديدة واحفظ: يتحقق SetupBook منها وينسى القديمة ويستخدم الجديدة من المزامنة التالية. وتبقى الصفقات.
مشكلات
مشكلة في الاتصال؟ اكتب لنا من صفحة الاتصالات مع ما جرّبته. نردّ بالبريد خلال 30 دقيقة، كل يوم.
الأسئلة الشائعة
هل هو آمن؟ هل يستطيع SetupBook التداول أو السحب؟
لا. المفتاح بصلاحية General فقط لا يستطيع وضع أمر ولا السحب، ولا يحوي SetupBook أي كود يحاول ذلك. يُخزَّن المفتاح وعبارة المرور مختومين على الخادم ولا يُرسلان إلى متصفحك أبدًا. وللتوقف احذف المفتاح في KuCoin فيتوقف الاتصال.
لماذا يحتاج SetupBook إلى عبارة المرور؟
توقّع KuCoin كل طلب بعبارة المرور إلى جانب المفتاح والسر. وبدونها ترفض KuCoin الطلب. وأنت من اخترت عبارة المرور حين أنشأت المفتاح.
هل أحتاج إلى تقييد عنوان IP؟
لا. اتركه معطّلًا. لا نستطيع بعد أن نعطيك عنوانًا ثابتًا تسمح به؛ وإن أردت عنوانًا فاسألنا في نموذج الملاحظات. المفتاح للقراءة فقط لا يستطيع التداول ولا السحب، سواء وُجدت قاعدة IP أم لا.
لماذا يجب أن أدرج أزواج السوق الفوري؟
لا تملك KuCoin استدعاءً يعيد أزواج السوق الفوري التي تداولتها. تدرج أنت الأزواج، ويضيف SetupBook فوقها أزواج العملات التي تملكها. أما العقود الآجلة فلا تحتاج قائمة.
هل يكلّف شيئًا؟
ربط المنصات جزء من Pro. وكل يومية تبدأ بـ 14 يومًا من Pro، ولا يُخصم شيء طوال هذه الأيام الـ 14. وإن ألغيت قبل أن تنتهي بقيت على الخطة المجانية التي تحتفظ بالإدخال اليدوي.
هل تفضّل ملفًا؟ الاستيراد ما زال يعمل: انظر دليل الاستخدام. ولربط منصة تداول أخرى اقرأ دليل Hyperliquid.