exchangerate.dev는 통화 환율을 제공하는 REST API입니다. /v1/latest/{BASE}로 KRW의 달러 대비 최신 환율을 조회하거나 날짜를 지정해 과거 환율을 확인하세요. Free 플랜은 월 5,000회 요청을 제공하며, 아래 요청은 모두 키 없이 실행할 수 있습니다.
API가 반환하는 데이터
모든 엔드포인트는 HTTPS를 통해 JSON을 반환합니다. 아래 표에서 각 엔드포인트의 응답 내용과 이용 가능한 최소 플랜을 확인하세요.
| 엔드포인트 | 응답 내용 | 이용 가능한 최소 플랜 |
|---|---|---|
/v1/latest/{BASE} | 선택한 기준 통화의 최신 환율 | Free |
/v1/convert/{FROM}/{TO}/{AMT} | 지정 금액의 통화 변환 | Free |
/v1/{YYYY-MM-DD}/{BASE} | 지정일의 환율(Free는 최근 30일) | Free |
/v1/timeseries | 장중 봉 데이터 | Plus |
/v1/stream | WebSocket으로 실시간 환율 전송 | Plus |
/v1/currencies | 지원하는 모든 통화 | Free |
첫 요청 보내기
이 요청은 KRW 및 다른 두 통화의 달러 대비 환율을 조회합니다. 서버에서 Authorization: Bearer 헤더로 키를 보내세요. 키 없이도 익명 요청 한도 안에서 같은 요청을 실행할 수 있습니다.
curl "https://api.exchangerate.dev/v1/latest/USD?symbols=KRW,JPY,CNY" \ -H "Authorization: Bearer $EXCHANGERATE_API_KEY"const res = await fetch("https://api.exchangerate.dev/v1/latest/USD?symbols=KRW,JPY,CNY", { headers: { Authorization: `Bearer ${process.env.EXCHANGERATE_API_KEY}` },})const data = await res.json()if (data.result !== "success") throw new Error(data.code)import os, requestsres = requests.get( "https://api.exchangerate.dev/v1/latest/USD?symbols=KRW,JPY,CNY", headers={"Authorization": f"Bearer {os.environ['EXCHANGERATE_API_KEY']}"}, timeout=10,)data = res.json()if data["result"] != "success": raise RuntimeError(data["code"])응답 살펴보기
rates에는 요청한 각 통화의 base 대비 환율이 담깁니다. timestamp는 UTC 기준 응답 시각이며, stale은 각 통화의 환율이 예상보다 오래되었는지 나타냅니다. 아래는 2026년 10월 19일에 수집한 예시로, 현재 환율이 아닙니다.
{ "result": "success", "base": "USD", "source": "live", "sources": { "KRW": "live", "JPY": "live", "CNY": "live" }, "market_session": "open", "timestamp": "2026-10-19T13:21:59Z", "data_updated_at": "2026-10-19T13:05:59Z", "effective_at": { "KRW": "2026-10-19T13:05:59Z", "JPY": "2026-10-19T13:05:59Z", "CNY": "2026-10-19T13:05:59Z" }, "rates": { "KRW": 1329.51, "JPY": 158.308, "CNY": 6.68522 }, "stale": { "KRW": false, "JPY": false, "CNY": false }, "derived_symbols": [], "notice": "Indicative rates, not for settlement."}플랜 비교
모든 플랜에서 최신 환율, 통화 변환, 이력을 제공합니다. 유료 플랜은 실시간 환율, 더 긴 이력, 장중 봉 데이터, 스트리밍, 웹훅도 제공합니다. 자세한 내용은 가격 안내에서 확인하세요.
| 플랜 | Free | Basic | Plus | Pro |
|---|---|---|---|---|
| 월 가격(미국 달러) | $0 | $19 | $39 | $89 |
| 월 요청 수 | 5,000 | 100,000 | 300,000 | 1,000,000 |
| 분당 요청 수 | 10 | 60 | 120 | 300 |
| 환율 | 15분 지연 | 실시간 | 실시간 | 실시간 |
| 일별 이력 | 30일 | 1년 | 전체, 1999년부터 | 전체, 1999년부터 |
| 장중 봉 데이터 | 불가 | 불가 | 가능 | 가능 |
| WebSocket 스트리밍 | 불가 | 불가 | 가능 | 가능 |
| 웹훅 엔드포인트 | 0 | 0 | 5 | 25 |
| MCP 서버 | 가능 | 가능 | 가능 | 가능 |
| 상업적 이용 | 가능, 링크로 출처 표시 | 가능 | 가능 | 가능 |
키 없이 체험하기
데이터 엔드포인트는 키 없이도 Free 플랜 데이터를 반환합니다. IP 주소별 한도는 분당 10회, 시간당 100회입니다. 한도를 넘으면 API는 429와 함께 어떤 한도를 초과했는지 명시한 JSON 본문을 반환합니다.
다음 단계
문서에서 각 엔드포인트와 매개변수를 확인한 뒤, 무료 키를 받아 자신의 요청 한도를 사용하세요.