← 이용 안내로 돌아가기
외부 데이터 예제

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

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

시작 전 — DB 연결과 읽기 전용 계정이 먼저입니다 — Supabase 연동 가이드

수집기 받기

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

git clone https://github.com/valueconnectinc/soritrading-fetchers ~/soritrading-fetchers
cd ~/soritrading-fetchers && npm install
cp .env.example .env    # DATABASE_URL

https://github.com/valueconnectinc/soritrading-fetchers · 오픈소스 · 폴더 하나 = 페처 하나 · cron 자동 등록

아래 셋은 **시작용 예시**입니다. 리포에는 VIX·크립토 내재변동성(DVOL)·장단기 금리차·달러지수·스테이블코인 시총·DeFi TVL 등이 더 있고, 전부 무료·키 불필요입니다 — `node run.mjs list` 로 전체 목록을 봅니다. 시장 데이터는 미국 휴장일에 값이 없고(0이 아니라 없음), DVOL 은 2021년 3월부터입니다.

1. 공포탐욕 지수

alternative.me

0(극단적 공포)~100(극단적 탐욕), 일 1회. 2018-02 부터 전 기간. 가격만으로는 안 보이는 심리 축이라 첫 테스트로 가장 좋습니다.

node run.mjs fear-greed
AI 에게 이렇게 말하면 됩니다
"내 DB 의 fear_greed 테이블을 fg 로 등록하고, 공포탐욕 20 미만에서 매수·60 초과에서 매도하는 전략으로 binance BTC 1d 백테스트 해줘"
등록 값 (직접 확인·수정할 때)
query: SELECT ts, v FROM fear_greed WHERE ts BETWEEN $1 AND $2
tsCol: ts   ·   valCol: v   ·   dbAlias: main

2. 비트코인 해시레이트

blockchain.com

체인 자체의 지표(TH/s). 가격과 다른 축이라 국면 필터로 쓸 만합니다. 값이 크고 추세가 완만해서, 원값보다 이동평균 대비 비율로 쓰는 편이 낫습니다.

node run.mjs btc-hashrate
AI 에게 이렇게 말하면 됩니다
"내 DB 의 btc_hashrate 를 hr 로 등록하고, 해시레이트가 90일 평균 위일 때만 매수하는 필터를 기존 전략에 붙여줘"
등록 값 (직접 확인·수정할 때)
query: SELECT ts, v FROM btc_hashrate WHERE ts BETWEEN $1 AND $2
tsCol: ts   ·   valCol: v   ·   dbAlias: main

3. 미국 기준금리 (연습용)

FRED (DFF)

일별 실효 연방기금금리. 거시 국면 필터의 대표값입니다. ★ 주의: 비슷한 축이 이미 ctx.macro 로 제공됩니다. 같은 값을 두 경로로 넣으면 결과에서 어느 쪽을 썼는지 갈리지 않으니, 이건 연동 연습용으로만 쓰세요.

node run.mjs fed-funds
AI 에게 이렇게 말하면 됩니다
"내 DB 의 macro_fed_funds 를 dff 로 등록해줘 (연동 확인용)"
등록 값 (직접 확인·수정할 때)
query: SELECT ts, v FROM macro_fed_funds WHERE ts BETWEEN $1 AND $2
tsCol: ts   ·   valCol: v   ·   dbAlias: main

주기 수집 (cron)

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

node run.mjs --install-cron
알아둘 것
  • 시각 컬럼은 초 단위 epoch 를 권장합니다(밀리초·ISO 도 자동 인식되고, 어느 쪽으로 읽었는지는 검증 보고의 tsUnit 에 남습니다).
  • 스크립트를 다시 실행해도 안전합니다 — 중복 없이 최신 값만 갱신됩니다(upsert). 새 데이터는 주기적으로 다시 돌리면 됩니다.
  • 백테스트 결과에는 데이터 지문(행수·해시)이 남습니다 — DB 내용이 바뀌면 지문이 달라지고, 지문이 다른 두 결과는 같은 조건이 아닙니다.
  • 외부 데이터를 쓰는 백테스트는 에이전트에서만 돕니다(데이터가 유저 기기의 에이전트에만 있기 때문). 브라우저 러너는 그런 잡을 반납합니다.
  • 공개 단계를 준 테이블은 AI 에 노출됩니다(컬럼·샘플·조회 단계는 실제 데이터가 나갑니다) — 개인정보가 있는 테이블은 공개하지 마세요.