exchangerate.devReddit에서 무료 환율 API를 검색해 봤다면, r/webdev, r/forex, r/node에서 똑같은 질문들이 반복해서 올라오는 것을 봤을 것입니다. 짧게 답하자면: 진짜 무료인 등급이 있고, 첫 호출에는 키가 필요 없으며, 모든 응답이 각 환율이 얼마나 신선한지 알려줍니다. 나머지 질문에도 바로 답하겠습니다.
- 무료 등급은 카드 없이 월 5,000회, 분당 10회 요청을 제공합니다.
- 모든 응답에
source와market_session이 담겨 있어 환율이 얼마나 신선한지 항상 알 수 있습니다. - 10,296개 통화쌍, Plus/Pro의 1999년부터 일별 이력과 기준 통화와 환율로 구성된 JSON 응답 형식 덕분에 대부분의 FX API에서 마이그레이션은 기본 URL 변경 수준으로 끝납니다.
- 환율은 표시와 분석을 위해 발행되는 인디케이티브 참조 데이터이며, 딜링 견적이 아닙니다.
exchangerate.dev는 무엇이고, 무엇이 아닌가
이것은 외환 환율을 위한 개발자용 API입니다: https://api.exchangerate.dev의 깔끔한 REST 엔드포인트를 통해 10,296개 통화쌍을 제공합니다. 모든 응답에 source, market_session, timestamp가 담겨 있어, 뭉뚱그린 "실시간" 표시를 그대로 믿는 대신 코드가 항상 숫자가 얼마나 신선한지 알 수 있습니다.
이것은 거래 체결 기관도, 공식 기록 출처도 아닙니다. 환율은 표시와 분석을 위해 발행되는 인디케이티브 값입니다. 거래를 정산하기 위한 체결 가능한 견적이 필요하다면, 이 API를 포함한 어떤 공개 FX API도 적합한 도구가 아닙니다.
정말로 무료 등급이 있나요?
네, 카드도 필요 없습니다. 모든 플랜은 같은 데이터와 같은 신선도를 제공하며, 호출량과 요청 한도만 다릅니다.
- Free: $0, 월 5,000회, 분당 10회, 15분 지연. 10,296개 통화쌍, 일별 이력 30일, MCP. 카드 불필요.
- Basic: 월 $19, 연 $190. 월 100,000회, 분당 60회. 실시간, 일별 이력 1년
- Plus: 월 $39, 연 $390. 월 300,000회, 분당 120회. 실시간 환율, 전체 일별 이력, WebSocket 1연결 × 10쌍.
- Pro: 월 $89, 연 $890. 월 1,000,000회, 분당 300회. 실시간 환율, 전체 일별 이력, 우선 이메일 지원.
환율은 얼마나 신선한가요?
144개 통화는 거래일에 약 60초마다 갱신됩니다. ECB는 약 30개 통화의 일일 대체값입니다. 모든 응답의 두 필드가 지금 보고 있는 것이 무엇인지 알려줍니다: source는 데이터 분류이고, market_session은 open, weekend, interbank_closed 중 하나입니다.
| 필드 값 | 의미 | 갱신 시점 |
|---|---|---|
| source: live | 참고용 현물 시장 환율 | 장중 (~60초), 거래 주간 |
| source: ecb_daily | 공식 참조 고시가 | 영업일마다 1회 |
| source: market_daily | ECB 고시 없는 저장 종가 | 일일 시장 피드 |
| market_session: weekend | 은행 간 시장 휴장 | 실시간 피드 중단; 참조값은 금요일 값 유지 |
요청 한도는 어떻게 되나요?
분당 Free 10회, Basic 60회, Plus 120회, Pro 300회입니다. 대부분의 앱에서는 환율이 실제로 움직이는 빈도에 맞춘 짧은 클라이언트 측 캐시만으로도 무료 5,000회 한도 안에 여유 있게 머물 수 있습니다. 남은 할당량과 월간 초기화는 GET /v1/account로 확인하세요.
인증은 어떻게 하나요?
bearer 토큰을 사용합니다. 키는 exr_live_ 접두사가 붙으며 Authorization 헤더에 넣습니다. 첫 호출은 IP당 한도가 있는 익명 상태로도 동작하므로 가입 전에 테스트할 수 있습니다. Authorization을 설정할 수 없는 플랫폼을 위해 X-API-Key 헤더도 허용됩니다.
curl https://api.exchangerate.dev/v1/latest/USD \ -H "Authorization: Bearer exr_live_..."이미 다른 FX API를 사용하고 있어요
대부분의 FX API는 비슷한 기준 통화/환율 JSON 형식으로 응답하므로, 마이그레이션은 보통 기본 URL을 바꾸고 매개변수 이름을 확인하는 정도로 끝나며 전면적인 재작성은 필요하지 않습니다. 이 API가 다른 부분은 오직 추가하는 방식뿐입니다: 응답에서 source, market_session, notice가 기존 필드를 지우지 않고 새 필드로 추가됩니다.
상업적으로 사용할 수 있나요?
Free는 눈에 보이는 출처 링크와 함께 상업적으로 표시할 수 있습니다. 유료는 출처 표시가 불필요합니다. 원본 피드를 재배포하는 것은 어떤 등급에서도 허용되지 않습니다. 어떤 플랜이든 환율은 인디케이티브 값입니다: 딜링 견적도 아니고 규제된 공식 기록 출처도 아닙니다. 모든 응답이 notice 필드에서 이를 명시합니다.
LLM 에이전트도 사용할 수 있나요?
네. https://api.exchangerate.dev/v1/mcp에 MCP 서버가 있으며, start_checkout, list_currencies, get_rate, get_usd_index, convert, get_range, search_docs 도구를 Free를 포함한 모든 플랜에서 사용할 수 있습니다. 결제는 사용자의 명시적 확인이 필요합니다. npx @nusantara-ventures/exchangerate-mcp로 설치하면 별도의 도구 코드를 직접 작성하지 않아도 에이전트가 환율을 바로 가져옵니다. 설정 방법은 MCP 안내서에서 확인하세요.
가장 짧은 호출
키도, 의존성도 필요 없습니다:
curl https://api.exchangerate.dev/v1/latest/USD환율과 함께 source, market_session이 담긴 JSON을 받게 되어, 각 값이 정확히 얼마나 신선한지 알 수 있습니다. 키 없는 호출은 15분 지연된 환율을 제공합니다. 무료 키를 발급받으면 한도가 월 5,000회로 늘어나며, 1분이면 충분합니다.
환율은 참조, 분석, 표시를 위해 발행됩니다. 딜링 견적이 아니며 거래 정산에 사용해서는 안 됩니다. 모든 응답이 notice 필드에서 이를 명시합니다.