Skip to main content
v1 API는 클라이언트 앱에서 사주 운세 위젯을 쉽게 구현할 수 있도록 설계된 API입니다.

​
특징

  • 위젯 친화적: 각 위젯에 필요한 데이터만 반환하는 엔드포인트
  • AI 생성 콘텐츠: BAML 기반 AI 운세 생성 (내부 구현)
  • 분석 데이터: 플랫폼 집계 데이터 기반 인사이트
  • API 키 인증: 모든 요청에 API 키 필요
  • 다중 모델 지원: Haiku, Sonnet, GPT-4o, Gemini 선택 가능

​
API 카테고리

​
1. 운세 (AI 생성)

AI가 생성하는 운세 콘텐츠입니다. 내부적으로 BAML을 사용합니다.
엔드포인트설명위젯
POST /v1/fortunes/daily일일 운세 전체AICharacterCard, ActionItems, InvestmentAdvice
POST /v1/fortunes/daily-stream일일 운세 스트리밍 (SSE)프로그레시브 로딩
POST /v1/fortunes/weekly주간 운세날짜 네비게이션
GET /v1/fortunes/character캐릭터만 조회AICharacterCard
GET /v1/fortunes/tendency투자 성향만 조회StatsCards
GET /v1/fortunes/radar레이더 차트 데이터RadarChart

​
2. 분석 (Analytics)

플랫폼 데이터를 집계한 인사이트입니다. AI 생성이 아닌 실제 데이터 기반입니다.
엔드포인트설명위젯
GET /v1/analytics/popular-coins같은 일간 선호 코인PopularCoinsWidget
GET /v1/analytics/comparison내 사주 vs 전체 평균ComparisonWidget
GET /v1/analytics/fortune-ranking오늘의 사주 운 랭킹FortuneRankingWidget
GET /v1/analytics/trading-styles사주별 거래 스타일TradingStyleWidget
GET /v1/analytics/portfolio-breakdown사주별 포트폴리오PortfolioBreakdownWidget
GET /v1/analytics/saju-twin사주 쌍둥이 인사이트SajuTwinWidget

​
3. 계산

사주 계산 및 궁합 분석입니다.
엔드포인트설명
POST /v1/calculations/saju생년월일로 사주 계산
POST /v1/calculations/compatibility두 사주 간 궁합 계산

​
캐싱 전략

데이터 타입캐시 기간설명
Character30일사주 기반, 변하지 않음
Tendency30일사주 기반, 변하지 않음
Radar30일사주 기반, 변하지 않음
Daily Fortune24시간일일 운세는 매일 갱신
Weekly Fortune7일주간 단위 갱신
Analytics1시간실시간 데이터 반영

​
모델별 비용

모델비용 (호출당)특징
Haiku$0.013빠름, 저렴함 (기본값)
Sonnet$0.066균형 잡힌 품질
GPT-4o$0.050OpenAI 모델
Gemini$0.010Google 모델, 최저가

​
위젯 매핑

┌──────────────────────────────────────────────────────────────┐
│ Tab 1: 오늘의 운세                                            │
├──────────────────────────────────────────────────────────────┤
│ AICharacterCard    ← POST /v1/fortunes/daily (character)     │
│ ActionItems        ← POST /v1/fortunes/daily (todayFortune)  │
│ InvestmentAdvice   ← POST /v1/fortunes/daily (investment)    │
├──────────────────────────────────────────────────────────────┤
│ Tab 2: 사주 인사이트                                          │
├──────────────────────────────────────────────────────────────┤
│ StatsCards         ← GET /v1/fortunes/tendency               │
│ PopularCoinsWidget ← GET /v1/analytics/popular-coins         │
│ ComparisonWidget   ← GET /v1/analytics/comparison            │
│ FortuneRankingWidget ← GET /v1/analytics/fortune-ranking     │
└──────────────────────────────────────────────────────────────┘
Enterprise 기능(프로필 관리, 웹훅, 암호화 등)이 필요하시면 v2 API를 참고하세요.