API Server

FinTrack API

환율·주식 포트폴리오 트래커 백엔드 — Next.js 16 / Vercel

데이터 소스
KIS (한국투자증권)국내주식 실시간
Frankfurter환율 (무료)
BOK ECOS환율 (한국은행, 선택)
Yahoo Finance해외주식 / fallback
Claude HaikuAI 포트폴리오 분석
엔드포인트 (10개)
GET
/api/exchange/rates
현재 환율 (USD/EUR/JPY/CNY → KRW)
/api/exchange/rates
GET
/api/exchange/history
환율 히스토리 (30일)
/api/exchange/history?pair=USD/KRW&days=30
GET
/api/market/indices
시장 지수 (KOSPI/KOSDAQ/S&P500/NASDAQ)
/api/market/indices
GET
/api/stocks/quote
주식 현재가 — 국내: KIS 실시간, 해외: Yahoo Finance
/api/stocks/quote?tickers=005930.KS,AAPL
GET
/api/stocks/search
종목 검색
/api/stocks/search?q=삼성전자
GET
/api/stocks/fundamentals
기업 펀더멘털 — 국내: KIS(PER/EPS/PBR/시총), 해외: Yahoo
/api/stocks/fundamentals?ticker=005930.KS
POST
/api/alerts/register-token
푸시 토큰 등록 (JWT 인증 필요)
GET
/api/alerts/check
알림 체크 Cron (CRON_SECRET 필요)
POST
/api/ai/analyze
AI 포트폴리오 분석 (JWT 인증, 5회/일)
GET
/api/portfolio/snapshot
포트폴리오 스냅샷 Cron (CRON_SECRET 필요)
⚠ 주의 — 이 서버는 API 전용입니다. 인증이 필요한 엔드포인트는 Expo 앱에서 Bearer JWT를 헤더에 포함해야 합니다. Cron 엔드포인트는 CRON_SECRET 환경변수 설정 필요.