← Назад до посібників
Приклади зовнішніх даних

Почніть із публічних даних для тесту

Якщо ви підключили свою базу даних, але не маєте, що до неї завантажити, почніть з одного з трьох прикладів нижче. Усі вони безкоштовні й не потребують API-ключа — просто дотримуйтеся скрипту завантаження та значень, які треба вибрати на екрані (таблиця, стовпці). Скрипт побудований так, що до нього додаються парсери, тож якщо потрібне інше джерело, достатньо дописати ще один запис.

Перед початком — Спочатку підключіть базу даних і створіть обліковий запис лише для читання — Посібник із підключення Supabase

Отримайте збирачі

Клонуйте репозиторій фетчерів на 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 лише читає набори даних, а рядок підключення ніколи не вставляється в чат. Згори донизу екран має такі частини.

  1. Підключення зовнішньої бази даних — Введіть назву з'єднання (напр. main) і рядок підключення. Він зберігається зашифрованим лише на пристрої агента й не потрапляє на сервер. Коли ви відкриваєте екран, агент автоматично зчитує список таблиць ([Перевірити з'єднання] — якщо хочете зчитати його знову).
  2. Таблиці та набори даних — По одному рядку на кожну таблицю бази даних: назва таблиці · приблизна кількість рядків · коментар таблиці, а під ним — набори даних, що читають цю таблицю.
  3. Рівень видимості для AI (праворуч у рядку таблиці) — Приватно (за замовчуванням — AI навіть не знає, що таблиця існує) · лише назва · до стовпців · до зразка · дозволені запити. Виберіть і натисніть [Зберегти видимість]. Рівні стовпців, зразка й запитів надсилають реальні дані до AI, тож не відкривайте таблиці з персональними даними. Відкривати можна лише таблиці у схемі public.
  4. Назви наборів даних (під рядком таблиці) — Значення, які стратегія викликає через ctx.data(назва). [+ Додати набір даних із цієї таблиці] → виберіть назву, стовпець часу та стовпець значення; опис заповнюється з коментаря таблиці, а [Зберегти] стає доступним лише після успішного [Тест]. Одна таблиця може мати кілька назв (коли фільтром розділяєте серії за біржею чи інструментом або коли стара стратегія використовує іншу назву). Значок стану: доступно · не перевірено · не підключено. Натисніть значок реального часу поруч, щоб відкрити налаштування пробудження (poll · notify · redis) — для більшості достатньо значення за замовчуванням.
  5. Обчислювані набори даних (SQL) — Значення, що потребують обчислення — ковзні середні, значення із запізненням, поєднання кількох таблиць. SQL може читати кілька таблиць, тому такі набори зібрано окремо, а не під певною таблицею. Більшість обчислень можна зробити в коді стратегії двома викликами ctx.data; використовуйте SQL лише тоді, коли обчисленню потрібна вся історія (ковзні середні, рейтинги). Тут також записи SQL, зареєстровані по-старому: [SQL перевірено] · [Видалити], або масово перетворіть прості на вибір таблиці.
  6. Набори даних, таблицю яких не знайдено — Коли оголошеної таблиці немає в поточному списку, набір даних не зникає, а залишається тут із причиною: список таблиць ще не отримано (це не означає, що її немає) · у цій базі даних немає такої таблиці (перейменовано або видалено) · на цьому пристрої немає з'єднання з такою назвою.
  7. Є дві області дії — Рівень видимості для AI зберігається лише на пристрої, який ви відкрили. Набори даних діють для всіх пристроїв з однаковою назвою з'єднання. Якщо пристроїв кілька, рівень видимості вибирається для кожного окремо.

1. Індекс страху й жадібності

alternative.me

Від 0 (крайній страх) до 100 (крайня жадібність), раз на день. Уся історія з лютого 2018 року. Вісь настроїв, яку сама ціна не показує, — найкращий перший тест.

node run.mjs fear-greed
Значення, які треба вибрати на екрані налаштувань даних ([+ Додати набір даних із цієї таблиці] у рядку таблиці)
З'єднання: main   ·   Таблиця: fear_greed
Назва: fg   ·   Стовпець часу: ts   ·   Стовпець значення: v
Після реєстрації просто скажіть AI ось це
"З моїм набором даних fg зроби бектест на binance BTC 1d стратегії, яка купує, коли індекс страху й жадібності нижче 20, і продає вище 60"

2. Хешрейт біткоїна

blockchain.com

Показник самого блокчейну (TH/s). Вісь, відмінна від ціни, корисна як фільтр режиму. Значення великі, а тренд плавний, тому краще використовувати співвідношення до ковзного середнього, а не сире значення.

node run.mjs btc-hashrate
Значення, які треба вибрати на екрані налаштувань даних ([+ Додати набір даних із цієї таблиці] у рядку таблиці)
З'єднання: main   ·   Таблиця: btc_hashrate
Назва: hashrate   ·   Стовпець часу: ts   ·   Стовпець значення: v
Після реєстрації просто скажіть AI ось це
"Додай до моєї наявної стратегії фільтр, який купує лише тоді, коли набір даних hashrate вище свого 90-денного середнього"

3. Базова ставка США (для практики)

FRED (DFF)

Щоденна ефективна ставка федеральних фондів — класичний фільтр макрорежиму. ★ Увага: те саме значення вже надходить як базовий індикатор base_fedfunds (ctx.data('base_fedfunds') — агент збирає його з FRED). Якщо те саме значення надходить двома шляхами, з результатів не видно, яке з них використано, тож використовуйте це лише для практики підключення.

node run.mjs fed-funds
Значення, які треба вибрати на екрані налаштувань даних ([+ Додати набір даних із цієї таблиці] у рядку таблиці)
З'єднання: main   ·   Таблиця: macro_fed_funds
Назва: dff   ·   Стовпець часу: ts   ·   Стовпець значення: v
Після реєстрації просто скажіть AI ось це
"Покажи список моїх наборів даних і перевір, чи dff у придатному до використання стані (для перевірки підключення)"

Періодичне збирання (cron)

Реєструє кожен фетчер у crontab з оголошеною ним періодичністю. Повторний запуск не накопичує рядки, а записи cron, додані вами вручну, не зачіпаються. Журнали зберігаються в окремому файлі для кожного фетчера в теці logs.

node run.mjs --install-cron
Варто знати
  • Для стовпця часу рекомендовано epoch у секундах (мілісекунди та ISO теж розпізнаються автоматично, а спосіб зчитування видно в полі tsUnit звіту перевірки).
  • Скрипт безпечно запускати повторно — оновлюються лише новіші значення, без дублікатів (upsert). Для нових даних запускайте його періодично.
  • Результати бектесту містять відбиток даних (кількість рядків, хеш) — якщо вміст бази даних змінюється, змінюється й відбиток, а два результати з різними відбитками отримано за різних умов.
  • Бектести із зовнішніми даними також виконуються в агенті — усі бектести виконуються лише в агенті (моє сховище).
  • Таблиці, яким ви надали рівень доступу, стають видимими для AI (рівні стовпців, зразка та запиту надсилають реальні дані) — не відкривайте таблиці з персональними даними.
Інші посібники
Створення сервера ↗Посібник зі знімками екрана: сервер (VPS) для ваших стратегій за 5–10 хвилин — 10 мовамиЗовнішня база даних SupabaseСтворіть безкоштовний Postgres і підключіть його обліковим записом лише для читанняЗавантаження публічних данихЗавантажте безкоштовні дані — індекс страху й жадібності, хешрейт, ставки тощо — у свою базу даних і використовуйте їх у стратегіяхПробудження в реальному часі через RedisСтратегія реагує тієї ж миті, коли надходить нове значення — власне встановлення, кілька серверів або безкоштовний керований сервісПочаток роботи з forex (MT5)Бектест на MT5-рахунку вашого брокера та запуск у симуляції → демо → реальному рахункуРеєстрація пристроїв для захисту кодуЯк визначити й перевірити, які пристрої можуть відкривати захищено збережений код стратегійWhen your agent goes offlineMove to a new server and reconnect keys and runs after the server stops or is reclaimedP2P WebSocket API (англійською) ↗Підключіть власного бота чи скрипт до P2P-демона й отримуйте підтверджені сигнали WATCH TOGETHER — клієнти для JavaScript і Python

Уся документація тут — Довідка