exchangerate.dev하루 요청하기
주말이나 휴장일에는 가장 최근 공개 fixing을 반환하고 is_forward_filled가 true가 됩니다. 관측값을 새로 만들지는 않습니다.
curl "https://api.exchangerate.dev/v1/2024-01-15/EUR?symbols=USD,GBP" \ -H "Authorization: Bearer YOUR_API_KEY"날짜 범위 요청하기
symbols, start_date, end_date를 보냅니다. JSON은 페이지당 최대 366행이며 has_more가 true면 next_cursor를 다음 호출에 전달합니다.
curl "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-06-30" \ -H "Authorization: Bearer YOUR_API_KEY"CSV 또는 Parquet 다운로드
format=csv 또는 format=parquet를 추가합니다. 파일에는 요청한 전체 구간이 들어가며 JSON 커서를 쓰지 않습니다.
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" \ -H "Authorization: Bearer YOUR_API_KEY" \ --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일간 보관하며 더 큰 간격에는 예정된 만료가 없습니다. 보관 기간만큼의 과거 데이터가 이미 쌓였다는 뜻은 아닙니다. 1m부터 1h까지 장중 이력은 고유 통화쌍 221개를 지원합니다. USD 통화쌍 143개와 교차쌍 78개입니다.
과거 교차쌍은 같은 UTC 구간의 실제 마감 관측을 사용하며 시각 차이가 최대 5초여야 합니다. effective_at은 더 오래된 관측 시각입니다. 누락은 채우지 않으며 아직 열린 구간은 바뀔 수 있습니다. 1d는 전체 카탈로그의 일별 기준 데이터입니다. 표는 통화쌍을 한 번씩 세며 양방향을 지원합니다.
| interval | 고유 통화쌍 |
|---|---|
1m | 221 |
5m | 221 |
15m | 221 |
1h | 221 |
4h | 209 |
1d | 10296 |
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" \ -H "Authorization: Bearer YOUR_API_KEY"지원하는 기간에 관측이 없으면 HTTP 200과 data: [], has_more: false, next_cursor: null을 반환합니다. 알 수 없는 간격은 unsupported_interval, 지원 범위 밖의 쌍은 unsupported_pair_interval과 rejected_pairs를 반환합니다(HTTP 400). 혼합 요청은 전체가 거부됩니다.