Започнете с публични данни за тест
Ако сте свързали своята база данни, но нямате какво да заредите в нея, започнете с един от трите примера по-долу. Всички са безплатни и не изискват 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 (нивата колони, извадка и заявки изпращат реални данни) — не отваряйте таблици с лични данни.
Цялата документация е тук — Ръководство