API 레퍼런스 | exchangerate.dev

인증과 제한

데이터 엔드포인트는 익명으로 시험할 수 있습니다. IP당 분당 12회, 시간당 100회입니다. 키를 쓰면 계정 월간 할당량이 적용됩니다.

bash · header

Authorization: Bearer YOUR_KEY
X-RateLimit-Remaining: 9999
X-RateLimit-Reset: 1788220800

데이터 최신성을 설명하는 필드

`source`는 출처 유형, `market_session`은 시장 상태, `data_updated_at`은 값이 기록된 시각입니다. 세 필드를 모두 저장하세요.

엔드포인트

GET /v1/latest[/{BASE}]현재 환율. 전체 또는 symbols로 필터링.

GET /v1/{YYYY-MM-DD}[/{BASE}]날짜와 기준 통화의 과거 스냅샷.

GET /v1/convert/{FROM}/{TO}[/{AMOUNT}] · POST /v1/convert금액 환산. 단일 GET 또는 일괄 POST.

GET /v1/rate/{slug}slug로 단일 통화쌍 조회.

GET /v1/range페이지 처리와 다운로드를 지원하는 일일 시계열.

GET /v1/currencies지원 통화 목록. 매개변수 없음.

GET /v1/account계정, 플랜, 활성 키, 이번 달 사용량.

오류

모든 오류는 `{ result: "error", code, message }` 형식입니다. 429에는 `Retry-After`가 포함되며 출처 장애 때 가짜 데이터로 대체하지 않습니다.

json · error

{
  "result": "error",
  "code": "missing_parameter",
  "message": "missing required parameter: symbols"
}

English complete field-by-field reference →

사용 중인 스택에서 사용

같은 요청을 curl, Python, JavaScript에서 실행할 수 있습니다. 평가에는 API 키가 필요하지 않습니다.

퀵스타트 열기 →

curl -fsS --max-time 10 "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"

from urllib.request import Request, urlopen
import json

request = Request("https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP")
with urlopen(request, timeout=10) as response:
    data = json.load(response)

print(data["rates"]["EUR"])

const response = await fetch("https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP", {
  signal: AbortSignal.timeout(10_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data.rates.EUR);

응답 예시

{
  "result": "success",
  "base": "USD",
  "source": "live",
  "sources": {
    "EUR": "live",
    "GBP": "live"
  },
  "market_session": "open",
  "timestamp": "2026-06-15T12:00:00Z",
  "data_updated_at": "2026-06-15T12:00:00Z",
  "effective_at": {
    "EUR": "2026-06-15T12:00:00Z",
    "GBP": "2026-06-15T12:00:00Z"
  },
  "rates": {
    "EUR": 0.86207,
    "GBP": 0.74627
  },
  "derived_symbols": [],
  "notice": "Indicative rates, not for settlement."
}

rates.EUR은 1 USD에 해당하는 EUR 금액입니다. effective_at.EUR은 관측 시각이고 sources.EUR은 출처 등급입니다. 값과 시각은 예시입니다.

JSON 응답 열기 ↗API 참조 →