← Kembali ke panduan penggunaan
Contoh data luaran

Mulakan dengan data awam untuk ujian

Jika anda telah menyambungkan DB tetapi tiada data untuk dimasukkan, mulakan dengan salah satu daripada tiga di bawah. Semuanya percuma dan boleh diambil tanpa kunci API, dan anda hanya perlu mengikut skrip pemuat serta nilai yang dipilih di skrin (jadual · lajur). Skrip ini dibina dengan menambah parser, jadi jika anda mahukan sumber lain, tulis satu entri lagi sahaja.

Sebelum bermula — Sambungkan DB dan cipta akaun baca sahaja terlebih dahulu — Panduan integrasi Supabase

Dapatkan pengumpul

Klon repo fetcher ke VPS (pelayan yang menjalankan ejen). Satu-satunya kebergantungan ialah pg. ★ DATABASE_URL dalam .env mesti akaun tulis. Akaun baca sahaja memang sepatutnya menolak INSERT, dan akaun itu khusus untuk integrasi 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 · Sumber terbuka · satu folder = satu fetcher · cron didaftarkan secara automatik

Tiga di bawah ialah **contoh permulaan**. Repo juga mempunyai VIX, volatiliti tersirat kripto (DVOL), beza kadar faedah jangka panjang-pendek, indeks dolar, permodalan pasaran stablecoin, DeFi TVL dan lain-lain — semuanya percuma dan tanpa kunci. Lihat senarai penuh dengan `node run.mjs list`. Data pasaran tiada nilai pada hari cuti AS (tiada, bukan 0), dan DVOL bermula dari Mac 2021.

Cara membaca skrin Tetapan data

Pengurusan ejen → pilih ejen → tab Tetapan data. Hanya anda yang mendaftar dan memadam di skrin ini — AI hanya membaca set data, dan rentetan sambungan tidak sekali-kali ditampal ke dalam sembang. Dari atas, skrin disusun mengikut urutan ini.

  1. Integrasi DB luaran — Masukkan nama sambungan (cth. main) dan rentetan sambungan. Ia disimpan secara tersulit pada peranti ejen sahaja dan tidak dihantar ke pelayan. Apabila skrin dibuka, ejen membaca senarai jadual secara automatik ([Semak sambungan] untuk membacanya semula).
  2. Jadual dan set data — Satu baris untuk setiap jadual dalam DB: nama jadual · anggaran bilangan baris · ulasan jadual, dan set data yang membaca jadual itu disenaraikan di bawahnya.
  3. Tahap pendedahan AI (kanan baris jadual) — Peribadi (lalai — AI tidak tahu pun jadual itu wujud) · nama sahaja · hingga lajur · hingga sampel · benarkan pertanyaan. Selepas memilih, tekan [Simpan tetapan pendedahan]. Tahap lajur, sampel dan pertanyaan menghantar data sebenar kepada AI, jadi jangan buka jadual yang mengandungi maklumat peribadi. Hanya jadual dalam skema public boleh dibuka.
  4. Nama set data (di bawah baris jadual) — Nilai yang dipanggil oleh strategi dengan ctx.data(nama). [+ Tambah set data daripada jadual ini] → pilih nama, lajur masa dan lajur nilai; penerangan diisi daripada ulasan jadual, dan [Simpan] hanya dibuka selepas [Uji] lulus. Satu jadual boleh mempunyai beberapa nama (apabila membahagikan siri mengikut bursa atau simbol dengan penapis, atau apabila strategi lama menggunakan nama lain). Lencana status: boleh digunakan · belum disemak · tidak bersambung. Klik lencana masa nyata di sebelahnya untuk membuka tetapan bangun (poll · notify · redis) — kebanyakannya cukup dengan nilai lalai.
  5. Set data terkira (SQL) — Nilai yang memerlukan pengiraan seperti purata bergerak, nilai tertunda atau gabungan beberapa jadual. SQL boleh membaca beberapa jadual, jadi ia dikumpulkan berasingan dan tidak diletakkan di bawah jadual tertentu. Kebanyakan pengiraan boleh dibuat dalam kod strategi dengan dua ctx.data, jadi gunakan SQL hanya untuk pengiraan yang memerlukan keseluruhan tempoh sejarah (purata bergerak · kedudukan). SQL yang didaftarkan dengan cara lama boleh ditanda [SQL telah disemak] · [Padam] di sini, atau jika bentuknya ringkas, ditukar secara pukal kepada cara pemilihan jadual.
  6. Set data yang jadualnya tidak ditemui — Apabila jadual yang diisytiharkan tiada dalam senarai semasa, set data tidak hilang tetapi kekal di sini bersama sebabnya — senarai jadual belum diterima (bukan bermaksud tiada) · DB itu tiada jadual tersebut (ditukar nama · dipadam) · peranti ini tiada nama sambungan tersebut.
  7. Terdapat dua skop — Tahap pendedahan AI disimpan pada peranti yang sedang dibuka sahaja. Set data digunakan pada semua peranti yang mempunyai nama sambungan yang sama. Jika anda mempunyai beberapa peranti, pilih tahap pendedahan pada setiap peranti secara berasingan.

1. Indeks Fear & Greed

alternative.me

0 (ketakutan melampau) hingga 100 (ketamakan melampau), sekali sehari. Seluruh tempoh sejak Februari 2018. Ini paksi sentimen yang tidak kelihatan daripada harga sahaja, jadi ia paling sesuai untuk ujian pertama.

node run.mjs fear-greed
Nilai yang dipilih di skrin Tetapan data ([+ Tambah set data daripada jadual ini] pada baris jadual)
Sambungan: main   ·   Jadual: fear_greed
Nama: fg   ·   Lajur masa: ts   ·   Lajur nilai: v
Selepas mendaftar, katakan ini kepada AI
"Dengan set data saya fg, buat backtest strategi yang membeli apabila Fear & Greed di bawah 20 dan menjual apabila melebihi 60 pada binance BTC 1d"

2. Kadar hash Bitcoin

blockchain.com

Metrik rantaian itu sendiri (TH/s). Ia paksi yang berbeza daripada harga, jadi berguna sebagai penapis rejim. Nilainya besar dan aliran pergerakannya perlahan, jadi lebih baik menggunakan nisbah berbanding purata bergerak daripada nilai mentah.

node run.mjs btc-hashrate
Nilai yang dipilih di skrin Tetapan data ([+ Tambah set data daripada jadual ini] pada baris jadual)
Sambungan: main   ·   Jadual: btc_hashrate
Nama: hashrate   ·   Lajur masa: ts   ·   Lajur nilai: v
Selepas mendaftar, katakan ini kepada AI
"Tambahkan penapis pada strategi sedia ada yang hanya membeli apabila set data hashrate berada di atas purata 90 harinya"

3. Kadar faedah asas AS (latihan)

FRED (DFF)

Kadar dana persekutuan efektif harian. Nilai lazim untuk penapis rejim makro. ★ Perhatian: nilai yang sama sudah tersedia sebagai penunjuk asas base_fedfunds (ctx.data('base_fedfunds') — dikumpul oleh ejen daripada FRED). Jika nilai yang sama dimasukkan melalui dua laluan, keputusan tidak dapat membezakan laluan mana yang digunakan, jadi gunakan ini untuk latihan integrasi sahaja.

node run.mjs fed-funds
Nilai yang dipilih di skrin Tetapan data ([+ Tambah set data daripada jadual ini] pada baris jadual)
Sambungan: main   ·   Jadual: macro_fed_funds
Nama: dff   ·   Lajur masa: ts   ·   Lajur nilai: v
Selepas mendaftar, katakan ini kepada AI
"Tunjukkan senarai set data saya dan semak sama ada dff boleh digunakan (untuk mengesahkan integrasi)"

Pengumpulan berjadual (cron)

Setiap fetcher didaftarkan dalam crontab mengikut jadual yang diisytiharkannya. Menjalankannya semula tidak menambah baris berulang, dan entri cron yang anda masukkan sendiri tidak disentuh. Log disimpan dalam fail log setiap fetcher di dalam folder logs.

node run.mjs --install-cron
Perkara yang perlu diketahui
  • Lajur masa disarankan dalam epoch saat (milisaat dan ISO juga dikesan secara automatik, dan cara ia dibaca dicatat dalam tsUnit laporan pengesahan).
  • Menjalankan semula skrip adalah selamat — ia hanya mengemas kini nilai terkini tanpa pendua (upsert). Untuk data baharu, jalankan semula secara berkala.
  • Keputusan backtest menyimpan cap jari data (bilangan baris · hash) — jika kandungan DB berubah, cap jari turut berubah, dan dua keputusan dengan cap jari berbeza tidak dijalankan pada syarat yang sama.
  • Backtest yang menggunakan data luaran juga berjalan pada ejen — semua backtest hanya berjalan pada ejen (stor saya).
  • Jadual yang diberi tahap pendedahan akan kelihatan kepada AI (tahap lajur, sampel dan pertanyaan menghantar data sebenar) — jangan dedahkan jadual yang mengandungi maklumat peribadi.