TerraFin은(는) 무엇을 하나요?
에이전트 기반 Python 툴킷 및 FastAPI 인터페이스로 금융 데이터, 차트, 분석 및 리서치 워크플로우를 지원합니다.
기능
- 금융 데이터 수집: 주식, 암호화폐, 환율 등 다양한 소스에서 실시간/히스토리 데이터를 가져옵니다.
- 차트 생성: 막대 그래프, 선 그래프, 캔들스틱 차트 등 여러 시각화를 손쉽게 생성합니다.
- 기술적 분석: 이동평균, RSI, MACD 등 주요 지표를 계산합니다.
- 리서치 워크플로우: 자연어 쿼리를 통해 금융 보고서를 요약하고 인사이트를 추출합니다.
- FastAPI 엔드포인트: 모든 기능이 HTTP API로 제공되어 AI 에이전트가 직접 호출 가능합니다.
설치
pip install terraFin
또는 소스에서 빌드:
git clone https://github.com/KiUngSong/TerraFin.git
cd TerraFin
pip install -r requirements.txt
빠른 시작
-
서버 실행:
uvicorn app.main:app --reload -
기본 API 호출 (예: 주식 데이터 가져오기):
curl "http://localhost:8000/api/v1/stock?symbol=AAPL&interval=1d" -
차트 생성 요청:
curl -X POST "http://localhost:8000/api/v1/chart" \ -H "Content-Type: application/json" \ -d '{"symbol": "BTC-USD", "type": "candlestick", "period": "1mo"}'
환경 변수
| 변수명 | 설명 | 필수 여부 |
|---|---|---|
ALPHA_VANTAGE_API_KEY | Alpha Vantage API 키 (주식 데이터) | 아니요 |
COINMARKETCAP_API_KEY | CoinMarketCap API 키 (암호화폐) | 아니요 |
OPENAI_API_KEY | OpenAI API 키 (리서치 워크플로우) | 아니요 |
사용 예시 (Python)
from terraFin import StockData, ChartGenerator
# 데이터 가져오기
data = StockData(symbol="GOOGL", start="2024-01-01", end="2024-12-31")
print(data.head())
# 차트 생성
chart = ChartGenerator(data)
chart.candlestick(title="Google 주가 추이")
chart.save("google_candlestick.png")
AI 에이전트와 통합
TerraFin은 AI 에이전트가 HTTP API를 통해 직접 사용할 수 있도록 설계되었습니다. 다음은 Claude Code에서의 사용 예시입니다:
{
"name": "fetch_stock_data",
"parameters": {
"symbol": "AAPL",
"interval": "1d"
},
"url": "http://localhost:8000/api/v1/stock"
}
이를 통해 에이전트는 실시간 금융 데이터에 접근하고, 차트를 생성하며, 분석 결과를 바탕으로 사용자에게 추천을 제공할 수 있습니다.
라이선스
MIT License