← Kullanım kılavuzuna dön
Harici veri örnekleri

Ü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.

Başlamadan önce — Önce DB bağlantısı ve salt okunur hesap gerekir — Supabase bağlantı rehberi

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.

  1. 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).
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. İ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.me

0 (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
Veri ayarları ekranında seçilecek değerler (tablo satırındaki [+ Bu tablodan veri seti ekle])
Bağlantı: main   ·   Tablo: fear_greed
Ad: fg   ·   Zaman sütunu: ts   ·   Değer sütunu: v
Kaydettikten sonra yapay zekâya şöyle söyleyin
"Veri setim fg ile, korku-açgözlülük 20'nin altındayken alan ve 60'ın üstündeyken satan stratejiyi binance BTC 1d üzerinde backtest et"

2. Bitcoin hash oranı

blockchain.com

Zincirin 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
Veri ayarları ekranında seçilecek değerler (tablo satırındaki [+ Bu tablodan veri seti ekle])
Bağlantı: main   ·   Tablo: btc_hashrate
Ad: hashrate   ·   Zaman sütunu: ts   ·   Değer sütunu: v
Kaydettikten sonra yapay zekâya şöyle söyleyin
"Mevcut stratejime, hashrate veri seti 90 günlük ortalamasının üstündeyken yalnızca alım yapan bir filtre ekle"

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
Veri ayarları ekranında seçilecek değerler (tablo satırındaki [+ Bu tablodan veri seti ekle])
Bağlantı: main   ·   Tablo: macro_fed_funds
Ad: dff   ·   Zaman sütunu: ts   ·   Değer sütunu: v
Kaydettikten sonra yapay zekâya şöyle söyleyin
"Veri setlerimin listesini göster ve dff'nin kullanılabilir durumda olup olmadığını kontrol et (yalnızca bağlantıyı doğrulamak için)"

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
Bilinmesi gerekenler
  • 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.