"요즘 코인 시장 어때?" 라는 질문에 답하려면, 보통은 차트를 열고, 뉴스를 찾아보고, 지표를 하나하나 확인해야 하죠. 꽤 번거로운 작업입니다.
이 예제에서는 SpoonOS의 선언적 그래프 시스템을 활용해서, 이 과정을 통째로 자동화하는 방법을 보여드립니다. 바이낸스에서 실시간 데이터를 가져오고, 기술적 지표를 계산하고, 뉴스까지 분석한 다음, LLM이 최종 투자 리포트까지 만들어주는 파이프라인을 구축해볼 거예요.
직접 코드를 한 줄 한 줄 짜는 게 아니라, 그래프 노드를 선언하는 것만으로 이 모든 흐름이 만들어진다는 게 핵심입니다.
전체 흐름을 한눈에 보면
아래 다이어그램이 이 파이프라인의 전체 구조입니다. 시작부터 끝까지 데이터가 어떻게 흘러가는지 살펴보세요.
graph TD
A[시작] --> B[바이낸스 시장 데이터 수집]
B --> C[거래량 상위 10개 페어 선정]
C --> D[토큰 리스트 준비]
D --> E[병렬 토큰 분석]
E --> F1[토큰 1: 기술적 분석 + 뉴스 분석]
E --> F2[토큰 2: 기술적 분석 + 뉴스 분석]
E --> F3[토큰 3: 기술적 분석 + 뉴스 분석]
E --> F4[토큰 4: 기술적 분석 + 뉴스 분석]
E --> F5[토큰 5: 기술적 분석 + 뉴스 분석]
E --> F6[토큰 6: 기술적 분석 + 뉴스 분석]
E --> F7[토큰 7: 기술적 분석 + 뉴스 분석]
E --> F8[토큰 8: 기술적 분석 + 뉴스 분석]
E --> F9[토큰 9: 기술적 분석 + 뉴스 분석]
E --> F10[토큰 10: 기술적 분석 + 뉴스 분석]
F1 --> G[전체 결과 집계]
F2 --> G
F3 --> G
F4 --> G
F5 --> G
F6 --> G
F7 --> G
F8 --> G
F9 --> G
F10 --> G
G --> H[LLM 최종 종합 분석]
H --> I[시장 리포트 생성]
I --> J[종료]
style A fill:#e1f5fe
style J fill:#c8e6c9
style E fill:#fff3e0
style G fill:#fce4ec
subgraph "기술적 분석"
F1
F2
F3
F4
F5
F6
F7
F8
F9
F10
end간단히 정리하면 이렇습니다:
- 바이낸스에서 실시간 시장 데이터를 가져옵니다 — 현재 거래되고 있는 모든 페어의 가격, 거래량, 변동률 등을 수집해요.
- 거래량 기준 상위 10개 토큰을 자동으로 골라냅니다 — 사람이 "어떤 코인을 분석할까?" 고민할 필요 없이, LLM이 시장 상황을 보고 직접 판단합니다.
- 10개 토큰을 동시에 병렬로 분석합니다 — 각 토큰마다 기술적 지표(RSI, MACD, EMA)를 계산하고, 관련 뉴스까지 검색해서 종합합니다. 병렬 처리라 10개를 분석해도 시간이 오래 걸리지 않아요.
- LLM이 모든 분석 결과를 모아서 최종 리포트를 만들어줍니다 — 단순히 숫자를 나열하는 게 아니라, "지금 시장이 어떤 상태이고, 어떤 전략이 유효한지"를 사람이 읽기 편한 형태로 정리해줍니다.
이 예제에서 눈여겨볼 점
그래프만 선언하면 알아서 돌아간다
가장 큰 특징은, 복잡한 제어 흐름을 직접 코딩하지 않아도 된다는 점입니다. GraphTemplate으로 전체 구조를 정의하고, NodeSpec으로 각 단계가 뭘 하는지 선언하고, EdgeSpec으로 단계 간 연결을 잡아주면 끝이에요. 나머지는 SpoonOS 그래프 엔진이 알아서 실행 순서를 잡고, 병렬 처리가 가능한 부분은 자동으로 병렬화해줍니다.
# 이런 식으로 노드를 선언하기만 하면 됩니다
template = GraphTemplate(
nodes=[
NodeSpec(name="fetch_market_data", ...),
NodeSpec(name="select_top_tokens", ...),
NodeSpec(name="analyze_token", ...),
NodeSpec(name="generate_report", ...),
],
edges=[
EdgeSpec(source="fetch_market_data", target="select_top_tokens"),
EdgeSpec(source="select_top_tokens", target="analyze_token"),
EdgeSpec(source="analyze_token", target="generate_report"),
]
)HighLevelGraphAPI가 파라미터를 알아서 채워준다
"BTC 시장 분석해줘" 같은 자연어 쿼리를 넣으면, HighLevelGraphAPI가 쿼리를 해석해서 어떤 토큰을 분석할지, 어떤 타임프레임을 쓸지 등의 파라미터를 자동으로 추론합니다. 일일이 설정값을 지정하지 않아도 그냥 자연어로 말하면 되는 거죠.
실제 API를 사용한 실시간 분석
샘플 데이터가 아니라 실제 바이낸스 API와 PowerData 툴킷을 통해 라이브 데이터를 가져옵니다. RSI, MACD, EMA 같은 기술적 지표도 실시간 캔들 데이터로 직접 계산하고, Tavily 검색 엔진으로 최신 뉴스까지 가져와서 분석에 반영해요.
LLM이 모든 의사결정의 중심에 있다
어떤 토큰을 분석할지 고르는 것부터, 기술적 지표를 해석하는 것, 뉴스의 영향을 판단하는 것, 최종 추천을 내리는 것까지 — 파이프라인의 모든 주요 판단을 LLM이 담당합니다. 사람이 규칙을 하드코딩하는 게 아니라, LLM이 맥락을 이해하고 유연하게 판단하는 구조입니다.
실행해보기
먼저 API 키를 준비합니다. LLM을 호출하기 위한 키와, 뉴스 검색을 위한 키가 필요해요.
# 환경 변수 설정
export OPENAI_API_KEY="your-openai-api-key" # LLM 호출용
export ANTHROPIC_API_KEY="your-anthropic-api-key" # 대체 LLM
export TAVILY_API_KEY="your-tavily-api-key" # 뉴스 검색용그다음은 간단합니다.
# 예제 디렉토리로 이동
cd spoon-core/example
# 의존성 설치
pip install -r requirements.txt
# 실행!
python graph_crypto_analysis.py실행하면 콘솔에 각 단계의 진행 상황이 출력되고, 최종적으로 이런 형태의 리포트가 생성됩니다.
시장 분석 리포트
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
분석 대상 토큰: BTC, ETH, SOL, ADA
기술적 분석:
• BTC/USDT: 강세 모멘텀, RSI: 68, MACD 골든크로스
• ETH/USDT: 횡보 구간, 주요 저항선 접근 중
• SOL/USDT: 강한 상승 추세, 전고점 돌파
• ADA/USDT: 회복 국면, 거래량 모멘텀 긍정적
투자 추천:
• 단기: BTC와 SOL의 모멘텀 매매 고려
• 중기: 현재 횡보 구간에서 ETH 보유 유지
• 리스크 평가: 향후 24~48시간 내 중간 수준의 변동성 예상
시장 전망:
현재 시장은 BTC 주도의 강한 상승 모멘텀을 보이고 있으며...이 예제에서 배울 수 있는 것
이 하나의 예제를 통해 SpoonOS의 핵심적인 패턴들을 경험할 수 있습니다.
- 선언적 그래프 빌딩 —
GraphTemplate,NodeSpec,EdgeSpec만으로 복잡한 워크플로우를 깔끔하게 정의하는 방법 - 자연어 기반 파라미터 추론 —
HighLevelGraphAPI가 사용자의 의도를 파악해서 자동으로 설정을 잡아주는 구조 - 병렬 처리 — 독립적인 분석 작업을 동시에 실행해서 전체 처리 시간을 줄이는 방법
- LLM 통합 워크플로우 — 단순한 API 호출이 아니라, 워크플로우의 의사결정 자체를 LLM에게 맡기는 패턴
- 실시간 외부 API 연동 — 바이낸스, 검색 엔진 등 외부 서비스를 그래프 노드로 자연스럽게 통합하는 방법
- 에러 처리와 폴백 — 금융 데이터처럼 신뢰성이 중요한 영역에서의 견고한 에러 핸들링
소스 코드
- 메인 예제: graph_crypto_analysis.py
- 관련 모듈:
spoon_ai/graph/builder.py— 선언적 템플릿 및 고수준 APItoolkit/spoon_toolkits/crypto/crypto_powerdata/tools.py— PowerData 연동 헬퍼spoon_ai/graph/— 코어 엔진 및 모니터링 유틸리티- 도구 시스템 문서
더 알아보기
이 예제는 SpoonOS 그래프 시스템의 한 가지 활용 사례일 뿐입니다. 같은 구조로 뉴스 요약 봇, 데이터 수집 파이프라인, 멀티 에이전트 협업 시스템 등 다양한 워크플로우를 만들 수 있어요. 핵심은 항상 같습니다 — 그래프를 선언하고, 나머지는 SpoonOS에게 맡기세요.
