Base URL

Endpoints

Examples

# 최신 금리 조회
curl https://rate.hwanmoo.kr/api/latest

# 최근 7일 이력
curl https://rate.hwanmoo.kr/api/history?days=7

# 수동 동기화
curl -X POST https://rate.hwanmoo.kr/api/sync

# RSS 피드
curl https://rate.hwanmoo.kr/api/rss

Response: GET /api/latest

{
  "synced": {
    "id": 10,
    "run_type": "manual",
    "status": "success",
    "started_at": "2026-03-10T16:40:05.000Z",
    "finished_at": "2026-03-10T16:40:06.000Z",
    "message": "inserted 6 rows"
  },
  "items": [
    {
      "product_code": "toss:사장님신용대출",
      "product_name": "토스뱅크 사장님신용대출",
      "source_url": "https://www.tossbank.com/product-service/loans/soho",
      "min_rate": "4.43",
      "max_rate": "15.00",
      "base_date": "2026-03-10T00:00:00.000Z",
      "captured_at": "2026-03-10T16:40:06.000Z"
    },
    {
      "product_code": "toss:사장님보증서대출",
      "product_name": "토스뱅크 사장님보증서대출",
      "min_rate": "1.04",
      "max_rate": "8.67",
      ...
    },
    // ... 총 6개 상품
  ]
}

Response: GET /api/history?days=7

{
  "days": 7,
  "items": [
    {
      "product_code": "toss:사장님신용대출",
      "product_name": "토스뱅크 사장님신용대출",
      "day": "2026-03-10",
      "min_rate": "4.430000",
      "max_rate": "15.000000"
    },
    {
      "product_code": "kakao:sohoLoans",
      "product_name": "카카오뱅크 개인사업자 신용대출",
      "day": "2026-03-10",
      "min_rate": "3.890000",
      "max_rate": "10.840000"
    },
    // ... 일별 × 상품별 집계
  ]
}

Response: POST /api/sync (성공)

{ "ok": true, "count": 6, "runId": 10 }

Response: POST /api/sync (쿨다운)

{
  "ok": false,
  "message": "수동 동기화는 5분에 한 번 가능합니다.",
  "retryAfterMinutes": 3
}

Notes

개요

사용 방법

# RSS 리더에 아래 URL 등록
https://rate.hwanmoo.kr/api/rss

# curl로 직접 확인
curl https://rate.hwanmoo.kr/api/rss

# Feedly, Inoreader 등 RSS 리더 앱에서도 동일 URL 사용

응답 예시

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
    <title>Loan Rate Service Feed</title>
    <link>https://rate.hwanmoo.kr</link>
    <description>토스뱅크/카카오뱅크 대출 금리 최신 피드</description>
    <language>ko-kr</language>
    <lastBuildDate>Tue, 10 Mar 2026 07:40:06 GMT</lastBuildDate>

    <item>
      <title>토스뱅크 사장님신용대출 4.43% ~ 15.00%</title>
      <description>최저 4.43% / 최고 15.00%</description>
      <link>https://www.tossbank.com/product-service/loans/soho</link>
      <pubDate>Tue, 10 Mar 2026 07:40:06 GMT</pubDate>
    </item>

    <item>
      <title>카카오뱅크 개인사업자 신용대출 3.89% ~ 10.84%</title>
      <description>최저 3.89% / 최고 10.84%</description>
      <link>https://www.kakaobank.com/products/sohoLoans</link>
      <pubDate>Tue, 10 Mar 2026 07:40:06 GMT</pubDate>
    </item>

    <!-- ... 총 6개 item -->
  </channel>
</rss>