تقدّم OKX عبر API تنفيذات بضعة أشهر. يستطيع SetupBook قراءتها بمفتاح للقراءة فقط، فتصل صفقاتك في عقود USDT الدائمة والسوق الفوري إلى يوميتك دون أي كتابة. لدى OKX خطوة إضافية لا تملكها المنصات الأخرى: تبتكر عبارة مرور حين تنشئ المفتاح، ويحتاجها SetupBook أيضًا. يستغرق ذلك نحو خمس دقائق.
يعرض هذا الدليل كل خطوة بالصور. ولمعرفة كيف ترتبط كل المنصات اقرأ نظرة عامة على كل الاتصالات. وإن كنت تتداول على Bitget أيضًا، وهي تستخدم عبارة مرور كذلك، فانظر دليل Bitget.
قبل أن تبدأ
- حساب SetupBook مع Pro. ربط المنصات جزء من Pro، وكل يومية تبدأ بـ 14 يومًا منه: ابدأ 14 يومًا مجانًا.
- حساب OKX. في بعض المناطق تطلب OKX أصولًا لا تقل عن 100 دولار قبل أن تسمح لك بإنشاء مفتاح.
- مكان تدوّن فيه عبارة المرور، مثل مدير كلمات المرور.
- خمس دقائق.
المفتاح يقرأ فقط. تضع علامة على Read وتترك Trade وWithdraw فارغين. لا يضع SetupBook أمرًا أبدًا ولا ينقل أموالًا. يخزّن المفتاح وعبارة المرور مختومين على الخادم ويستخدمهما لقراءة تنفيذاتك.
1. افتح صفحة API وأنشئ مفتاحًا
في موقع OKX اذهب إلى ملفك الشخصي، واختر API and connections واضغط Create API key. وفي التطبيق المسار هو Menu، ثم API، ثم Create API key.
يطلب النموذج API name (سمِّه SetupBook) والصلاحيات وIP address allowlist اختيارية وعبارة مرور.
2. فعّل Read ولا شيء غيره
تحت Permissions ضع علامة على Read. اترك Trade وWithdraw فارغين، واترك أي مربع آخر يظهر (مثل التحويل) فارغًا أيضًا. تقول OKX إن المفتاح بصلاحية Read فقط يستطيع عرض بيانات الحساب ولا يستطيع وضع أوامر.
تقييد IP: اترك القائمة المسموح بها فارغة. لا نستطيع بعد أن نعطيك عنوانًا ثابتًا تسمح به. وإن أردت عنوانًا فاسألنا عبر نموذج الملاحظات أسفل الاتصالات. ومع مفتاح للقراءة فقط لا يمكن التداول ولا السحب في الحالتين. تحذف OKX المفاتيح التي تستطيع التداول وليس لها عنوان IP بعد 14 يومًا من عدم الاستخدام؛ وهذه القاعدة لا تمس مفتاح القراءة فقط.
3. اختر عبارة مرور وانسخ المفتاح
اكتب عبارة مرور من اختيارك. تحتفظ OKX بنسخة مشوّشة منها فقط، فلا يمكن عرضها مرة أخرى: إن فقدتها فاحذف المفتاح وأنشئ مفتاحًا جديدًا. أكّد بفحص الأمان. ثم تعرض OKX API key وsecret key. انسخ المفتاح والسر وعبارة المرور إلى مكان آمن.
4. الصق الثلاثة في SetupBook
في SetupBook افتح الحسابات ← الاتصالات واضغط إضافة اتصال. اختر OKX واترك البيئة على حقيقي. الصق المفتاح في مفتاح API والسر في سر API وعبارة المرور في عبارة المرور.
تحت الأسواق ضع علامة على ما تتداوله: عقود مبادلة USDT الدائمة وفوري. لا تحتاج OKX قائمة أزواج. اترك إلى الحساب على إنشاء من حساب المنصة، أو اختر أحد حساباتك، واضغط تحقق من المفتاح واربط.
يثبت SetupBook صحة المفتاح بقراءة رصيدك. لا تخبر OKX المفتاحَ بصلاحياته، فلا يستطيع SetupBook تنبيهك إن وضعت علامة على Trade خطأً. انظر إلى صلاحيات المفتاح في OKX مرة واحدة للتأكد.
5. تابع أول مزامنة
تبدأ أول مزامنة فورًا وتصل إلى نحو ثلاثة أشهر للخلف، بقدر ما تقدّمه OKX. وحين تنتهي يعرض الاتصال نشط ووقت آخر مزامنة وعدد الصفقات. بعد ذلك يبحث SetupBook عن تنفيذات جديدة كل ساعة، ويمكنك الضغط على زامن الآن في أي لحظة.
ما تحصل عليه:
- مراكز لا تنفيذات متفرقة. تُجمَّع التنفيذات في مراكز بالطريقة نفسها التي يعمل بها استيراد الملفات، فالمركز الذي أُغلق على ثلاثة أجزاء صفقة واحدة بثلاثة مخارج.
- حقول مقفلة. الرمز والاتجاه والأوقات والأسعار والحجم والرسوم والنتيجة الصافية تأتي من OKX وتبقى دقيقة (وهي تغذّي صافي الربح والخسارة لديك). أما الخطة وجودة الإعداد والأخطاء والملاحظات ولقطات الشاشة فتبقى لك.
- المنطقة الزمنية. أوقات OKX بتوقيت UTC، فلا شيء تضبطه.
- غير مشمول. العقود المسعّرة بالعملة (inverse) ومدفوعات التمويل لا تُقرأ.
أقدم من ثلاثة أشهر؟ هذا التاريخ يجب أن يدخل كملف. إن استطعت تصديره من OKX بصيغة CSV فخيار CSV آخر (ربط الأعمدة) في الاستيراد يربط أعمدته: انظر دليل الاستيراد.
Demo Trading
لدى OKX Demo Trading مفاتيحه الخاصة. في OKX افتح Trade ← Demo Trading، واذهب إلى Personal Center وأنشئ مفتاحًا تحت Demo Trading API. في SetupBook اختر تجريبي في خانة البيئة والصق ذلك المفتاح مع عبارة مروره. تصل صفقاته إلى حساب تجريبي. المفتاح التجريبي يعمل مع تجريبي فقط.
استبدال مفتاح
افتح قائمة الاتصال، واختر تعديل واضغط استبدال المفتاح. الصق المفتاح والسر وعبارة المرور الجديدة واحفظ: يتحقق SetupBook منها وينسى القديمة ويستخدم الجديدة من المزامنة التالية. وتبقى الصفقات.
مشكلات
مشكلة في الاتصال؟ اكتب لنا من صفحة الاتصالات مع ما جرّبته. نردّ بالبريد خلال 30 دقيقة، كل يوم.
الأسئلة الشائعة
هل هو آمن؟ هل يستطيع SetupBook التداول أو السحب؟
لا. المفتاح بصلاحية Read فقط لا يستطيع وضع أمر ولا السحب، ولا يحوي SetupBook أي كود يحاول ذلك. يُخزَّن المفتاح وعبارة المرور مختومين على الخادم ولا يُرسلان إلى متصفحك أبدًا. وللتوقف احذف المفتاح في OKX فيتوقف الاتصال.
لماذا يحتاج SetupBook إلى عبارة المرور؟
توقّع OKX كل طلب بعبارة المرور إلى جانب المفتاح والسر. وبدونها ترفض OKX الطلب. وأنت من اخترت عبارة المرور حين أنشأت المفتاح.
هل أحتاج إلى تقييد عنوان IP؟
لا. اترك القائمة المسموح بها فارغة. لا نستطيع بعد أن نعطيك عنوانًا ثابتًا تسمح به؛ وإن أردت عنوانًا فاسألنا في نموذج الملاحظات. المفتاح للقراءة فقط لا يستطيع التداول ولا السحب، سواء وُجدت قاعدة IP أم لا.
أي أسواق OKX تُقرأ؟
عقود مبادلة USDT الدائمة والسوق الفوري. العقود المسعّرة بالعملة (inverse) ومدفوعات التمويل لا تُقرأ بعد.
هل يكلّف شيئًا؟
ربط المنصات جزء من Pro. وكل يومية تبدأ بـ 14 يومًا من Pro، ولا يُخصم شيء طوال هذه الأيام الـ 14. وإن ألغيت قبل أن تنتهي بقيت على الخطة المجانية التي تحتفظ بالإدخال اليدوي.
هل تفضّل ملفًا؟ الاستيراد ما زال يعمل: انظر دليل الاستخدام. ولربط منصة تداول أخرى اقرأ دليل KuCoin.