قبل أن يتمكّن البوت من التداول نيابةً عنك، تحتاج Freya إلى اتصال بالمنصة التي توجد فيها أموالك، سواء كانت Binance أو OKX أو Bybit. أنت لا تنقل أموالك ولا تشارك كلمة مرورك لفعل ذلك. بل تنشئ مفتاح API: وهو بيانات اعتماد مقيّدة تتيح لـ Freya تنفيذ الصفقات نيابةً عنك، بينما تبقى أموالك في حسابك الخاص على المنصة.
يشرح هذا الدليل بالضبط أي الصلاحيات يجب منحها (وأيها يجب ألا تُمنح أبداً)، وكيفية إضافة المفتاح إلى Freya، وما يجب فعله إذا لم يتم التحقق من الاتصال. إذا أردت الصورة الأشمل حول سبب أمان ذلك، فاقرأ أولاً هل أموالي آمنة على Freya Finance؟.
أهم النقاط
- تربط منصتك عبر مفتاح API، وهو بيانات اعتماد مقيّدة، وليس عبر نقل الأموال أو مشاركة كلمة مرور منصتك.
- يحتاج المفتاح إلى صلاحيات القراءة وتداول Spot و/أو Futures. ويجب ألا يمتلك صلاحية السحب أبداً.
- تتطلّب مفاتيح OKX عبارة مرور تحدّدها عند إنشائها؛ أما Binance وBybit فلا تتطلّبانها.
- أضف المفتاح في Freya من الإعدادات ← مفاتيح API ← إضافة مفتاح API، وتتحقّق منه Freya على الفور.
- إذا فشل التحقق، تخبرك Freya بالسبب بالضبط، سواء كان مفتاحاً غير صالح، أو IP غير مُدرَج في القائمة البيضاء، أو صلاحية ناقصة، ولكلٍّ منها حل بسيط.
طريقتان للربط
هناك مساران، وأيهما تراه يعتمد على المنصة التي تختارها.
الاتصال السريع (Bybit). بنقرة واحدة. توافق على Freya على موقع Bybit نفسه، فيُنشأ المفتاح ويُسلَّم مباشرةً إلى Freya، فلا ترى بيانات اعتماد ولا تنسخها ولا تلصقها، ولا تضيف أي شيء إلى القائمة البيضاء. يتوفّر هذا لأن Freya وسيط Bybit مسجَّل، ما يتيح لـ Bybit إصدار المفتاح مع الصلاحيات الصحيحة مرفقةً به مسبقاً.
الاتصال اليدوي (جميع المنصات). تنشئ مفتاح API بنفسك على المنصة، وتختار الصلاحيات، وتضيف عنوان IP الخاص بـ Freya إلى القائمة البيضاء، وتلصق المفتاح والمفتاح السري في Freya. خطوات أكثر، لكنه يعمل في كل مكان وتبقى أنت في تحكّم مباشر بكل إعداد.
إذا كنت على Bybit، فاستخدم الاتصال السريع. كل ما يرد أدناه عن الصلاحيات والتحقق يظلّ سارياً، فالاتصال السريع ببساطة ينفّذ تلك الخطوات نيابةً عنك.
📘 بخصوص Bybit تحديداً، يذهب دليلان مخصّصان أبعد من هذه الصفحة: ربط Bybit بـ Freya يغطّي المسارين وكيفية استبدال المفتاح، والاتصال السريع بـ Bybit يشرح بالضبط ما تمنحه الموافقة بنقرة واحدة.
نظرة سريعة على الخطوات اليدوية
- أنشئ مفتاح API على منصتك مع صلاحيات القراءة والتداول، دون السحب.
- انسخ بيانات الاعتماد، أي مفتاح API والمفتاح السري و(في حالة OKX) عبارة المرور.
- أضف المفتاح إلى Freya من الإعدادات ← مفاتيح API ← إضافة مفتاح API، واختر منصتك.
- دع Freya تتحقق منه، إذ تفحص Freya الاتصال والصلاحيات فوراً.
- عالج أي خطأ تُبلغ عنه، فتخبرك Freya بالضبط بما هو خاطئ إذا فشل التحقق.
الاتصال السريع خطوةً بخطوة
على Bybit، افتح الإعدادات ← مفاتيح API ← إضافة مفتاح API، واترك تبويب الاتصال السريع محدَّداً، واختر الاتصال بـ Bybit. عندها تُفتح نافذة Bybit.
- سجّل الدخول إلى Bybit، أو أنشئ حساباً هناك مباشرةً إن لم يكن لديك واحد بعد.
- راجع ما توافق عليه. تعرض لك Bybit بالضبط ما تطلبه Freya.
- وافِق. تُغلق النافذة تلقائياً وتظهر مفاتيحك في Freya.
توافق واحدة تُعدّ كلاً من Spot وFutures، فلا تكرّر العملية لكل سوق.
ثلاثة أمور يجدر معرفتها:
- الرفض آمن. إذا غيّرت رأيك على شاشة Bybit، فلن يُنشأ أي شيء ولن يتغيّر أي شيء في Freya.
- إعادة الاتصال لا تكدّس المفاتيح. تصدر Bybit مفتاحاً واحداً لكل منصة لكل حساب، لذا فإن الاتصال مجدداً يحدّث ما لديك بالفعل بدلاً من إضافة نسخ مكرّرة.
- لا حاجة لإدراج IP في القائمة البيضاء. تربط Bybit المفتاح بخوادم Freya بنفسها. وهذا أيضاً سبب عدم انتهاء صلاحية المفتاح كما قد يحدث لمفتاح تنشئه بنفسك.
ما هو مفتاح API، وأي الصلاحيات تحتاجها Freya
مفتاح API هو زوج من بيانات الاعتماد (مفتاح ومفتاح سري) يتيح لتطبيق واحد التواصل مع حسابك على المنصة بطريقة محدودة. أنت من يقرّر ما يُسمح به لذلك المفتاح. بالنسبة إلى Freya، فعّل فقط:
- القراءة، حتى تتمكّن Freya من رؤية أرصدتك ومراكزك وحالة أوامرك.
- تداول Spot و/أو تداول Futures، حتى يتمكّن بوتك من تنفيذ الأوامر التي يحتاجها. فعّل ما يطابق البوتات التي تنوي تشغيلها.
تنفّذ Freya الصفقات؛ ولا تحتاج أبداً إلى نقل الأموال خارج حسابك. اترك دائماً صلاحية السحب معطّلة على المفتاح الذي تربطه. هذه صلاحية تتحكّم بها أنت على المنصة، وبإطفائها لا تستطيع Freya ولا أي شخص قد يحصل على المفتاح سحب أموالك. إنها أهم عادة عند ربط أي منصة بوتات.
الخطوة 1: أنشئ مفتاح API على منصتك
في قسم إدارة API بمنصتك، أنشئ مفتاح API جديداً:
- Binance، أنشئ المفتاح ضمن API Management، وفعّل القراءة وتداول Spot و/أو Futures، واترك السحب مُطفأً.
- OKX، أنشئ المفتاح وحدّد عبارة مرور (ستحتاجها في Freya)؛ وفعّل القراءة والتداول دون السحب.
- Bybit، أنشئ المفتاح مع صلاحيات القراءة والتداول للمنتجات التي ستستخدمها، واترك السحب مُطفأً.
إذا كانت منصتك تتيح إدراج IP في القائمة البيضاء، فمن الممارسات الجيدة تقييد المفتاح على عناوين IP الخاصة بـ Freya. وإن فعلت ذلك، فتأكّد من إضافة عناوين IP الخاصة بـ Freya إلى القائمة البيضاء، وإلا فسيُرفض الاتصال (راجع جدول الأخطاء أدناه).
عند إنشاء المفتاح، تعرض المنصة المفتاح السري مرة واحدة فقط. انسخه فوراً واحتفظ به في مكان آمن. إذا فقدته، فلا يمكنك استعادته، وستحتاج إلى حذف المفتاح وإنشاء واحد جديد.
الخطوة 2: أضف المفتاح إلى Freya
في Freya، انتقل إلى الإعدادات ← مفاتيح API واختر إضافة مفتاح API. ثم:
- اختر منصتك (Binance أو OKX أو Bybit).
- الصق مفتاح API والمفتاح السري. بالنسبة إلى OKX، أدخل أيضاً عبارة المرور التي حدّدتها.
- امنح المفتاح اسماً حتى تتمكّن من التعرّف عليه لاحقاً.
يمكنك ربط أكثر من منصة، وإدارة مفاتيحك أو حذفها من هذه الصفحة نفسها في أي وقت.
الخطوة 3: تتحقق Freya من مفتاحك
فور إضافتك للمفتاح، تفحص Freya الاتصال والصلاحيات، دون أي تخمين. إذا كان كل شيء صحيحاً، فسيتم التحقق من المفتاح ويصبح جاهزاً للاستخدام. وإذا كان هناك خطأ ما، تعرض Freya رسالة واضحة تشرح بالضبط ما يجب إصلاحه.
فهم أخطاء التحقق
إذا فشل التحقق، طابِق الرسالة التي تعرضها Freya مع الحل أدناه:
| ما تعرضه Freya | ماذا يعني | كيفية إصلاحه |
|---|---|---|
| مفتاح API غير صالح | نُسخ المفتاح بشكل غير صحيح أو حُذف على المنصة | أعد نسخ مفتاح API بدقة، أو أنشئ واحداً جديداً |
| المفتاح السري غير صالح | المفتاح السري لا يطابق المفتاح | أعد نسخ المفتاح السري؛ وإن فقدته، فأنشئ مفتاحاً جديداً |
| عنوان IP غير مُدرَج في القائمة البيضاء | المفتاح مقيّد بعناوين IP وعنوان Freya غير مسموح به | أضف عناوين IP الخاصة بـ Freya إلى القائمة البيضاء للمفتاح، أو أزل قيد IP |
| صلاحيات ناقصة | يفتقر المفتاح إلى صلاحية القراءة أو التداول | فعّل القراءة وتداول Spot/Futures على المفتاح |
| صلاحية القراءة معطّلة | لا تستطيع Freya قراءة حسابك | فعّل صلاحية القراءة/العرض على المفتاح |
| صلاحية Spot/Futures معطّلة | لا يستطيع المفتاح تنفيذ الأوامر التي يحتاجها بوتك | فعّل نوع التداول (Spot أو Futures) الذي يطابق بوتك |
| فشل الاتصال | مشكلة شبكة أو منصة مؤقتة | انتظر لحظة وحاول إضافة المفتاح مرة أخرى |
ستنبّهك Freya أيضاً إلى مفتاح في وضع «غير مقيَّد»، أي مفتاح بلا قيد IP. حفاظاً على أمانك، تطلب منك Freya تفعيل قيد IP وإضافة العنوان الذي تعرضه قبل أن يُحفظ المفتاح. فعّل القراءة والتداول فقط (وليس السحب أبداً)، وقيّد المفتاح على IP الخاص بـ Freya. (مزيد عن أخطاء الاتصال في تعذّر ربط منصتك؟.)
كيف تُحمى مفاتيحك
مهما كانت طريقة ربطك، تُعامَل بيانات الاعتماد بالطريقة نفسها بمجرد وصولها إلى Freya.
- مشفّرة قبل تخزينها. يُشفَّر مفتاحك والمفتاح السري لحظة وصولهما. ولا يُكتبان أبداً بصيغة قابلة للقراءة.
- لا تُعرض عليك مرة أخرى. بمجرد الحفظ، لا يمكن لأي شاشة في Freya عرض مفتاحك السري مجدداً، لا لك ولا للدعم. إذا فقدته، فأنت تستبدل المفتاح بدلاً من استعادته.
- السحب ليس جزءاً منها أبداً. لا تطلب Freya صلاحية السحب ولا يمكنها استخدامها. أموالك لا تتحرّك إلا بيدك أنت، من حسابك الخاص على المنصة.
- الحذف فوري. احذف مفتاحاً في Freya فتذهب معه بيانات الاعتماد المخزّنة. وإلغاؤه على المنصة يوقف الوصول من تلك الجهة أيضاً، فأيّ إجراء منهما كافٍ.
مع الاتصال السريع تبدأ الحماية بخطوة أبكر: تُنشئ Bybit بيانات الاعتماد وتسلّمها مباشرةً إلى خوادم Freya. فهي لا تمرّ أبداً عبر متصفحك أو حافظتك أو لقطة شاشة، ما يزيل أشيع طريقة تتسرّب بها المفاتيح أصلاً.
بعض العادات تحافظ على أمان الاتصال من جانبك أنت أيضاً:
- السحب مُطفأ دائماً، فـ Freya لا تحتاجه أبداً.
- استخدم القائمة البيضاء لعناوين IP عند إنشاء مفتاح يدوياً. (يفعل الاتصال السريع ذلك نيابةً عنك.)
- مفتاح واحد لغرض واحد، واحذف المفاتيح التي لم تعد تستخدمها.
للصورة الكاملة عن كيفية حماية أموالك ومفاتيحك، راجع هل أموالي آمنة على Freya Finance؟ وأمان واجهة API للمنصات وتخفيف المخاطر.
الأسئلة الشائعة
ما هو الاتصال السريع، وهل هو آمن؟
يتيح لك الاتصال السريع الموافقة على Freya على موقع Bybit نفسه بدلاً من إنشاء مفتاح API يدوياً. وهو متاح لأن Freya وسيط Bybit مسجَّل. وهو آمن بقدر المسار اليدوي على الأقل، بل يمكن القول إنه أكثر أماناً: تُولَّد بيانات الاعتماد بواسطة Bybit وتُسلَّم مباشرةً إلى خوادم Freya، فلا تمرّ أبداً عبر متصفحك أو حافظتك. توافق عليها على شاشة Bybit، ويمكنك الرفض هناك دون إنشاء أي شيء.
هل ما زلت بحاجة إلى إدراج IP في القائمة البيضاء مع الاتصال السريع؟
لا. تربط Bybit المفتاح بخوادم Freya عند إصداره. وهذا أيضاً سبب عدم انتهاء صلاحية مفتاح أُنشئ بهذه الطريقة كما قد يحدث لمفتاح تنشئه بنفسك.
هل يمكنني استخدام الاتصال السريع لكلٍّ من Spot وFutures؟
نعم، توافق واحدة تُعدّ الاثنين معاً. لا تكرّر العملية لكل سوق.
ماذا يحدث إذا اتصلت بـ Bybit مرة ثانية؟
لا شيء يتعطّل ولا شيء يُكرَّر. تصدر Bybit مفتاحاً واحداً لكل منصة لكل حساب، فالاتصال الثاني يحدّث ما لديك بالفعل. هذا خاص بحساب Bybit نفسه. لربط حساب Bybit مختلف، احذف أولًا مفتاحي Bybit Spot وBybit Futures الحاليين، ثم اتصل مرة أخرى.
أي الصلاحيات تحتاجها Freya على مفتاح API الخاص بي؟
القراءة (لرؤية أرصدتك ومراكزك وأوامرك) وتداول Spot و/أو Futures (لتنفيذ أوامر بوتك). فعّل نوع التداول الذي يطابق البوتات التي ستشغّلها. لا تحتاج Freya أبداً إلى صلاحية السحب، فاترك تلك معطّلة دائماً.
هل تحتاج Freya إلى صلاحية سحب أموالي؟
لا. تنفّذ Freya الصفقات وتديرها فقط؛ ولا يمكنها ولا ينبغي أن تستطيع نقل الأموال خارج منصتك. اترك دائماً صلاحية السحب مُطفأة على المفتاح الذي تربطه، فهي صلاحية تتحكّم بها أنت على المنصة.
لماذا تقول Freya «عنوان IP غير مُدرَج في القائمة البيضاء»؟
مفتاح API الخاص بك مقيّد بعناوين IP محدّدة، وعنوان Freya ليس على القائمة. إما أن تضيف عناوين IP الخاصة بـ Freya إلى القائمة البيضاء للمفتاح على منصتك، أو أن تزيل قيد IP من المفتاح. وبعد تحديثه، أضف المفتاح في Freya مجدداً.
لماذا تقول «مفتاح API غير صالح» أو «المفتاح السري غير صالح»؟
عادةً ما يكون المفتاح أو المفتاح السري قد نُسخ بشكل غير صحيح، أو أن المفتاح حُذف أو أُعيد إنشاؤه على المنصة. أعد نسخ القيمتين بدقة. ولأن المفتاح السري يُعرض مرة واحدة فقط عند إنشاء المفتاح، فإن لم يعد لديك، فاحذف المفتاح على المنصة وأنشئ واحداً جديداً.
ما هي عبارة المرور، ولماذا تطلبها OKX؟
تتضمّن مفاتيح API الخاصة بـ OKX عبارة مرور تحدّدها بنفسك عند إنشاء المفتاح، وهي بيانات اعتماد إضافية إلى جانب المفتاح والمفتاح السري. أدخل عبارة المرور نفسها في Freya عند إضافة مفتاح OKX. أما Binance وBybit فلا تستخدمان عبارة مرور.
هل يمكنني ربط أكثر من منصة؟
نعم. يمكنك إضافة مفاتيح API لـ Binance وOKX وBybit، وإدارتها أو حذفها في أي وقت من الإعدادات ← مفاتيح API.
هل من الآمن أن أعطي Freya مفتاح API الخاص بي؟
نعم، عندما يكون المفتاح مضبوطاً بشكل صحيح، أي القراءة والتداول فقط، دون سحب، ومدرَجاً في القائمة البيضاء لعناوين IP حيثما أمكن. تبقى أموالك على منصتك الخاصة، والمفتاح الذي تشاركه لا يمكنه نقلها. للشرح الكامل، راجع مقال هل أموالي آمنة على Freya Finance؟.
أي المنصات تدعمها Freya؟
تتصل Freya حالياً بـ Binance وOKX وBybit (Spot وFutures). وقد تُضاف منصات أخرى بمرور الوقت. أنت تتداول على أي منها تربطها، فأموالك والأسواق المتاحة تبقى على تلك المنصة.
أي العملات أو أزواج التداول يمكنني تداولها؟
تأتي الأزواج المتاحة من قوائم منصتك المتصلة نفسها، وليس من قائمة منفصلة لدى Freya، فإذا أدرجت منصتك زوجاً (مثل BTC/USDT أو ETH/USDT)، فيمكنك بناء بوت عليه. ومعظم التداول يجري مقابل USDT كعملة تسعير. وإذا أزالت منصة زوجاً من قوائمها، فيتوقّف تداوله هناك.