← العودة إلى دليل الاستخدام
أمثلة على البيانات الخارجية

البدء ببيانات عامة مجانية

ربطت قاعدة بياناتك ولا توجد بيانات تضعها فيها؟ ابدأ بواحد من الأمثلة الثلاثة أدناه. كلها مجانية وبلا مفتاح API، ويكفي اتباع سكربت التحميل والقيم التي تُختار على الشاشة (الجدول · الأعمدة) كما هي. السكربت مبني على إضافة المحلّلات، فإن كان لديك مصدر تريده فيكفي إضافة بند واحد.

قبل البدء — يجب أولًا ربط قاعدة البيانات وإنشاء حساب للقراءة فقط — دليل ربط Supabase

الحصول على الجامعات

استنسخ مستودع الجامعات على VPS (الخادم الذي يعمل عليه الوكيل). الاعتمادية الوحيدة هي pg. ★ يجب أن يشير DATABASE_URL في ‎.env إلى حساب بصلاحية الكتابة. من الطبيعي أن يرفض الحساب المخصص للقراءة فقط عملية INSERT، فهذا الحساب مخصص لتكامل SoriTrading فقط.

git clone https://github.com/Value-Connect-Global-Inc/soritrading-fetchers ~/soritrading-fetchers
cd ~/soritrading-fetchers && npm install
cp .env.example .env    # DATABASE_URL

https://github.com/Value-Connect-Global-Inc/soritrading-fetchers · مفتوح المصدر · مجلد واحد = جامع واحد · تسجيل cron تلقائيًا

الأمثلة الثلاثة أدناه **للبدء فقط**. يحتوي المستودع أيضًا على VIX، والتقلب الضمني للعملات المشفرة (DVOL)، وفارق العائد بين الآجال الطويلة والقصيرة، ومؤشر الدولار، والقيمة السوقية للعملات المستقرة، وDeFi TVL وغيرها — كلها مجانية وبلا مفتاح. للقائمة الكاملة شغّل `node run.mjs list`. بيانات السوق ليس لها قيم في العطلات الأمريكية (غير موجودة، وليست 0)، وDVOL يبدأ من مارس 2021.

كيفية قراءة شاشة إعدادات البيانات

إدارة الوكلاء → اختيار وكيل → تبويب إعدادات البيانات. الإضافة والحذف تتمان في هذه الشاشة من قِبلك وحدك — الذكاء الاصطناعي (AI) يقرأ مجموعات البيانات فقط، ولا تُلصق سلاسل الاتصال في المحادثة أبدًا. تتكون الشاشة من الأعلى إلى الأسفل من الأجزاء التالية.

  1. قاعدة بيانات خارجية — أدخل اسم الاتصال (مثل main) وسلسلة الاتصال. تُحفظ مشفّرة على جهاز الوكيل فقط ولا تُرسل إلى الخادم. عند فتح الشاشة يقرأ الوكيل قائمة الجداول تلقائيًا (زر [التحقق من الاتصال] لإعادة القراءة).
  2. الجداول ومجموعات البيانات — سطر لكل جدول في قاعدة البيانات: اسم الجدول · عدد الصفوف التقريبي · تعليق الجدول، وتحته مجموعات البيانات التي تقرأ ذلك الجدول.
  3. مستوى إتاحة AI (يمين سطر الجدول) — خاص (الافتراضي — لا يعرف AI حتى بوجود الجدول) · الاسم فقط · مع الأعمدة · مع العيّنات · السماح بالاستعلام. اختر ثم [حفظ الإتاحة]. في مستويات الأعمدة والعيّنات والاستعلام تُرسل بيانات حقيقية إلى AI، لذا لا تفتح الجداول التي تحتوي على بيانات شخصية. يمكن فتح جداول المخطط public فقط.
  4. أسماء مجموعات البيانات (تحت سطر الجدول) — هي القيم التي تستدعيها الاستراتيجية عبر ctx.data(الاسم). [+ إضافة مجموعة بيانات من هذا الجدول] → اختر الاسم وعمود الوقت وعمود القيمة؛ يُملأ الوصف من تعليق الجدول، ولا يتاح [حفظ] إلا بعد نجاح [اختبار]. يمكن إعطاء جدول واحد عدة أسماء (عند فصل السلاسل حسب منصة التداول أو الرمز بمرشّح، أو عندما تستخدم استراتيجية قديمة اسمًا آخر). شارات الحالة: متاح · لم يُتحقق منه · غير متصل. انقر شارة الوقت الحقيقي المجاورة لفتح إعدادات الإيقاظ (poll · notify · redis) — القيم الافتراضية تكفي في معظم الحالات.
  5. مجموعات بيانات محسوبة (SQL) — قيم تحتاج إلى حساب: المتوسطات المتحركة، والقيم المتأخرة، والجمع بين عدة جداول. لأن SQL يمكنه قراءة عدة جداول، تُجمع هذه المجموعات منفصلة وليس تحت جدول معيّن. يمكن إجراء معظم الحسابات في كود الاستراتيجية باستدعاءين لـ ctx.data، فاستخدم SQL فقط عندما يحتاج الحساب إلى السجل التاريخي كاملًا (المتوسطات المتحركة، الترتيب). هنا أيضًا تجد SQL المسجّل بالطريقة السابقة: [تمت مراجعة SQL] · [حذف]، أو حوّل البسيط منها دفعة واحدة إلى اختيار الجدول.
  6. مجموعات بيانات لم يُعثر على جدولها — إذا لم يكن الجدول المُعلن موجودًا في القائمة الحالية، لا تختفي مجموعة البيانات بل تبقى هنا مع السبب: لم تُستلم قائمة الجداول بعد (لا يعني أنه غير موجود) · لا يوجد هذا الجدول في قاعدة البيانات (أُعيدت تسميته أو حُذف) · لا يوجد اسم الاتصال هذا على هذا الجهاز.
  7. هناك نطاقان — يُحفظ مستوى إتاحة AI على الجهاز المفتوح حاليًا فقط. أما مجموعات البيانات فتُطبّق على كل الأجهزة التي تحمل اسم الاتصال نفسه. إذا كانت لديك عدة أجهزة، فاختر مستوى الإتاحة على كل جهاز على حدة.

1. مؤشر الخوف والطمع

alternative.me

من 0 (خوف شديد) إلى 100 (طمع شديد)، مرة يوميًا. كامل التاريخ منذ فبراير 2018. محور للمعنويات لا يظهر من السعر وحده، لذا فهو الأفضل لأول اختبار.

node run.mjs fear-greed
القيم التي تُختار في شاشة إعدادات البيانات ([+ إضافة مجموعة بيانات من هذا الجدول] في سطر الجدول)
الاتصال: main   ·   الجدول: fear_greed
الاسم: fg   ·   عمود الوقت: ts   ·   عمود القيمة: v
بعد التسجيل، يكفي قول هذا للذكاء الاصطناعي
«باستخدام مجموعة بياناتي fg، أجرِ اختبارًا رجعيًا على binance BTC 1d لاستراتيجية تشتري عندما يكون مؤشر الخوف والطمع دون 20 وتبيع فوق 60»

2. معدل تجزئة البيتكوين

blockchain.com

مؤشر خاص بالسلسلة نفسها (TH/s). محور مختلف عن السعر، لذا يصلح مرشّحًا للنظام. القيم كبيرة والاتجاه بطيء، فالأفضل استخدام نسبتها إلى المتوسط المتحرك بدل القيمة الخام.

node run.mjs btc-hashrate
القيم التي تُختار في شاشة إعدادات البيانات ([+ إضافة مجموعة بيانات من هذا الجدول] في سطر الجدول)
الاتصال: main   ·   الجدول: btc_hashrate
الاسم: hashrate   ·   عمود الوقت: ts   ·   عمود القيمة: v
بعد التسجيل، يكفي قول هذا للذكاء الاصطناعي
«أضف إلى استراتيجيتي الحالية مرشّحًا لا يشتري إلا عندما تكون مجموعة البيانات hashrate فوق متوسطها لـ 90 يومًا»

3. سعر الفائدة الأمريكي (للتدريب)

FRED (DFF)

سعر الفائدة الفعلي اليومي على الأموال الفيدرالية. القيمة النموذجية لمرشّح النظام الكلي. ★ تنبيه: القيمة نفسها تصل أصلًا كمؤشر أساسي base_fedfunds (ctx.data('base_fedfunds') — يجمعه الوكيل من FRED). إدخال القيمة نفسها عبر مسارين يجعل النتيجة غامضة بشأن أيهما استُخدم، لذا استخدم هذا للتدرّب على الربط فقط.

node run.mjs fed-funds
القيم التي تُختار في شاشة إعدادات البيانات ([+ إضافة مجموعة بيانات من هذا الجدول] في سطر الجدول)
الاتصال: main   ·   الجدول: macro_fed_funds
الاسم: dff   ·   عمود الوقت: ts   ·   عمود القيمة: v
بعد التسجيل، يكفي قول هذا للذكاء الاصطناعي
«اعرض قائمة مجموعات بياناتي وتحقق مما إذا كانت dff قابلة للاستخدام (للتأكد من الربط فقط)»

الجمع الدوري (cron)

يسجّل كل جالب بيانات (fetcher) في crontab بالدورية المعلنة له. إعادة التشغيل لا تكدّس الأسطر، ولا تمسّ مدخلات cron التي أضفتها بنفسك. تُكتب السجلات في ملف منفصل لكل جالب داخل مجلد logs.

node run.mjs --install-cron
معلومات مهمة
  • يُوصى باستخدام epoch بالثواني لعمود الوقت (يُتعرّف على الميلي ثانية وISO تلقائيًا أيضًا، وتبقى طريقة القراءة مسجلة في حقل tsUnit في تقرير التحقق).
  • إعادة تشغيل السكربت آمنة — تُحدَّث القيم الأحدث فقط دون تكرار (upsert). للحصول على بيانات جديدة أعد تشغيله دوريًا.
  • تحمل نتائج الاختبار الرجعي بصمة للبيانات (عدد الصفوف · hash) — إذا تغيّر محتوى قاعدة البيانات تتغير البصمة، والنتيجتان ذواتا البصمة المختلفة ليستا بالشروط نفسها.
  • الاختبارات الرجعية التي تستخدم بيانات خارجية تعمل أيضًا على الوكيل — كل الاختبارات الرجعية تعمل على الوكيل فقط (مخزني).
  • الجداول التي يُمنح لها مستوى إتاحة تصبح مرئية للذكاء الاصطناعي (مستويات الأعمدة والعينة والاستعلام ترسل بيانات حقيقية) — لا تُتح جداول تحتوي على معلومات شخصية.
أدلة أخرى

كل الوثائق هنا — دليل الاستخدام