להתחיל עם נתונים ציבוריים לבדיקה
חיברתם את ה-DB שלכם אבל אין לכם מה להכניס אליו? התחילו עם אחת משלוש הדוגמאות שלהלן. כולן חינמיות וללא מפתח API, ואפשר פשוט לעקוב אחרי סקריפט הטעינה ועד הערכים לבחירה במסך (טבלה · עמודות). הסקריפט בנוי כך שמוסיפים לו מפענחים, כך שאם יש מקור שאתם רוצים, מספיק לכתוב עוד פריט אחד.
הורדת האוספים
שכפלו את מאגר ה-fetchers ל-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 · קוד פתוח · תיקייה אחת = fetcher אחד · רישום cron אוטומטי
שלוש הדוגמאות שלהלן הן **דוגמאות להתחלה**. במאגר יש עוד — VIX, תנודתיות משתמעת של קריפטו (DVOL), פער ריביות ארוכות-קצרות, מדד הדולר, שווי שוק של מטבעות יציבים, DeFi TVL ועוד, כולם חינמיים וללא מפתח — הרשימה המלאה מוצגת עם `node run.mjs list`. לנתוני שוק אין ערך בימי חג בארה"ב (לא 0, אלא חסר), ו-DVOL זמין ממרץ 2021.
איך לקרוא את מסך הגדרות הנתונים
ניהול סוכנים → בחירת סוכן → לשונית הגדרות נתונים. רישום ומחיקה נעשים רק על ידיכם, במסך זה — ה-AI רק קורא את מערכי הנתונים, ומחרוזת החיבור לעולם אינה מודבקת בצ'אט. המסך מסודר מלמעלה למטה בסדר הבא.
- חיבור DB חיצוני — הזינו שם חיבור (למשל main) ומחרוזת חיבור. היא נשמרת מוצפנת רק במכשיר הסוכן ואינה נשלחת לשרת. כשהמסך נפתח, הסוכן קורא את רשימת הטבלאות אוטומטית ([בדיקת חיבור] — כשרוצים לקרוא אותה מחדש).
- טבלאות ומערכי נתונים — שורה אחת לכל טבלה ב-DB: שם הטבלה · מספר שורות משוער · הערת הטבלה, ומתחתיה מערכי הנתונים הקוראים את הטבלה.
- רמת החשיפה ל-AI (בצד ימין של שורת הטבלה) — פרטי (ברירת מחדל — ה-AI אפילו לא יודע שהטבלה קיימת) · שם בלבד · כולל עמודות · כולל דגימה · שאילתה מותרת. לאחר הבחירה — [שמירת הגדרות חשיפה]. ברמות עמודות · דגימה · שאילתה נשלחים ל-AI נתונים אמיתיים, לכן אל תפתחו טבלאות המכילות מידע אישי. ניתן לפתוח רק טבלאות בסכמה public.
- שמות מערכי נתונים (מתחת לשורת הטבלה) — הערך שהאסטרטגיה קוראת עם ctx.data(שם). [+ הוספת מערך נתונים מטבלה זו] → לאחר בחירת שם · עמודת זמן · עמודת ערך, התיאור ימולא מהערת הטבלה, ו-[שמירה] נפתח רק לאחר שעוברים את [בדיקה]. אפשר לתת לטבלה אחת כמה שמות (כשמפצלים בעזרת מסנן לסדרות לפי בורסה או נכס, או כשאסטרטגיה ישנה משתמשת בשם אחר). תג מצב: זמין · טרם נבדק · לא מחובר. לחיצה על תג הזמן-אמת שליד התג פותחת את הגדרות ההערה (poll · notify · redis) — לרוב ברירת המחדל מספיקה.
- מערכי נתונים מחושבים (SQL) — ערכים הדורשים חישוב, כמו ממוצע נע, ערך מושהה או שילוב של כמה טבלאות. מכיוון ש-SQL יכול לקרוא כמה טבלאות, הם מרוכזים בנפרד ולא מתחת לטבלה מסוימת. את רוב החישובים אפשר לעשות גם בקוד האסטרטגיה עם שתי קריאות ctx.data, לכן השתמשו ב-SQL רק כשהחישוב דורש את כל ההיסטוריה (ממוצע נע · דירוג). SQL שנרשם בשיטה הקודמת מופיע כאן: [בדקתי את ה-SQL] · [מחיקה], או שאם הצורה פשוטה, ניתן להמיר אותו בבת אחת לשיטת בחירת הטבלה.
- מערכי נתונים שהטבלה שלהם לא נמצאה — כשטבלה שהוגדרה אינה ברשימה כעת, מערך הנתונים אינו נעלם אלא נשאר כאן עם הסיבה — רשימת הטבלאות עדיין לא התקבלה (אין פירוש הדבר שהיא חסרה) · אין טבלה כזו ב-DB (שונה שמה או נמחקה) · אין במכשיר זה שם חיבור כזה.
- יש שני היקפים — רמת החשיפה ל-AI נשמרת רק במכשיר שפתוח כעת. מערכי הנתונים חלים על כל המכשירים עם אותו שם חיבור. אם יש כמה מכשירים, בוחרים את רמת החשיפה בכל מכשיר בנפרד.
1. מדד הפחד והחמדנות
alternative.me0 (פחד קיצוני) עד 100 (חמדנות קיצונית), פעם ביום. כל ההיסטוריה מאז 2018-02. זהו ציר של סנטימנט שהמחיר לבדו אינו מראה, ולכן הוא הבדיקה הראשונה הטובה ביותר.
node run.mjs fear-greed
חיבור: main · טבלה: fear_greed שם: fg · עמודת זמן: ts · עמודת ערך: v
2. קצב הגיבוב (hash rate) של ביטקוין
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)
רושם ב-crontab את המחזור שהוגדר לכל fetcher. הרצה חוזרת אינה מוסיפה שורות כפולות, וה-cron שהוספתם בעצמכם אינו נפגע. היומנים נשמרים בקובץ יומן נפרד לכל fetcher בתיקייה logs.
node run.mjs --install-cron
- מומלץ שעמודת הזמן תהיה epoch בשניות (גם מילישניות ו-ISO מזוהים אוטומטית, ואופן הקריאה נרשם בשדה tsUnit של דוח האימות).
- בטוח להריץ את הסקריפט שוב — רק הערכים החדשים מתעדכנים, ללא כפילויות (upsert). לנתונים חדשים, פשוט הריצו אותו שוב מדי פעם.
- בתוצאות הבקטסט נשמרת טביעת אצבע של הנתונים (מספר שורות · hash) — אם תוכן ה-DB משתנה, טביעת האצבע משתנה, ושתי תוצאות עם טביעות אצבע שונות אינן באותם תנאים.
- גם בקטסטים המשתמשים בנתונים חיצוניים רצים על הסוכן — כל הבקטסטים רצים רק על הסוכן (המאגר שלי).
- טבלאות שקיבלו רמת חשיפה נחשפות ל-AI (ברמות עמודות · דגימה · שאילתה נשלחים נתונים אמיתיים) — אל תחשפו טבלאות המכילות מידע אישי.
כל התיעוד נמצא כאן — מדריך