장중 환율 API
지원 통화쌍의 시각이 기록된 시장 관측값을 REST로 받으세요. 이 USD/JPY 15분 요청에는 Pro API 키를 사용하세요.
USD/JPY 15분 관측값 시험
curl "https://api.exchangerate.dev/v1/timeseries?base=USD&symbols=JPY&interval=15m&from=2026-09-14T12:00:00Z&to=2026-09-14T12:00:00Z" -H "Authorization: Bearer YOUR_API_KEY"{
"result": "success",
"base": "USD",
"symbols": ["JPY"],
"interval": "15m",
"from": "2026-09-14T12:00:00Z",
"to": "2026-09-14T12:00:00Z",
"data": [{
"timestamp": "2026-09-14T12:00:00Z",
"effective_at": { "JPY": "2026-09-14T12:14:58.972181Z" },
"rates": { "JPY": 154.582 },
"source": "live",
"source_type": "market",
"market_session": "open",
"derived_symbols": []
}],
"next_cursor": null,
"has_more": false,
"notice": "Indicative rates, not for settlement."
}2026-09-14 12:00 UTC 구간에 대해 2026-09-15에 확인한 고정 예시입니다. 환율은 참고용입니다. timestamp는 구간 시작, effective_at은 관측 시각입니다.
간격과 이용 가능한 이력
/v1/timeseries는 1m, 5m, 15m, 1h, 4h와 일별 기준 데이터 1d를 지원하며 2h는 지원하지 않습니다. USD를 포함하지 않는 SGD 교차쌍은 4h를 지원하지 않지만 USD/SGD와 역방향은 지원합니다. 시장 데이터 수집은 2026-09-14에 시작했습니다. 1m는 30일간 보관하며 더 큰 간격에는 예정된 만료가 없습니다. 보관 기간만큼의 과거 데이터가 이미 쌓였다는 뜻은 아닙니다.
| interval | 고유 통화쌍 | 요청당 최대 기간 |
|---|---|---|
1m | 221 | 7 d |
5m | 221 | 31 d |
15m | 221 | 93 d |
1h | 221 | 366 d |
4h | 209 | 1830 d |
1d | 10296 | 1830 d |
결측 관측값과 교차쌍
과거 교차쌍은 같은 UTC 구간의 실제 마감 관측을 사용하며 시각 차이가 최대 5초여야 합니다. effective_at은 더 오래된 관측 시각입니다. 누락은 채우지 않으며 아직 열린 구간은 바뀔 수 있습니다. 1d는 전체 카탈로그의 일별 기준 데이터입니다. 표는 통화쌍을 한 번씩 세며 양방향을 지원합니다.
지원하는 기간에 관측이 없으면 HTTP 200과 data: [], has_more: false, next_cursor: null을 반환합니다. 알 수 없는 간격은 unsupported_interval, 지원 범위 밖의 쌍은 unsupported_pair_interval과 rejected_pairs를 반환합니다(HTTP 400). 혼합 요청은 전체가 거부됩니다.
인증과 상업적 사용
데이터 엔드포인트는 익명으로 시험할 수 있습니다. IP당 분당 10회, 시간당 100회입니다. 키를 쓰면 계정 월간 할당량이 적용됩니다.
| 플랜 | 월간 요청 수 | 상업적 사용 |
|---|---|---|
| Free | 5,000 | 크레딧 링크를 표시해 이용 |
| Basic | 100,000 | 예 |
| Plus | 300,000 | 예 |
| Pro | 1,000,000 | 예 |