> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sajuapi.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 오늘의 사주 운 랭킹

> 오늘 날짜 기준 일간별 운세 점수 랭킹

오늘 날짜의 천간(天干) 기운과 각 일간(日干)의 상호작용을 계산하여 운세 점수 랭킹을 제공합니다.

## 요청

<ParamField query="date" type="string">
  조회 날짜 (YYYY-MM-DD, 기본값: 오늘)
</ParamField>

<ParamField query="dayMaster" type="string">
  사용자의 일간 (선택, 내 순위 표시용)
</ParamField>

## 응답

```json theme={null}
{
  "success": true,
  "data": {
    "date": "2026-01-20",
    "rankings": [
      { "rank": 1, "dayMaster": "丙", "name": "병화", "element": "火", "emoji": "🔥", "score": 92 },
      { "rank": 2, "dayMaster": "甲", "name": "갑목", "element": "木", "emoji": "🌳", "score": 88 },
      { "rank": 3, "dayMaster": "壬", "name": "임수", "element": "水", "emoji": "💧", "score": 85 },
      { "rank": 4, "dayMaster": "庚", "name": "경금", "element": "金", "emoji": "⚔️", "score": 82 },
      { "rank": 5, "dayMaster": "戊", "name": "무토", "element": "土", "emoji": "🏔️", "score": 78 },
      { "rank": 6, "dayMaster": "乙", "name": "을목", "element": "木", "emoji": "🌿", "score": 75 },
      { "rank": 7, "dayMaster": "丁", "name": "정화", "element": "火", "emoji": "🕯️", "score": 72 },
      { "rank": 8, "dayMaster": "辛", "name": "신금", "element": "金", "emoji": "💎", "score": 68 },
      { "rank": 9, "dayMaster": "己", "name": "기토", "element": "土", "emoji": "🌾", "score": 65 },
      { "rank": 10, "dayMaster": "癸", "name": "계수", "element": "水", "emoji": "🌊", "score": 62 }
    ],
    "myRank": {
      "rank": 4,
      "dayMaster": "庚",
      "score": 82
    },
    "todayElement": {
      "stem": "甲",
      "element": "木",
      "description": "오늘은 갑목(甲木) 기운이 지배하는 날입니다."
    }
  }
}
```

## 점수 계산 원리

랭킹은 오행 상생/상극 관계를 기반으로 계산됩니다:

| 관계     | 점수 영향 | 예시                   |
| ------ | ----- | -------------------- |
| 상생 (生) | +20   | 오늘 木, 나 火 → 목생화      |
| 비화 (比) | +10   | 오늘 木, 나 木 → 동일 오행    |
| 설기 (泄) | -5    | 오늘 木, 나 土 → 목극토 (당함) |
| 상극 (克) | -15   | 오늘 金, 나 木 → 금극목      |

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.sajuapi.dev/v1/analytics/fortune-ranking?dayMaster=庚" \
    -H "X-API-Key: your-api-key"
  ```
</RequestExample>