← Обратно към ръководствата
Примери с външни данни

Започнете с публични данни за тест

Ако сте свързали своята база данни, но нямате какво да заредите в нея, започнете с един от трите примера по-долу. Всички са безплатни и не изискват 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

Цялата документация е тук — Ръководство