Ücretsiz açık verilerle başlayın
DB'nizi bağladınız ama koyacak veriniz yok mu? Aşağıdaki üç örnekten biriyle başlayın. Hepsi ücretsiz ve API anahtarı gerektirmez; yükleme betiğini ve ekranda seçilecek değerleri (tablo · sütun) olduğu gibi izlemeniz yeterli. Betik bir ayrıştırıcı haritası üzerine kuruludur — istediğiniz kaynak varsa tek bir girdi eklemeniz yeterli.
Toplayıcıları edinin
Toplayıcı deposunu VPS'e (ajanın çalıştığı sunucuya) klonlayın. Tek bağımlılık pg'dir. ★ .env içindeki DATABASE_URL yazma yetkili bir hesap olmalıdır. Salt okunur hesabın INSERT'i reddetmesi normaldir; o hesap yalnızca SoriTrading entegrasyonu içindir.
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 · Açık kaynak · bir klasör = bir toplayıcı · cron otomatik kaydedilir
Aşağıdaki üçü **başlangıç örnekleridir**. Depoda ayrıca VIX, kripto zımni oynaklığı (DVOL), getiri eğrisi farkı, dolar endeksi, stablecoin piyasa değeri, DeFi TVL ve daha fazlası var — hepsi ücretsiz, anahtar gerekmez. Tam liste için `node run.mjs list` çalıştırın. Piyasa verilerinin ABD tatil günlerinde değeri yoktur (0 değil, eksik) ve DVOL Mart 2021'den itibaren başlar.
Veri ayarları ekranı nasıl okunur
Ajan yönetimi → bir ajan seçin → Veri ayarları sekmesi. Veri setlerini bu ekranda yalnızca siz ekler ve silersiniz — AI veri setlerini yalnızca okur ve bağlantı dizeleri asla sohbete yapıştırılmaz. Ekran yukarıdan aşağıya şu bölümlerden oluşur.
- Harici veritabanı — Bir bağlantı adı (ör. main) ve bağlantı dizesini girin. Yalnızca ajan cihazında şifreli olarak saklanır ve sunucuya gitmez. Ekran açıldığında ajan tablo listesini otomatik okur ([Bağlantıyı kontrol et] yeniden okumak içindir).
- Tablolar ve veri setleri — Veritabanındaki her tablo için bir satır: tablo adı · yaklaşık satır sayısı · tablo açıklaması; altında da o tabloyu okuyan veri setleri listelenir.
- AI görünürlük düzeyi (tablo satırının sağı) — Gizli (varsayılan — AI tablonun varlığını bile bilmez) · yalnızca ad · sütunlar dahil · örnekler dahil · sorguya izin. Seçin, ardından [Görünürlüğü kaydet]. Sütun, örnek ve sorgu düzeylerinde gerçek veri AI'ya gider; kişisel veri içeren tabloları açmayın. Yalnızca public şemasındaki tablolar açılabilir.
- Veri seti adları (tablo satırının altında) — Stratejinin ctx.data(ad) ile çağırdığı değerlerdir. [+ Bu tablodan veri seti ekle] → ad, zaman sütunu ve değer sütununu seçin; açıklama tablo açıklamasıyla doldurulur ve [Kaydet] yalnızca [Test] geçince açılır. Bir tabloya birden çok ad verebilirsiniz (filtreyle borsa veya sembol bazında serileri ayırırken ya da eski bir strateji başka bir ad kullanıyorsa). Durum rozetleri: kullanılabilir · kontrol edilmedi · bağlı değil. Yanındaki gerçek zamanlı rozetine tıklayınca uyandırma ayarları (poll · notify · redis) açılır — çoğu durumda varsayılan yeterlidir.
- Hesaplanan veri setleri (SQL) — Hesaplama gerektiren değerler: hareketli ortalamalar, gecikmeli değerler, birden çok tablonun birleşimi. SQL birden çok tabloyu okuyabildiği için bunlar belirli bir tablonun altında değil, ayrı toplanır. Çoğu hesaplama strateji kodunda iki ctx.data çağrısıyla yapılabilir; SQL'i yalnızca tüm geçmiş gerektiğinde (hareketli ortalama, sıralama) kullanın. Eski yöntemle kaydedilmiş SQL'ler de buradadır: [SQL kontrol edildi] · [Sil] ya da basit olanları toplu olarak tablo seçimine dönüştürün.
- Tablosu bulunamayan veri setleri — Bildirilen tablo şu anda listede yoksa veri seti kaybolmaz — nedeniyle birlikte burada kalır: tablo listesi henüz alınmadı (tablonun olmadığı anlamına gelmez) · o veritabanında böyle bir tablo yok (yeniden adlandırıldı veya silindi) · bu cihazda o bağlantı adı yok.
- İki kapsam vardır — AI görünürlük düzeyi yalnızca şu anda açık olan cihazda saklanır. Veri setleri aynı bağlantı adına sahip tüm cihazlara uygulanır. Birden çok cihaz varsa görünürlük düzeyini her cihazda ayrı seçin.
1. Korku ve Açgözlülük Endeksi
alternative.me0 (aşırı korku) ile 100 (aşırı açgözlülük) arası, günde bir kez. Şubat 2018'den itibaren tüm geçmiş. Yalnızca fiyatla görülemeyen bir duygu ekseni olduğu için ilk test için en iyisidir.
node run.mjs fear-greed
Bağlantı: main · Tablo: fear_greed Ad: fg · Zaman sütunu: ts · Değer sütunu: v
2. Bitcoin hash oranı
blockchain.comZincirin kendi göstergesi (TH/s). Fiyattan farklı bir eksen olduğu için rejim filtresi olarak kullanışlıdır. Değerler büyük ve eğilim yavaş olduğundan ham değer yerine hareketli ortalamaya oranını kullanmak daha iyidir.
node run.mjs btc-hashrate
Bağlantı: main · Tablo: btc_hashrate Ad: hashrate · Zaman sütunu: ts · Değer sütunu: v
3. ABD politika faizi (alıştırma)
FRED (DFF)Günlük efektif federal fon oranı. Makro rejim filtresinin tipik değeridir. ★ Dikkat: Aynı değer zaten temel gösterge base_fedfunds olarak geliyor (ctx.data('base_fedfunds') — ajanınız FRED'den topluyor). Aynı değeri iki yoldan beslerseniz sonuçta hangisinin kullanıldığı ayırt edilemez; bunu yalnızca bağlantı alıştırması için kullanın.
node run.mjs fed-funds
Bağlantı: main · Tablo: macro_fed_funds Ad: dff · Zaman sütunu: ts · Değer sütunu: v
Periyodik toplama (cron)
Her fetcher'ı bildirilen periyoduyla crontab'a kaydeder. Yeniden çalıştırmak satırları çoğaltmaz ve kendi eklediğiniz cron girdilerine dokunmaz. Loglar logs klasöründe fetcher başına ayrı dosyaya yazılır.
node run.mjs --install-cron
- Zaman sütunu için saniye cinsinden epoch önerilir (milisaniye ve ISO da otomatik tanınır; hangisi olarak okunduğu doğrulama raporundaki tsUnit alanında kalır).
- Betiği yeniden çalıştırmak güvenlidir — yinelenme olmadan yalnızca daha yeni değerler güncellenir (upsert). Yeni veri için periyodik olarak yeniden çalıştırın.
- Backtest sonuçlarında veri parmak izi (satır sayısı · hash) kalır — DB içeriği değişirse parmak izi de değişir ve parmak izi farklı iki sonuç aynı koşullarda değildir.
- Harici veri kullanan backtest'ler de ajanda çalışır — tüm backtest'ler yalnızca ajanda (kendi depomda) çalışır.
- Erişim düzeyi verilen tablolar yapay zekâya açılır (sütun, örnek ve sorgu düzeylerinde gerçek veri gönderilir) — kişisel bilgi içeren tabloları açmayın.
Tüm belgeler burada — Kullanım kılavuzu