환율 API 사용 예제

환율 API 사용 예제는 exchangerate.host의 live 엔드포인트를 PHP cURL로 호출해 USD 기준 환율을 원화 1,000원 기준으로 바꾸는 코드를 보여 줍니다.

비즈니스 도구 무료 · 설치 없음

PHP 코드 예제

// https://exchangerate.host/dashboard
$currencies = "USD,EUR,JPY,AUD,CAD,KRW,CNY,GBP,NZD,THB,VND,HKD,TWD";
$access_key = "YOUR_ACCESS_KEY";

$url = "http://api.exchangerate.host/live?access_key=$access_key¤cies=$currencies&format=1";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
if (isset($data['success']) && $data['success'] === true) {
    $usdkrw = $data['quotes']['USDKRW'];
    $krw1000_in_usd = 1000 / $usdkrw;
    foreach ($data['quotes'] as $pair => $rate) {
        $currency = substr($pair, 3);
        $converted = $krw1000_in_usd * $rate;
        $krw_value = $usdkrw / $rate;
        echo "$currency: $rate >> KRW(1,000): " . number_format($converted, 4);
    }
}

응답 결과 예시 (₩1,000 기준)

통화USD 기준₩1,000 환산1단위 = KRW
참고
• exchangerate.host 에서 무료 API 키 발급
• 예시 테이블은 USD/KRW 1,380 가정 환산값입니다 (실시간 아님)

환율 API 사용 예제로 할 수 있는 것

이 페이지는 exchangerate.host 환율 API를 PHP에서 호출하는 방법을 정리한 코드 예제입니다. 실시간 환율 조회기가 아니라, 자기 사이트나 사내 프로그램에 환율 기능을 붙이려는 개발자가 복사해서 출발점으로 쓰라고 만든 페이지입니다. 코드 아래 표는 그 코드가 어떤 모양의 결과를 내는지 보여 주는 예시로, USD/KRW를 1,380원으로 가정해 계산한 값입니다.

사용 방법

  1. exchangerate.host 대시보드에서 무료 API 키를 발급받습니다.
  2. PHP 코드 예제를 복사해 YOUR_ACCESS_KEY 자리에 발급받은 키를 넣습니다.
  3. 필요하면 $currencies 문자열에서 통화 코드를 빼거나 더합니다. 예제에는 USD, EUR, JPY, CNY, VND 등 13개 통화가 들어 있습니다.
  4. 서버에서 실행해 응답 결과 예시 표와 같은 형식으로 값이 나오는지 확인합니다.

이럴 때 유용합니다

해외 구매대행이나 수출입 업무에서 견적서에 오늘 환율을 자동으로 넣고 싶을 때, 쇼핑몰 상품가를 달러·엔화로 함께 표시하고 싶을 때 이 예제를 그대로 가져다 시작하면 됩니다. API 응답은 USD 기준 환율만 주기 때문에, 원화 기준으로 바꾸는 계산을 어떻게 하는지 보여 주는 부분이 특히 쓸모 있습니다.

알아 두면 좋은 점

응답의 quotes에는 USDKRW, USDJPY처럼 USD 대비 비율이 들어옵니다. 원화 1,000원이 다른 통화로 얼마인지는 1000 / USDKRW에 각 통화 비율을 곱해서 구하고, 그 통화 1단위가 몇 원인지는 USDKRW / 비율로 구합니다. 표의 세 열이 바로 이 세 값입니다.

$krw1000_in_usd = 1000 / $data['quotes']['USDKRW'];
$converted = $krw1000_in_usd * $rate;   // ₩1,000 환산

예제 URL은 http://로 되어 있으니, 사용하는 요금제가 HTTPS를 지원하면 바꿔 쓰는 편이 안전합니다. 서버에서 allow_url_fopen이 막혀 있어도 cURL을 쓰므로 그대로 동작합니다. 이 페이지 자체는 외부 API를 호출하지 않으며, 표는 브라우저에서 고정값으로 계산해 그린 것입니다.

자주 묻는 질문

표에 나온 환율이 오늘 환율인가요? 아닙니다. USD/KRW 1,380원과 고정된 비율로 계산한 예시라 실제 시세와 다릅니다. 실제 값은 API 키를 넣고 코드를 실행해야 받을 수 있습니다.

무료 키로도 쓸 수 있나요? exchangerate.host에서 무료 키를 발급받을 수 있습니다. 호출 횟수 제한 같은 조건은 해당 서비스 요금제 안내를 확인하세요.

도구 전체 보기 →