테스트용 공개 데이터로 시작하기

내 DB 를 연동했는데 넣을 데이터가 없다면, 아래 셋 중 하나로 시작하세요. 전부 무료·API 키 없이 받을 수 있고, 적재 스크립트와 화면에서 고를 값(표·열)까지 그대로 따라 하면 됩니다. 스크립트는 파서를 추가하는 구조라, 원하는 소스가 있으면 항목 하나만 더 쓰면 됩니다.

수집기 받기

페처 리포를 VPS(에이전트가 있는 서버)에 클론합니다. 의존성은 pg 하나뿐입니다. ★ .env 의 DATABASE_URL 은 쓰기 계정으로. 읽기 전용 계정은 INSERT 가 거부되는 게 정상이고, 그 계정은 소리트레이딩 연동 전용입니다.

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년 3월부터입니다.

데이터 설정 화면 읽는 법

에이전트 관리 → 에이전트 선택 → 데이터 설정 탭. 등록·삭제는 이 화면에서 본인만 합니다 — AI 는 데이터셋을 읽기만 하고, 연결 문자열은 채팅에 절대 붙여넣지 않습니다. 화면은 위에서부터 이 순서입니다.

1. 외부 DB 연동 — 연결 이름(예: main)과 연결 문자열을 넣습니다. 에이전트 기기에만 암호화 저장되고 서버로 가지 않습니다. 화면을 열면 에이전트가 표 목록을 자동으로 읽어옵니다([연결 확인]은 다시 읽고 싶을 때).
2. 표와 데이터셋 — DB 의 표마다 한 줄입니다. 표 이름 · 대략의 행 수 · 표 주석, 그리고 그 표를 읽는 데이터셋들이 그 아래에 붙습니다.
3. AI 공개 단계 (표 줄 오른쪽) — 비공개(기본 — AI 는 표가 있는지도 모름) · 이름만 · 컬럼까지 · 샘플까지 · 조회 허용. 고른 뒤 [공개 설정 저장]. 컬럼·샘플·조회 단계는 실제 데이터가 AI 에 나가므로 개인정보가 있는 표는 열지 마세요. public 스키마의 표만 열 수 있습니다.
4. 데이터셋 이름 (표 줄 아래) — 전략이 ctx.data(이름) 으로 부르는 값입니다. [+ 이 표로 데이터셋 추가] → 이름·시각 열·값 열을 고르면 설명은 표 주석으로 채워지고, [테스트] 를 통과해야 [저장] 이 열립니다. 한 표에 이름을 여러 개 붙일 수 있습니다(필터로 거래소·종목별 시리즈를 나눌 때, 또는 옛 전략이 다른 이름을 쓸 때). 상태 배지: 사용 가능 · 확인 전 · 연결 안 됨. 배지 옆 실시간 배지를 누르면 깨우기 설정(poll·notify·redis)이 펼쳐집니다 — 대부분은 기본값이면 됩니다.
5. 계산 데이터셋 (SQL) — 이동평균·지연값·여러 표 조합처럼 계산이 필요한 값. SQL 은 여러 표를 읽을 수 있어서 특정 표 밑에 두지 않고 따로 모읍니다. 대부분의 계산은 전략 코드에서 ctx.data 두 개로도 할 수 있으니, SQL 은 과거 구간 전체가 필요한 계산(이동평균·순위)일 때만 쓰세요. 이전 방식으로 등록된 SQL 은 여기서 [SQL 확인함] · [삭제] 하거나, 단순한 모양이면 표 선택 방식으로 일괄 변환합니다.
6. 표를 찾지 못한 데이터셋 — 선언한 표가 지금 목록에 없을 때 사라지지 않고 이유와 함께 여기 남습니다 — 표 목록을 아직 못 받음(없다는 뜻이 아님) · 그 DB 에 표가 없음(이름 변경·삭제) · 이 기기에 그 연결 이름이 없음.
7. 범위가 둘입니다 — AI 공개 단계는 지금 열린 그 기기에만 저장됩니다. 데이터셋은 같은 연결 이름을 가진 모든 기기에 적용됩니다. 기기가 여럿이면 공개 단계는 기기마다 따로 고릅니다.

node run.mjs fear-greed

연결: main   ·   표: fear_greed
이름: fg   ·   시각 열: ts   ·   값 열: v

node run.mjs btc-hashrate

연결: main   ·   표: btc_hashrate
이름: hashrate   ·   시각 열: ts   ·   값 열: v

node run.mjs fed-funds

연결: main   ·   표: macro_fed_funds
이름: dff   ·   시각 열: ts   ·   값 열: v

주기 수집 (cron)

페처마다 선언된 주기로 crontab 에 등록합니다. 다시 실행해도 줄이 쌓이지 않고, 직접 넣은 cron 은 건드리지 않습니다. 로그는 logs 폴더의 페처별 로그 파일 에 남습니다.

node run.mjs --install-cron