CurrencyRateAPI

빠른 실행 도구

전체 문서를 뒤져보지 않고 API를 테스트해야 하시나요? 제어판으로 이동하면 빠른 실행 도구를 찾을 수 있습니다. 이 도구를 사용하면 단 한 번의 클릭으로 사용 가능한 모든 엔드포인트를 간단하게 테스트해 볼 수 있습니다.

아래 버튼을 클릭하여 무료로 등록하고 빠른 실행 도구를 사용해 보세요.

시작하기

환율 API를 사용하기 시작할 때 필요한 주요 용어 및 개념:

API 응답

CurrencyRateAPI에서 제공하는 환율은 기본적으로 유로화 기준입니다. 모든 데이터는 표준 JSON 형식으로 반환되므로 모든 프로그래밍 언어를 사용하여 쉽게 파싱할 수 있습니다.

샘플 답변:
아래에는 EUR를 기준으로 한 다양한 세계 주요 통화의 데이터와 수신 타임스탬프가 포함된 API 응답 예시가 있습니다.

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

위에서 보시는 바와 같이 실시간 환율 API 응답에는 몇 가지 주요 필드가 포함됩니다.

• success 요청이 성공했는지 여부를 나타냅니다.
• base 이 요청에 사용된 기본 통화의 3자리 코드를 반환합니다.
• date 환율이 제공되는 실제 날짜(YYYY-MM-DD 형식)를 반환합니다.
• rates 요청된 통화 목록과 현재 환율을 보유하고 있습니다.
• last_update_unix 시스템에서 사용 가능한 최신 데이터의 타임스탬프(유닉스 형식)를 표시합니다.

사용 가능한 엔드포인트

CurrencyRateAPI는 여러 API 엔드포인트를 포함하고 있으며, 각 엔드포인트는 특정 기능을 제공합니다. 특정 엔드포인트의 사용 가능 여부는 구독 플랜에 따라 다릅니다.

• 통화 목록의 끝점. 이 엔드포인트는 지원되는 모든 통화의 전체 목록을 반환합니다. /api/codes (대안: /api/currencies)
• 최신 요금의 종착점. 이 엔드포인트는 지원되는 모든 통화에 대한 실시간 환율 데이터를 반환합니다. /api/latest
• 역사적 금리의 종착점. 이 엔드포인트는 특정 날짜에 대한 과거 환율 데이터를 반환합니다. /api/YYYY-MM-DD (대안: /api/history?date=YYYY-MM-DD). 1999년 1월 4일부터의 과거 데이터를 확인할 수 있습니다.

환율 산정 방법론

데이터의 정확성과 일관성을 보장하기 위해 CurrencyRateAPI 환율 관리 및 제공에 있어 엄격한 방법론을 따릅니다.

• 중간 시장 요금: 기본적으로 API는 mid 환율을 반환합니다. 이는 시장 매수 가격( bid )과 매도 가격( ask )의 산술 평균 또는 중앙은행의 공식 기준 환율을 나타냅니다.
• 일일 마감(EOD) 최종 처리: API에서 제공하는 과거 요금은 UTC (협정 세계시) 기준으로 당일 마감 시점에 확정됩니다.
• 교차율 계산: 당사 소스에서 직접 제공되지 않는 통화 쌍의 경우, 시스템은 주요 글로벌 통화를 연결(피벗) 수단으로 사용하여 매우 정확한 교차 환율을 자동으로 계산합니다.
• 스마트한 백업 메커니즘: 요청하신 날짜의 데이터가 없는 경우(예: 주말이나 공휴일 시장 폐쇄로 인해), 시스템은 자동으로 8일 이내의 기간 동안 가장 최근의 유효한 환율을 검색합니다.
• 높은 정밀도: 재무 계산에서 반올림 오류를 방지하기 위해 환율은 소수점 이하 최대 18자리 까지 저장 및 처리됩니다.

엔드포인트

지원되는 심볼 엔드포인트

https://currencyrateapi.com/api/codes

이 엔드포인트는 지원되는 모든 통화의 전체 목록을 반환합니다. /api/currencies라는 별칭을 사용할 수도 있습니다.

지원되는 모든 통화 목록은 사람이 읽기 쉬운 형식으로 저희 지원 통화 페이지에서도 확인하실 수 있습니다.

기본 통화: 기본적으로 /latest 및 /{YYYY-MM-DD}와 같은 일부 엔드포인트는 트래픽을 최소화하기 위해 제한된 주요 글로벌 통화 세트만 반환합니다. 이러한 "기본" 통화는 다음과 같습니다.

USD, EUR, GBP, CHF, JPY, CAD, AUD, NZD, SEK, NOK, DKK, ISK, PLN, CZK, HUF, RON, HRK, RSD,
MKD, MDL, TRY, SGD, HKD, KRW, TWD, ILS, AED, SAR, QAR, KWD, BHD, OMR, ZAR

API 응답:

{
    "success": true,
    "currencies": {
        "EUR": {
            "entity": "EUROPEAN UNION",
            "currency": "Euro",
            "alphabetic_code": "EUR",
            "numeric_code": 978,
            "minor_unit": 2,
            "title": "Euro",
            "symbol": "€",
            "data_from": "1999-01-04"
        },
        "BTC": {
            "entity": "CRYPTOCURRENCY",
            "currency": "Bitcoin",
            "alphabetic_code": "BTC",
            "title": "Bitcoin",
            "symbol": "₿",
            "is_crypto": true,
            "data_from": "2024-03-02"
        },
        [...]
    }
}

응답 객체:

최신 요금 엔드포인트

https://currencyrateapi.com/api/latest?
    base=USD&
    quote=GBP,JPY,EUR

요청 매개변수:

API 응답:

{
    "success": true,
    "base": "usd",
    "date": "2026-01-22",
    "rates": {
        "gbp": "0.74350935478637",
        "jpy": "158.00358051914",
        "eur": "0.8518613169776"
    },
    "last_update_unix": "1769067006"
}

응답 객체:

과거 비율의 종점

https://currencyrateapi.com/api/2025-08-25?
    base=EUR&
    quote=USD,GBP,CAD

대체 형식: /api/history?date=2025-08-25...

요청 매개변수:

API 응답:

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

응답 객체:

샘플 코드

PHP(cURL)

// Set API Endpoint (can be 'latest' or a date 'YYYY-MM-DD')
$endpoint = 'latest';

// Initialize CURL:
$ch = curl_init('https://currencyrateapi.com/api/'.$endpoint.'?base=USD"e=GBP,JPY');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Store the data:
$json = curl_exec($ch);
curl_close($ch);

// Decode JSON response:
$exchangeRates = json_decode($json, true);

// Access the exchange rate values, e.g. GBP:
echo $exchangeRates['rates']['GBP'];

자바스크립트(가져오기)

 // Set endpoint (can be 'latest' or a date 'YYYY-MM-DD')
const endpoint = 'latest';
const params = '?base=USD"e=GBP,JPY';

// Get exchange rates via the selected endpoint:
fetch('https://currencyrateapi.com/api/' + endpoint + params)
    .then(response => {
        return response.json();
    })
    .then(json => {

        // Exchange rate data is stored in json.rates
        console.log(json.rates.GBP);

        // Timestamp can be accessed in json.last_update_unix
        console.log(json.last_update_unix);
    })
    .catch(error => {
        console.error('Fetch error:', error);
    });