Почніть із публічних даних для тесту
Якщо ви підключили свою базу даних, але не маєте, що до неї завантажити, почніть з одного з трьох прикладів нижче. Усі вони безкоштовні й не потребують 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)
Реєструє кожен фетчер у crontab з оголошеною ним періодичністю. Повторний запуск не накопичує рядки, а записи cron, додані вами вручну, не зачіпаються. Журнали зберігаються в окремому файлі для кожного фетчера в теці logs.
node run.mjs --install-cron
- Для стовпця часу рекомендовано epoch у секундах (мілісекунди та ISO теж розпізнаються автоматично, а спосіб зчитування видно в полі tsUnit звіту перевірки).
- Скрипт безпечно запускати повторно — оновлюються лише новіші значення, без дублікатів (upsert). Для нових даних запускайте його періодично.
- Результати бектесту містять відбиток даних (кількість рядків, хеш) — якщо вміст бази даних змінюється, змінюється й відбиток, а два результати з різними відбитками отримано за різних умов.
- Бектести із зовнішніми даними також виконуються в агенті — усі бектести виконуються лише в агенті (моє сховище).
- Таблиці, яким ви надали рівень доступу, стають видимими для AI (рівні стовпців, зразка та запиту надсилають реальні дані) — не відкривайте таблиці з персональними даними.
Уся документація тут — Довідка