البدء ببيانات عامة مجانية
ربطت قاعدة بياناتك ولا توجد بيانات تضعها فيها؟ ابدأ بواحد من الأمثلة الثلاثة أدناه. كلها مجانية وبلا مفتاح API، ويكفي اتباع سكربت التحميل والقيم التي تُختار على الشاشة (الجدول · الأعمدة) كما هي. السكربت مبني على إضافة المحلّلات، فإن كان لديك مصدر تريده فيكفي إضافة بند واحد.
الحصول على الجامعات
استنسخ مستودع الجامعات على 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) يقرأ مجموعات البيانات فقط، ولا تُلصق سلاسل الاتصال في المحادثة أبدًا. تتكون الشاشة من الأعلى إلى الأسفل من الأجزاء التالية.
- قاعدة بيانات خارجية — أدخل اسم الاتصال (مثل main) وسلسلة الاتصال. تُحفظ مشفّرة على جهاز الوكيل فقط ولا تُرسل إلى الخادم. عند فتح الشاشة يقرأ الوكيل قائمة الجداول تلقائيًا (زر [التحقق من الاتصال] لإعادة القراءة).
- الجداول ومجموعات البيانات — سطر لكل جدول في قاعدة البيانات: اسم الجدول · عدد الصفوف التقريبي · تعليق الجدول، وتحته مجموعات البيانات التي تقرأ ذلك الجدول.
- مستوى إتاحة AI (يمين سطر الجدول) — خاص (الافتراضي — لا يعرف AI حتى بوجود الجدول) · الاسم فقط · مع الأعمدة · مع العيّنات · السماح بالاستعلام. اختر ثم [حفظ الإتاحة]. في مستويات الأعمدة والعيّنات والاستعلام تُرسل بيانات حقيقية إلى AI، لذا لا تفتح الجداول التي تحتوي على بيانات شخصية. يمكن فتح جداول المخطط public فقط.
- أسماء مجموعات البيانات (تحت سطر الجدول) — هي القيم التي تستدعيها الاستراتيجية عبر ctx.data(الاسم). [+ إضافة مجموعة بيانات من هذا الجدول] → اختر الاسم وعمود الوقت وعمود القيمة؛ يُملأ الوصف من تعليق الجدول، ولا يتاح [حفظ] إلا بعد نجاح [اختبار]. يمكن إعطاء جدول واحد عدة أسماء (عند فصل السلاسل حسب منصة التداول أو الرمز بمرشّح، أو عندما تستخدم استراتيجية قديمة اسمًا آخر). شارات الحالة: متاح · لم يُتحقق منه · غير متصل. انقر شارة الوقت الحقيقي المجاورة لفتح إعدادات الإيقاظ (poll · notify · redis) — القيم الافتراضية تكفي في معظم الحالات.
- مجموعات بيانات محسوبة (SQL) — قيم تحتاج إلى حساب: المتوسطات المتحركة، والقيم المتأخرة، والجمع بين عدة جداول. لأن SQL يمكنه قراءة عدة جداول، تُجمع هذه المجموعات منفصلة وليس تحت جدول معيّن. يمكن إجراء معظم الحسابات في كود الاستراتيجية باستدعاءين لـ ctx.data، فاستخدم SQL فقط عندما يحتاج الحساب إلى السجل التاريخي كاملًا (المتوسطات المتحركة، الترتيب). هنا أيضًا تجد SQL المسجّل بالطريقة السابقة: [تمت مراجعة SQL] · [حذف]، أو حوّل البسيط منها دفعة واحدة إلى اختيار الجدول.
- مجموعات بيانات لم يُعثر على جدولها — إذا لم يكن الجدول المُعلن موجودًا في القائمة الحالية، لا تختفي مجموعة البيانات بل تبقى هنا مع السبب: لم تُستلم قائمة الجداول بعد (لا يعني أنه غير موجود) · لا يوجد هذا الجدول في قاعدة البيانات (أُعيدت تسميته أو حُذف) · لا يوجد اسم الاتصال هذا على هذا الجهاز.
- هناك نطاقان — يُحفظ مستوى إتاحة AI على الجهاز المفتوح حاليًا فقط. أما مجموعات البيانات فتُطبّق على كل الأجهزة التي تحمل اسم الاتصال نفسه. إذا كانت لديك عدة أجهزة، فاختر مستوى الإتاحة على كل جهاز على حدة.
1. مؤشر الخوف والطمع
alternative.meمن 0 (خوف شديد) إلى 100 (طمع شديد)، مرة يوميًا. كامل التاريخ منذ فبراير 2018. محور للمعنويات لا يظهر من السعر وحده، لذا فهو الأفضل لأول اختبار.
node run.mjs fear-greed
الاتصال: main · الجدول: fear_greed الاسم: fg · عمود الوقت: ts · عمود القيمة: v
2. معدل تجزئة البيتكوين
blockchain.comمؤشر خاص بالسلسلة نفسها (TH/s). محور مختلف عن السعر، لذا يصلح مرشّحًا للنظام. القيم كبيرة والاتجاه بطيء، فالأفضل استخدام نسبتها إلى المتوسط المتحرك بدل القيمة الخام.
node run.mjs btc-hashrate
الاتصال: main · الجدول: btc_hashrate الاسم: hashrate · عمود الوقت: ts · عمود القيمة: v
3. سعر الفائدة الأمريكي (للتدريب)
FRED (DFF)سعر الفائدة الفعلي اليومي على الأموال الفيدرالية. القيمة النموذجية لمرشّح النظام الكلي. ★ تنبيه: القيمة نفسها تصل أصلًا كمؤشر أساسي base_fedfunds (ctx.data('base_fedfunds') — يجمعه الوكيل من FRED). إدخال القيمة نفسها عبر مسارين يجعل النتيجة غامضة بشأن أيهما استُخدم، لذا استخدم هذا للتدرّب على الربط فقط.
node run.mjs fed-funds
الاتصال: main · الجدول: macro_fed_funds الاسم: dff · عمود الوقت: ts · عمود القيمة: v
الجمع الدوري (cron)
يسجّل كل جالب بيانات (fetcher) في crontab بالدورية المعلنة له. إعادة التشغيل لا تكدّس الأسطر، ولا تمسّ مدخلات cron التي أضفتها بنفسك. تُكتب السجلات في ملف منفصل لكل جالب داخل مجلد logs.
node run.mjs --install-cron
- يُوصى باستخدام epoch بالثواني لعمود الوقت (يُتعرّف على الميلي ثانية وISO تلقائيًا أيضًا، وتبقى طريقة القراءة مسجلة في حقل tsUnit في تقرير التحقق).
- إعادة تشغيل السكربت آمنة — تُحدَّث القيم الأحدث فقط دون تكرار (upsert). للحصول على بيانات جديدة أعد تشغيله دوريًا.
- تحمل نتائج الاختبار الرجعي بصمة للبيانات (عدد الصفوف · hash) — إذا تغيّر محتوى قاعدة البيانات تتغير البصمة، والنتيجتان ذواتا البصمة المختلفة ليستا بالشروط نفسها.
- الاختبارات الرجعية التي تستخدم بيانات خارجية تعمل أيضًا على الوكيل — كل الاختبارات الرجعية تعمل على الوكيل فقط (مخزني).
- الجداول التي يُمنح لها مستوى إتاحة تصبح مرئية للذكاء الاصطناعي (مستويات الأعمدة والعينة والاستعلام ترسل بيانات حقيقية) — لا تُتح جداول تحتوي على معلومات شخصية.
كل الوثائق هنا — دليل الاستخدام