"""외화 → 원화 날짜별 환율(2026-10-16 사용자 요청: 메타 USD 광고 계정 — "그날 환율로 원화 환산"). 출처: Frankfurter(https://frankfurter.dev, API 키 없음) v2 `GET /v2/rates?base=USD"es=KRW&from=&to=` — 여러 나라 중앙은행 고시 환율을 합친 값(blended)이고 주말·공휴일 포함 매일 있다. 서울외국환중개 매매기준율과는 조금(보통 0.5% 안쪽) 다를 수 있다. 응답: [{"date": "2026-10-01", "base": "USD", "quote": "KRW", "rate": 1357.92}, …] 그날 값이 없으면(오늘처럼 아직 안 나온 날 등) 그 앞 가장 가까운 날 값을 쓴다(LOOKBACK_DAYS 안). 지난 날(2일 이상 지난) 환율은 프로세스 안에 기억해 30분마다 도는 자동 업데이트가 같은 날을 다시 묻지 않게 한다. """ from __future__ import annotations import threading from datetime import date, timedelta from decimal import Decimal, InvalidOperation import httpx from app.timezone import today_kst FX_API = "https://api.frankfurter.dev/v2/rates" SOURCE_LABEL = "Frankfurter(중앙은행 고시 환율 종합)" LOOKBACK_DAYS = 10 # 그날 환율이 없으면 이만큼 앞까지 찾는다 _SETTLED_AFTER = 2 # 오늘에서 이만큼 지난 날 환율만 기억(최근 값은 나중에 고시될 수 있음) _cache_lock = threading.Lock() _cache: dict[tuple[str, date], Decimal] = {} class FxError(Exception): """환율을 가져오지 못함 — 문구는 화면에 그대로 보인다.""" def krw_rates(client: httpx.Client, currency: str, start: date, end: date, *, today: date | None = None) -> dict[date, Decimal]: """start~end(양 끝 포함) 날마다 1 {currency} = ? 원. 하루라도 못 정하면 FxError(일부만 환산해 저장하지 않게).""" cur = (currency or "").upper() if cur == "KRW": return {start + timedelta(days=i): Decimal(1) for i in range((end - start).days + 1)} days = [start + timedelta(days=i) for i in range((end - start).days + 1)] with _cache_lock: known = {d: _cache[(cur, d)] for d in days if (cur, d) in _cache} if len(known) == len(days): return known fetched = _fetch(client, cur, start - timedelta(days=LOOKBACK_DAYS), end) today = today or today_kst() out: dict[date, Decimal] = {} for d in days: rate = next((fetched[d - timedelta(days=k)] for k in range(LOOKBACK_DAYS + 1) if d - timedelta(days=k) in fetched), None) if rate is None: raise FxError(f"{d.isoformat()} 의 {cur}→KRW 환율을 찾지 못했습니다({SOURCE_LABEL}).") out[d] = rate with _cache_lock: for d, rate in out.items(): if d in fetched and (today - d).days >= _SETTLED_AFTER: _cache[(cur, d)] = rate return out def _fetch(client: httpx.Client, cur: str, start: date, end: date) -> dict[date, Decimal]: try: resp = client.get(FX_API, params={"base": cur, "quotes": "KRW", "from": start.isoformat(), "to": end.isoformat()}) except httpx.HTTPError as exc: raise FxError(f"환율 서버({SOURCE_LABEL})에 연결하지 못했습니다({type(exc).__name__}).") from None if resp.status_code != 200: try: msg = str((resp.json() or {}).get("message") or "") except ValueError: msg = "" raise FxError(f"환율을 가져오지 못했습니다(HTTP {resp.status_code}{': ' + msg[:120] if msg else ''}).") try: rows = resp.json() except ValueError: raise FxError("환율 서버 응답을 읽을 수 없습니다.") from None out: dict[date, Decimal] = {} for r in rows if isinstance(rows, list) else []: if not isinstance(r, dict) or str(r.get("quote") or "").upper() != "KRW": continue try: d = date.fromisoformat(str(r.get("date"))) rate = Decimal(str(r.get("rate"))) except (ValueError, InvalidOperation): continue if rate > 0: out[d] = rate return out def clear_cache() -> None: """테스트용.""" with _cache_lock: _cache.clear()