LUME EXCHANGE RATES / API REFERENCE

API 문서

현재 설정된 데이터 출처는 외부 환율 데이터 공급사입니다. 최신 환율 응답에는 출처와 공급사 발표시각을 담고, 실제 응답에 존재하는 통화 코드를 제공합니다. 제공 가능한 통화는 최신 데이터에 맞춰 갱신됩니다.

Base URLhttps://lumeexchangerates.com

서비스 개요

Lume Exchange Rates는 환율 비교, 통화 변환, 과거 추이를 한곳에서 확인할 수 있는 글로벌 환율 서비스입니다. 여행 예산을 세우거나 해외 가격을 비교할 때, 또는 제품에 환율을 연결할 때 필요한 두 통화를 직접 선택해 살펴보세요.

현재 설정된 데이터 출처는 외부 환율 데이터 공급사입니다. 최신 환율 응답에는 출처와 공급사 발표시각을 담고, 실제 응답에 존재하는 통화 코드를 제공합니다. 제공 가능한 통화는 최신 데이터에 맞춰 갱신됩니다.

HTTPSJSONUTF-8GET / POSTUTC

빠른 시작

먼저 지원 통화를 조회한 뒤, anchor와 targets를 지정해 필요한 환율만 요청하세요. 요청과 응답의 필드명은 언어를 바꾸어도 동일합니다.

cURL
curl --request GET 'https://lumeexchangerates.com/v1/quotes?anchor=USD&targets=EUR,JPY'
JavaScript · browser
const response = await fetch('/v1/quotes?anchor=USD&targets=EUR,JPY', {
  credentials: 'same-origin'
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { meta, anchor, data } = await response.json();
console.log(anchor, meta.as_of, data);

이 예시는 사이트 내부의 같은 출처에서 실행합니다. 비공개 사이트의 cURL·서버 요청은 사이트 접근 권한이 필요하며, URL만으로 로그인 정책을 우회할 수 없습니다.

접근과 인증

현재 호스팅 미리보기의 접근은 사이트 공개 범위와 브라우저 로그인 세션에 따릅니다. 고객별 API 키 발급, 고객용 Bearer 인증, 공개 교차 출처 API는 아직 제공하지 않습니다. 공급사 App ID는 서버에서 보관하며 Lume Exchange Rates 요청에 넣지 않습니다.

파라미터자료형설명
Base URLURLhttps://lumeexchangerates.com
Content-Typeheaderapplication/json
Customer API key—현재 호스팅 미리보기는 로그인된 브라우저 세션을 사용합니다. 고객별 API 키는 아직 발급하지 않습니다.
Provider App IDserver secretOPEN_EXCHANGE_RATES_APP_ID
CORSsame-origin교차 출처 허용 헤더를 제공하지 않습니다.

공급사 Authorization: Token 헤더는 Lume Exchange Rates 서버가 외부 환율 데이터 공급사에 요청할 때만 사용합니다. 고객용 인증 방식으로 복사하지 마세요. 로그인이나 접근 제한 응답은 게이트웨이에서 HTML 또는 리디렉션으로 올 수 있으므로 HTTP 상태와 Content-Type을 먼저 확인하세요.

엔드포인트

MethodPath설명
GET/v1/currencies현재 환율이 있는 모든 코드와 공급사 통화명을 반환합니다. 제공 가능한 대체 통화와 귀금속도 포함됩니다.
GET/v1/quotes기준 통화. 기본값 USD이며 현재 공급사가 지원하는 모든 코드를 사용할 수 있습니다.
GET/v1/exchange변환할 금액. 0 이상의 숫자를 입력합니다.
GET/v1/history과거 날짜 환율은 /v1/history, 기간별 시계열은 /v1/series로 조회합니다.
GET/v1/series과거 날짜 환율은 /v1/history, 기간별 시계열은 /v1/series로 조회합니다.
GET/v1/candlesOHLC
GET/v1/capabilities제공 범위
GET/api/rates/latest최신 발표환율
GET/api/currencies통화
GET/api/rates/history환율 차트
GET/api/rates/previous직전 UTC 날짜
POST/api/convert환율 계산기

/v1은 간결한 조회 API입니다. /api는 웹 화면에서 사용하는 최신 시세·이력·변환 계약입니다. 두 경로의 응답 구조와 기본값은 다르므로 혼용하지 마세요.

GET /v1/currencies

현재 환율이 있는 모든 코드와 공급사 통화명을 반환합니다. 제공 가능한 대체 통화와 귀금속도 포함됩니다.

파라미터: —

cURL
curl --request GET 'https://lumeexchangerates.com/v1/currencies'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "meta": {
    "mode": "provider",
    "source": "외부 환율 데이터 공급사",
    "source_url": "https://openexchangerates.org/",
    "as_of": "2026-01-01T00:00:00.000Z",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "currency_count": 3,
    "includes_alternative": true,
    "refresh_interval_seconds": 300,
    "provider_plan": "Unlimited",
    "notice": "Illustrative response; not live rates."
  },
  "data": [
    {
      "code": "USD",
      "name": "United States Dollar"
    },
    {
      "code": "EUR",
      "name": "Euro"
    },
    {
      "code": "JPY",
      "name": "Japanese Yen"
    }
  ]
}
파라미터자료형설명
data[].codestring대문자 통화 코드. 대체 자산은 3자를 초과하거나 밑줄이 포함될 수 있습니다.
data[].namestring공급사 이름. 이름이 없으면 코드 자체를 반환합니다.

GET /v1/quotes

기준 통화. 기본값 USD이며 현재 공급사가 지원하는 모든 코드를 사용할 수 있습니다.

파라미터자료형필수기본값설명
anchorstring선택USD기준 통화. 기본값 USD이며 현재 공급사가 지원하는 모든 코드를 사용할 수 있습니다.
targetsstring선택전체쉼표로 구분한 대상 통화 코드. 생략하면 지원되는 모든 통화를 반환합니다.
cURL
curl --request GET 'https://lumeexchangerates.com/v1/quotes?anchor=USD&targets=EUR,JPY'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "meta": {
    "mode": "provider",
    "source": "외부 환율 데이터 공급사",
    "source_url": "https://openexchangerates.org/",
    "as_of": "2026-01-01T00:00:00.000Z",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "currency_count": 3,
    "includes_alternative": true,
    "refresh_interval_seconds": 300,
    "provider_plan": "Unlimited",
    "notice": "Illustrative response; not live rates."
  },
  "anchor": "USD",
  "data": [
    {
      "currency": "EUR",
      "value": 0.9
    },
    {
      "currency": "JPY",
      "value": 150
    }
  ]
}

예: /v1/quotes?anchor=EUR&targets=USD,JPY. value는 기준 통화 1단위당 대상 통화 값입니다. 중복 targets는 제거되며 빈 코드, 소문자, 현재 시세에 없는 코드는 400을 반환합니다.

파라미터자료형설명
anchorstring기준 통화. 기본값 USD이며 현재 공급사가 지원하는 모든 코드를 사용할 수 있습니다.
data[].currencystring비교 통화
data[].valuenumberrates[currency] / rates[anchor]

GET /v1/exchange

변환할 금액. 0 이상의 숫자를 입력합니다.

파라미터자료형필수기본값설명
fromstring선택USD변환 전 통화 코드. 기본값 USD.
tostring선택KRW변환할 대상 통화 코드. 기본값 KRW.
quantitynumber선택1변환할 금액. 0 이상의 숫자를 입력합니다.
cURL
curl --request GET 'https://lumeexchangerates.com/v1/exchange?from=USD&to=EUR&quantity=100'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "meta": {
    "mode": "provider",
    "source": "외부 환율 데이터 공급사",
    "source_url": "https://openexchangerates.org/",
    "as_of": "2026-01-01T00:00:00.000Z",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "currency_count": 3,
    "includes_alternative": true,
    "refresh_interval_seconds": 300,
    "provider_plan": "Unlimited",
    "notice": "Illustrative response; not live rates."
  },
  "data": {
    "from": "USD",
    "to": "EUR",
    "quantity": 100,
    "rate": 0.9,
    "result": 90
  }
}

예: /v1/exchange?from=USD&to=EUR&quantity=100. 전 세계 사용자의 혼동을 피하려면 from과 to를 항상 명시하세요. 이 기존 GET 경로의 to 기본값은 KRW입니다. 빈 값, 음수, NaN, 무한대 또는 계산 결과 오버플로는 400입니다.

파라미터자료형설명
data.ratenumberrates[to] / rates[from]
data.resultnumberquantity × rate

GET /api/rates/latest

최신 발표환율

파라미터: —

cURL
curl --request GET 'https://lumeexchangerates.com/api/rates/latest'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "meta": {
    "provider": "외부 환율 데이터 공급사",
    "kind": "latest_published",
    "provider_timestamp": 1767225600,
    "published_at": "2026-01-01T00:00:00.000Z",
    "expected_interval_seconds": 300,
    "lag_seconds": 5,
    "stale": false,
    "timezone": "Asia/Seoul",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "persistent_storage": false
  },
  "data": {
    "base": "USD",
    "rates": {
      "USD": 1,
      "EUR": 0.9,
      "JPY": 150
    }
  }
}
파라미터자료형설명
data.basestringUSD
data.ratesobjectUSD 기준 전체 환율. 존재 여부는 최신 응답으로 확인합니다.
meta.provider_timestampintegerUTC · UNIX seconds
meta.published_atstringISO 8601 · UTC
meta.fetched_atstring서버가 데이터를 가져온 시각. 공급사 발표시각과 다릅니다.
meta.expected_interval_secondsintegerseconds
meta.staleboolean예상 주기 3배와 900초 중 더 긴 시간보다 시세가 오래되면 true.
meta.lag_secondsinteger공급사 발표 이후 경과 초.
meta.persistent_storageboolean영구 수집 서비스 연결 여부.
meta.kindstringlatest_published | utc_daily

GET /api/currencies

통화

파라미터자료형필수기본값설명
langstring선택enen / ko / ja / zh / es / hi / bn / de / fr / nl / pt / it / ru / vi / th / ar / id / ur
cURL
curl --request GET 'https://lumeexchangerates.com/api/currencies?lang=en'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "meta": {
    "provider": "외부 환율 데이터 공급사",
    "kind": "latest_published",
    "provider_timestamp": 1767225600,
    "published_at": "2026-01-01T00:00:00.000Z",
    "expected_interval_seconds": 300,
    "lag_seconds": 5,
    "stale": false,
    "timezone": "Asia/Seoul",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "persistent_storage": false
  },
  "data": [
    {
      "code": "USD",
      "name": "US Dollar"
    },
    {
      "code": "EUR",
      "name": "Euro"
    }
  ]
}

통화명은 Intl.DisplayNames로 현지화합니다. 이름을 구할 수 없는 자산은 코드로 표시합니다. 최신 데이터에 있는 코드만 반환합니다.

GET /api/rates/history

과거 날짜 환율은 /v1/history, 기간별 시계열은 /v1/series로 조회합니다.

파라미터자료형필수기본값설명
fromstring선택USD기준 통화
tostring선택EUR비교 통화
periodenum선택1M1D | 1W | 1M | 3M | 1Y
cURL
curl --request GET 'https://lumeexchangerates.com/api/rates/history?from=USD&to=EUR&period=1W'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "meta": {
    "kind": "utc_daily",
    "from": "USD",
    "to": "EUR",
    "period": "1W",
    "provider": "외부 환율 데이터 공급사",
    "persistent_storage": false
  },
  "data": [
    {
      "time": "2026-01-01",
      "value": 0.9
    },
    {
      "time": "2026-01-02",
      "value": 0.91
    }
  ]
}

1W는 7일 전부터 어제까지, 1M·3M·1Y는 달력 기준 기간의 시작일부터 어제까지 조회합니다. 윤년과 월말을 보정하고, 당일의 미완료 일별 값은 제외합니다. 한 달보다 긴 요청은 내부에서 달력 월별로 나눠 조회한 뒤 날짜순으로 합치고 중복 날짜를 제거합니다.

파라미터자료형설명
data[].timestring | integer일별: YYYY-MM-DD(UTC). 장중: UNIX 초.
data[].valuenumberrates[to] / rates[from]
meta.kindstringutc_daily | intraday
JSON
{
  "meta": {
    "kind": "intraday",
    "persistent_storage": false
  },
  "data": []
}

수집 서버 미연결 시 1D는 위와 같이 HTTP 200과 빈 data를 반환합니다. 이를 오류나 분 단위 시장 데이터로 해석하지 마세요. 과거 기간에 존재하지 않는 통화는 조회에 실패할 수 있습니다.

GET /api/rates/previous

직전 UTC 날짜

파라미터자료형필수기본값설명
fromstring선택USD기준 통화
tostring선택EUR비교 통화
cURL
curl --request GET 'https://lumeexchangerates.com/api/rates/previous?from=USD&to=EUR'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "meta": {
    "kind": "utc_daily",
    "reference_date": "2026-01-01",
    "reference_timestamp": "2026-01-01T23:59:59Z"
  },
  "data": {
    "from": "USD",
    "to": "EUR",
    "rate": 0.9,
    "rates": {
      "USD": 1,
      "EUR": 0.9
    }
  }
}

직전 UTC 날짜의 공급사 일별 값을 비교 기준으로 사용합니다. reference_timestamp는 해당 UTC 날짜의 논리적 마감 경계이며 개별 시세의 실제 발표시각이 아닙니다. 등락률은 (현재값 − 기준값) / 기준값 × 100입니다.

POST /api/convert

환율 계산기

파라미터자료형필수기본값설명
Content-Typeheader필수application/jsonapplication/json
amountnumber필수—0 ≤ amount ≤ 1e15; finite
fromstring필수—기준 통화
tostring필수—비교 통화
cURL
curl --request POST 'https://lumeexchangerates.com/api/convert' \
  --header 'Content-Type: application/json' \
  --data '{"amount":100,"from":"USD","to":"EUR"}'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "meta": {
    "provider": "외부 환율 데이터 공급사",
    "kind": "latest_published",
    "provider_timestamp": 1767225600,
    "published_at": "2026-01-01T00:00:00.000Z",
    "expected_interval_seconds": 300,
    "lag_seconds": 5,
    "stale": false,
    "timezone": "Asia/Seoul",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "persistent_storage": false
  },
  "data": {
    "amount": 100,
    "from": "USD",
    "to": "EUR",
    "rate": 0.9,
    "result": 90
  }
}

JSON 본문의 숫자를 사용합니다. amount: "100"처럼 문자열로 보내면 400입니다. 선택 통화는 최신 환율 집합에 있어야 하며 응답은 실제 송금이나 거래를 실행하지 않습니다.

GET /v1/history

과거 날짜 환율은 /v1/history, 기간별 시계열은 /v1/series로 조회합니다.

파라미터자료형필수기본값설명
dateYYYY-MM-DD필수—1999-01-01 ≤ date ≤ UTC today
anchorstring선택USD기준 통화
targetsCSV선택all비교 통화
cURL
curl --request GET 'https://lumeexchangerates.com/v1/history?date=2026-01-01&anchor=EUR&targets=USD,JPY'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "meta": {
    "date": "2026-01-01",
    "published_at": "2026-01-01T23:00:00Z",
    "partial_day": false
  },
  "anchor": "EUR",
  "data": [
    {
      "currency": "USD",
      "value": 1.1
    }
  ]
}
파라미터자료형설명
meta.partial_daybooleanUTC 일별 기준환율
meta.published_atISO 8601 UTC최신 발표환율

GET /v1/series

과거 날짜 환율은 /v1/history, 기간별 시계열은 /v1/series로 조회합니다.

파라미터자료형필수기본값설명
start / endYYYY-MM-DD필수—1999-01-01 ≤ start ≤ end < UTC today; ≤ 366 days inclusive
anchor / targetsstring / CSV선택USD / allsame as /v1/quotes
cURL
curl --request GET 'https://lumeexchangerates.com/v1/series?start=2026-01-01&end=2026-01-07&anchor=USD&targets=EUR'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "meta": {
    "start": "2026-01-01",
    "end": "2026-01-02",
    "timezone": "UTC",
    "count": 2
  },
  "anchor": "USD",
  "data": [
    {
      "date": "2026-01-01",
      "rates": [
        {
          "currency": "EUR",
          "value": 0.9
        }
      ]
    },
    {
      "date": "2026-01-02",
      "rates": [
        {
          "currency": "EUR",
          "value": 0.91
        }
      ]
    }
  ]
}

/v1/candles의 OHLC는 공급사 이용 권한이 필요합니다. /v1/capabilities에서 기능을 확인하세요. 실제 제공 범위는 연결된 플랜에 따릅니다.

JSON
{
  "timezone": "UTC",
  "date_bounds": "inclusive",
  "max_days": 366,
  "upstream_chunk": "calendar_month"
}

GET /v1/candles

/v1/candles의 OHLC는 공급사 이용 권한이 필요합니다. /v1/capabilities에서 기능을 확인하세요. 실제 제공 범위는 연결된 플랜에 따릅니다.

파라미터자료형필수기본값설명
startYYYY-MM-DDTHH:mm:00Z필수—UTC; completed period only; ≥ 2016-12-19
periodenum필수—1m | 5m | 15m | 30m | 1h | 12h | 1d | 1w | 1mo
anchor / targetsstring / CSV선택USD / allprovider base / symbols
cURL
curl --request GET 'https://lumeexchangerates.com/v1/candles?start=2026-01-01T00%3A00%3A00Z&period=1d&anchor=USD&targets=EUR'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "meta": {
    "start": "2026-01-01T00:00:00Z",
    "end": "2026-01-01T23:59:59Z",
    "period": "1d"
  },
  "anchor": "USD",
  "data": [
    {
      "currency": "EUR",
      "open": 0.9,
      "high": 0.92,
      "low": 0.89,
      "close": 0.91,
      "average": 0.905
    }
  ]
}
JSON
{
  "source": "provider_ohlc",
  "synthetic": false,
  "cross_rate_ohlc": false,
  "max_age": {
    "1m": "1h",
    "5m": "24h",
    "15m": "24h",
    "30m": "32d",
    "1h": "32d"
  },
  "alignment_minutes": {
    "5m": 5,
    "15m": 15,
    "30m": 30,
    "1h": 30,
    "12h": 30,
    "1d": 30
  },
  "calendar_alignment": {
    "1w": "00:00 UTC",
    "1mo": "YYYY-MM-01T00:00:00Z"
  }
}

GET /v1/capabilities

제공 범위

파라미터: —

cURL
curl --request GET 'https://lumeexchangerates.com/v1/capabilities'

아래 숫자와 날짜는 응답 구조를 설명하기 위한 예시이며 현재 시세가 아닙니다. 배열은 일부 항목만 보여줍니다. 실제 값은 API 실행기에서 확인하세요.

JSON
{
  "data": {
    "latest": true,
    "currencies": true,
    "conversion": "latest_snapshot",
    "historical": "verified_on_request",
    "time_series": true,
    "ohlc": false,
    "refresh_interval_seconds": 300,
    "customer_api_keys": false
  }
}

/v1/candles의 OHLC는 공급사 이용 권한이 필요합니다. /v1/capabilities에서 기능을 확인하세요. 실제 제공 범위는 연결된 플랜에 따릅니다.

데이터와 정밀도

환율의 의미와 시점을 알 수 있어야 올바르게 활용할 수 있습니다. 제공 환율은 은행의 매매 가격이나 거래가 보장된 호가가 아닌 참고용 기준환율입니다. 통화 변환은 동일한 환율 집합으로 계산하고, 반올림은 화면 표시나 정산 단계에서 적용합니다.

Formula
rate = rates[to] / rates[from]
result = amount * rate

환율은 소수 자릿수를 고정해 잘라내지 않습니다. 화면 표시나 회계 정책에 맞춰 최종 단계에서 반올림하세요.

통화 1단위 기준으로 계산하며 엔화도 동일합니다. 100엔 표시가 필요하면 최종 표시 단계에서만 100을 곱하세요. JavaScript number의 이진 부동소수점 오차를 고려하고, 회계 정산에서는 별도의 소수점·반올림 정책을 적용하세요.

시각과 날짜

UNIX 시각은 UTC 초, ISO 날짜·시각은 UTC의 Z 표기를 사용합니다. 일별 날짜는 사용자의 현지 날짜와 다를 수 있습니다. 웹사이트는 최신 발표시각을 사용자의 브라우저 시간대로 표시합니다. /api의 meta.timezone은 서버 표시 힌트이며 UTC timestamp의 기준을 변경하지 않습니다.

파라미터자료형설명
/v1 meta.as_ofISO 8601 | YYYY-MM-DD공급사 기준시각
/v1 meta.refresh_interval_secondsinteger캐시
/v1 meta.currency_countinteger현재 …개 통화 지원
/v1 meta.modeprovider | daily데이터 출처
/api meta.published_atISO 8601 UTC최신 발표환율
history data[].timeYYYY-MM-DD UTC | UNIX secondsUTC 일별 기준환율

오류 처리

HTTPcode설명
400INVALID_CURRENCY / INVALID_INPUT / INVALID_CONVERSION / INVALID_JSON / INVALID_PERIOD0 이상의 금액을 입력하세요
405METHOD_NOT_ALLOWEDGET: /v1/*, /api/rates/*, /api/currencies; POST: /api/convert
404NOT_FOUND/api/rates/*
422HISTORY_NOT_IN_PLAN / DATA_UNAVAILABLE제공 범위
429RATE_LIMITED/api/* · 90 / IP / minute
404NOT_FOUNDUnknown /v1 endpoint
422FEATURE_NOT_IN_PLAN / HISTORY_NOT_IN_PLAN / OHLC_NOT_IN_PLAN제공 범위
400INVALID_DATE / INVALID_DATE_RANGE / INVALID_PERIOD / INCOMPLETE_PERIOD0 이상의 금액을 입력하세요
503PROVIDER_UNAVAILABLE / DATA_UNAVAILABLE / SERVICE_UNAVAILABLE환율을 불러올 수 없습니다. 잠시 후 다시 시도하세요.
JSON
{
  "error": {
    "code": "INVALID_CURRENCY",
    "message": "Symbol not available in latest provider data"
  }
}

message는 일부 오류에서 생략될 수 있습니다. 코드와 HTTP 상태로 분기하세요. 입력 오류는 수정 후 재요청하고, 429·일시적 503은 지수 백오프와 무작위 지연으로 제한적으로 재시도하세요. Retry-After 헤더는 현재 보장하지 않습니다.

제한과 캐시

금액을 입력할 때마다 공급사를 호출하지 않고 최신 환율을 캐시해 계산합니다. 현재 설정된 피드는 5분 주기 갱신을 목표로 합니다. /api 경로는 IP당 분당 90회 제한이며, Worker 직접 연결 모드는 인스턴스 내 제한, Redis 서비스 연결 모드는 인스턴스 간 공통 제한입니다. /v1에는 출시 예정 요금제의 요청 한도가 아직 적용되지 않습니다.

반환 헤더는 Cache-Control: no-store입니다. 브라우저 응답 캐시와 서버의 공급사 캐시는 서로 다릅니다. 앱 내부에서는 meta 발표시각을 기준으로 같은 스냅샷을 재사용하세요. 마지막 정상 스냅샷이 서버에 남아 있으면 공급사 장애 중에도 반환할 수 있으므로 stale 또는 as_of를 항상 확인하세요. 직접 Worker 캐시는 영구 저장소가 아닙니다.

JSON
{
  "endpoints": [
    "/v1/history",
    "/v1/series",
    "/v1/candles",
    "/v1/capabilities"
  ],
  "requests_per_ip_per_minute": 60,
  "cache": "in_process",
  "completed_history_cache_seconds": 3600,
  "current_day_cache_seconds": 60
}

제공 범위

/v1/candles의 OHLC는 공급사 이용 권한이 필요합니다. /v1/capabilities에서 기능을 확인하세요. 실제 제공 범위는 연결된 플랜에 따릅니다.

/v1/candles의 OHLC는 공급사 이용 권한이 필요합니다. /v1/capabilities에서 기능을 확인하세요. 실제 제공 범위는 연결된 플랜에 따릅니다.

API 실행기

이 사이트의 API를 직접 호출해보세요. 공급사 키는 서버에서 보호됩니다.

요청 / cURL
응답 / JSON
요청을 실행하면 실제 JSON 응답을 확인할 수 있습니다.


WELCOME TO LUME EXCHANGE RATES
Lume Exchange Rates로 시작하세요
카드 없이 실제 공급사 환율을 체험하세요. 현재 무료 API는 미리보기이며 계정 구매나 청구가 발생하지 않습니다.
https://lumeexchangerates.com/v1/quotes?anchor=USD&targets=KRW,EUR
실제 환율 · 결제 없음


SUBSCRIPTION / USD
구독 내용 확인
USD 정기구독입니다. 최종 세금과 총액은 보안 결제창에서 확인한 후 승인하세요.
적용 세금은 결제창에 표시됩니다. 결제 포털에서 구독 갱신을 관리하고 취소할 수 있습니다.
Paddle


ACCOUNT / BILLING
내 구독