← Назад до посібників
Посібник із зовнішньої БД

Підключення ваших даних через Supabase

Найпростіший спосіб, щоб стратегії читали показники з вашої бази даних (наприклад, індекс страху й жадібності, ончейн-дані) через ctx.data(). Безкоштовного рівня Supabase достатньо, а рядок підключення зберігається лише на пристрої агента — сервер soritrading не бачить ні даних, ні пароля.

Перед початком — Агент має бути встановлений і спарений (перевірте на сторінці керування агентами). Якщо ваші дані вже в іншому Postgres, почніть одразу з кроку 3 (обліковий запис лише для читання).
1

Створення проєкту Supabase

Створіть безкоштовний проєкт на supabase.com. Регіон краще обрати ближче до агента (VPS).

2

Створення таблиці й завантаження даних

Створіть таблицю часових рядів у SQL-редакторі або Table Editor. Мінімально потрібні два стовпці: стовпець часу (timestamp) і стовпець значення. Приклад: fear_greed(ts bigint, v numeric) — для ts рекомендовано epoch у секундах (мілісекунди та ISO також розпізнаються автоматично). Якщо даних для завантаження ще немає, спершу перегляньте розділ нижче — цей крок можна повністю пропустити.

Немає даних для завантаження? — тут зупиняється більшість

Найшвидше почати з безкоштовних публічних даних. Ми надаємо збирачі з відкритим кодом, які наповнюють вашу БД показниками на кшталт індексу страху й жадібності, хешрейту біткоїна, базової ставки США та VIX — усе безкоштовно й без API-ключа. Збирач **сам створює таблицю** (два стовпці: ts і v). Тож крок 2 зникає — дані завантажуються однією командою, а cron реєструється ще однією. ★ Для завантаження використовується обліковий запис із правом запису. Обліковий запис лише для читання з кроку 3 — окремий, ним агент читає дані.

Відкрити посібник із публічних даних →
3

Створення облікового запису ЛИШЕ ДЛЯ ЧИТАННЯ (важливо)

Для перевірки стратегій потрібне лише читання. Вставте SQL нижче в SQL-редактор Supabase, щоб створити роль лише для читання — це справжній захист, який не дає змінити дані, навіть якщо рядок підключення витече.

create role readonly_bot login password 'замініть-на-надійний-пароль';
grant usage on schema public to readonly_bot;
grant select on all tables in schema public to readonly_bot;
alter default privileges in schema public grant select on tables to readonly_bot;
4

Копіювання рядка підключення

На панелі проєкту відкрийте Project Overview → Get connected, скопіюйте URL у розділі Direct і замініть лише ім'я користувача та пароль на створені на кроці 3. У тому самому місці показано й варіант із пулером (pooler). ★ Supabase може змінювати написи в інтерфейсі — який режим ви скопіювали, видно із самого URL: · хост — db.ref-проєкту.supabase.co (пряме підключення) → ім'я користувача просто readonly_bot · хост містить pooler.supabase.com → ім'я користувача readonly_bot.ref-проєкту (залиште ref після крапки — без нього підключення відхиляється) ★ На безкоштовному рівні пряме підключення (5432) працює лише через IPv6 — якщо сервер агента не має IPv6, використовуйте URL у Session mode (пулер).

5

Підключіть і доручіть AI

У розділі Агенти → оберіть агента → вкладка Налаштування даних введіть назву підключення (main) і URL — підключення перевіряється одразу. Потім на тому самому екрані в рядку таблиці натисніть [+ Додати набір даних із цієї таблиці], оберіть назву, стовпець часу та стовпець значення, а потім [Тест] → [Зберегти] (AI лише читає набори даних). Після збереження AI може створити стратегію з цією назвою (наприклад, ctx.data('fg')) і запустити бектест. Якщо даних для завантаження немає, почніть із прикладів публічних даних на /guide/datasets (індекс страху й жадібності тощо).

Варто знати
  • Безкоштовні проєкти призупиняються після 1 тижня неактивності — перевірка агента кожні 10 хвилин зазвичай враховується як активність, тож проєкт не засинає.
  • Оновлення в реальному часі (режим notify) працює лише з URL у Session mode (пулінг у Transaction mode не підтримує LISTEN).
  • Результати бектесту містять відбиток даних (кількість рядків, хеш) — якщо вміст БД змінюється, відбиток стає іншим, а два результати з різними відбитками отримано не за однакових умов.
Інші посібники
Створення сервера ↗Посібник зі знімками екрана: сервер (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

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