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일간 보관하며 더 큰 간격에는 예정된 만료가 없습니다. 보관 기간만큼의 과거 데이터가 이미 쌓였다는 뜻은 아닙니다. 1m부터 1h까지 장중 이력은 고유 통화쌍 221개를 지원합니다. USD 통화쌍 143개와 교차쌍 78개입니다.
| 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). 혼합 요청은 전체가 거부됩니다.
인증과 상업적 사용
Plus는 최근 30일의 1h와 4h를, Pro는 1m를 최근 30일간, 5m부터 4h까지는 전체 장중 이력을 제공합니다. 두 플랜 모두 키가 필요합니다.
데이터 엔드포인트는 익명으로 시험할 수 있습니다. IP당 분당 10회, 시간당 100회입니다. 키를 쓰면 계정 월간 할당량이 적용됩니다. Free 가격은 15분 지연됩니다(X-Price-Delay-Seconds: 900 헤더).
| 플랜 | 월간 요청 수 | 상업적 사용 |
|---|---|---|
| Free | 5,000 | 크레딧 링크를 표시해 이용 |
| Basic | 100,000 | 예 |
| Plus | 300,000 | 예 |
| Pro | 1,000,000 | 예 |