1. 출처 분류
공개 필드 source는 공급업체가 아닌 데이터 분류를 설명합니다. live는 은행 간 거래 주간에 짧은 간격으로 업데이트될 수 있는 참고용 현물 시장 데이터입니다. ecb_daily는 유럽중앙은행의 참조 환율로, 일반적으로 영업일마다 한 번 게시됩니다. market_daily는 ECB 고시 환율이 없는 통화에 대해 시장 데이터 피드의 일일 마감 환율을 저장합니다.
여러 통화가 포함된 응답에는 환율이 제시된 각 통화의 sources 맵이 포함됩니다. 최상위 source는 보수적으로 표시됩니다. 해당 응답에 포함된 분류 중 최신성이 가장 낮은 분류를 보고합니다.
참고: ECB 유로 참조 환율.
2. 시각과 시장 상태
data_updated_at은 기초 관측값이 마지막으로 기록된 시각입니다. timestamp는 API 응답이 생성된 시각입니다. 데이터 경과 시간 계산에는 전자를, 요청 시점 감사에는 후자를 사용하세요.
market_session은 은행 간 거래 주간에는 open, 뉴욕 시간 금요일 17:00 마감 이후부터 뉴욕 시간 일요일 17:00까지는 weekend, 주말 이외에 알려진 휴장 기간에는 interbank_closed입니다. 주말 응답에는 해당 거래 주간의 마지막 관측값이 포함될 수 있습니다. 이 라벨이 주말의 새로운 호가를 의미하지는 않습니다.
3. 기준 통화 변경과 파생 교차 환율
호출자가 지원되는 모든 기준 통화를 요청할 수 있도록 환율을 정규화합니다. 통화 쌍을 직접 관측하지 않는 경우 API는 사용 가능한 구성 통화 쌍을 통해 삼각 계산을 수행합니다. 파생값은 derived_symbols에 표시되며, 단일 통화 쌍 응답에는 해당하는 경우 derived와 derivation_bps_max 한도도 제공됩니다.
교차 환율은 구성 통화 쌍 중 최신성이 가장 낮은 출처를 이어받습니다. 파생 환율을 허용할 수 없는 애플리케이션은 통화 쌍으로 추론하는 대신 파생 산출 필드를 확인해야 합니다.
4. 과거 관측값
일일 내역은 고시 환율과 시장 마감 환율을 결합합니다. 주요 통화의 데이터는 1999년까지 거슬러 올라갑니다. 약 30개 통화는 ECB 고시 환율을, 나머지 113개는 시장 마감 환율을 사용하며, 데이터 시작일은 통화 쌍마다 다릅니다. 새로운 고시 환율이 없는 주말이나 공휴일에는 이전 관측값을 이월할 수 있으며 is_forward_filled: true로 표시합니다. API는 게시되지 않은 고시 환율을 만들어 내지 않습니다.
5. 검증과 게시
- 환율을 산정하기 전에 통화 식별자를 ISO 형식의 대문자 코드로 정규화합니다.
- 출처와 업데이트 시각 필드는 클라이언트가 추론하는 대신 관측값과 함께 전달됩니다.
- 실시간 관측값이 없거나 너무 오래된 경우 실시간으로 표시하는 대신 사용 가능한 일일 참조 분류로 대체합니다.
- 모든 플랜은 동일한 출처를 사용합니다. Free 및 키 없이 호출하는 사용자는 실시간 환율을 15분 지연으로 받습니다.
- 게시되는 연구에는 측정 기간, 표본 수, 방법 및 한계가 포함되어야 합니다.
6. 한계
이 환율은 참고용 참조 환율이며, 체결 가능한 매수/매도 호가가 아닙니다. 은행, 카드사, 중개업체, 결제 서비스 제공업체 또는 현금 환전업체의 스프레드와 수수료는 포함하지 않습니다. 정산, 결제 실행, 규제 대상 거래 또는 공식 기록의 출처로 사용해서는 안 됩니다. 지원 범위와 최신성은 통화, 출처 가용성, 시장 휴장 및 참조 기관의 게시 일정에 따라 달라질 수 있습니다.
7. 최신성 벤치마크 표준
순위를 게시하기 전에 프로토콜을 공개합니다. 재현 가능한 환율 API 최신성 벤치마크는 관측 기간, 타임스탬프 요건, 지표, 제외 기준 및 최소 표본 크기를 정의합니다. 기계 판독 가능한 프로토콜에는 현재 제공업체 결과가 포함되어 있지 않습니다. 명시된 증거 기준을 충족한 후에만 결과가 추가됩니다.
개정 내역
1.1 · 2026년 10월 9일: Free의 지연과 시장 일일 마감 환율을 명확히 설명했습니다.
1.0 · 2026년 7월 16일: 최초 공개 방법론, 출처의 의미, 시장 거래 세션 규칙, 파생 산출 정책, 과거 데이터 처리 방식, 한계 및 벤치마크 게시 표준.