문서 /

과거 환율

하루 값은 날짜 경로, 일일 시계열은 `/v1/range`를 사용합니다. 공개 데이터는 1999-01-04부터 시작합니다.

하루 요청하기

주말이나 휴장일에는 가장 최근 공개 fixing을 반환하고 `is_forward_filled`가 true가 됩니다. 관측값을 새로 만들지는 않습니다.

bash · one date
curl "https://api.exchangerate.dev/v1/2024-01-15/EUR?symbols=USD,GBP"

날짜 범위 요청하기

`symbols`, `start_date`, `end_date`를 보냅니다. JSON은 페이지당 최대 366행이며 `has_more`가 true면 `next_cursor`를 다음 호출에 전달합니다.

bash · date range
curl "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-06-30"

CSV 또는 Parquet 다운로드

`format=csv` 또는 `format=parquet`를 추가합니다. 파일에는 요청한 전체 구간이 들어가며 JSON 커서를 쓰지 않습니다.

bash · CSV
curl -L "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-12-31&format=csv"   --output usd-rates-2024.csv

출처를 값과 함께 저장하기

각 관측값에 `source`, `is_forward_filled`, `derived_symbols`를 보관하면 나중에 값을 설명할 수 있습니다.

source · is_forward_filled · derived_symbols

인트라데이 시계열과 지원 범위

/v1/timeseries는 1m, 5m, 15m, 1h, 4h와 일별 기준 데이터 1d를 지원하며 2h는 지원하지 않습니다. USD를 포함하지 않는 SGD 교차쌍은 4h를 지원하지 않지만 USD/SGD와 역방향은 지원합니다. 시장 데이터 수집은 2026-09-14에 시작했습니다. 1m는 30일간 보관하며 더 큰 간격에는 예정된 만료가 없습니다. 보관 기간만큼의 과거 데이터가 이미 쌓였다는 뜻은 아닙니다.

과거 교차쌍은 같은 UTC 구간의 실제 마감 관측을 사용하며 시각 차이가 최대 5초여야 합니다. effective_at은 더 오래된 관측 시각입니다. 누락은 채우지 않으며 아직 열린 구간은 바뀔 수 있습니다. 1d는 전체 카탈로그의 일별 기준 데이터입니다. 표는 통화쌍을 한 번씩 세며 양방향을 지원합니다.

interval고유 통화쌍
1m91
5m91
15m91
1h91
4h79
1d465
curl · EUR/JPY · 15m
curl "https://api.exchangerate.dev/v1/timeseries?base=EUR&symbols=JPY&interval=15m&from=2026-09-14T12:00:00Z&to=2026-09-14T13:00:00Z"

지원하는 기간에 관측이 없으면 HTTP 200과 data: [], has_more: false, next_cursor: null을 반환합니다. 알 수 없는 간격은 unsupported_interval, 지원 범위 밖의 쌍은 unsupported_pair_interval과 rejected_pairs를 반환합니다(HTTP 400). 혼합 요청은 전체가 거부됩니다.

AUD, CAD, CHF, EUR, GBP, JPY, MXN, NOK, NZD, PLN, SEK, SGD, USD, ZAR

지원 범위와 제한 상세

장중 환율 API