하나은행 고시환율 API 개발자 가이드 (Apify, 코드 포함)
2026-09-01
하나은행 고시환율 API 개발자 가이드
하나은행이 매일 고시하는 환율(매매기준율·현찰·송금)을 자동으로 조회하려면 보통 은행 사이트를 크롤링해야 한다고 생각하기 쉽습니다. 하지만 hana-fx-rates라는 공개 액터를 쓰면 Selenium 없이 순수 HTTP 요청만으로 데이터를 받을 수 있습니다.
핵심: 한 줄 요청으로 전체 환율 조회
curl "https://api.apify.com/v2/acts/consnam~hana-fx-rates/run-sync-get-dataset-items"이 요청은 오늘(KST 기준)의 1회차(최초) 고시환율 전체 통화(약 58개)를 JSON 배열로 반환합니다.
입력 파라미터
| 파라미터 | 타입 | 설명 |
|---|---|---|
date |
string YYYY-MM-DD |
조회 기준일. 생략 시 KST 오늘 |
round |
string | first(1회차·최초), latest(현재 최종), specific(특정 회차) |
roundNumber |
int | round=specific일 때 회차 번호 |
currencies |
array | ISO 코드 필터. 생략 시 전체 통화 |
용어 매핑: 1회차 = 최초 고시 =
round=first, 현재 최종 =round=latest, 특정 회차 =round=specific.
출력 필드
date, round, roundType, announcedAt, currency, currencyName,
unit, baseRate(매매기준율), cashBuy/cashSell(현찰), wireSend/wireReceive(송금),
checkSell, conversionFeeRate, usdConversionRate, source, fetchedAt.
주의: 100단위 통화
JPY(엔)·VND(동)·IDR(루피아)는 100단위로 고시됩니다. unit 필드로 나눠야
1단위 환율이 됩니다. 예: baseRate: 980.51, unit: 100이면 1엔 ≈ 9.8051원.
주말·공휴일
주말이나 공휴일 요청은 직전 영업일 데이터를 반환하며, 결과의 date가 실제
기준일이 됩니다.
스케줄 예시
하루 1회 자동 수집이 필요하면 GitHub Actions나 cron에서 위 엔드포인트를 호출하면 됩니다. 더 자세한 예시(최초 USD/JPY/EUR, 현재 최종 전체 통화)는 액터의 예제를 참고하세요.