방법론 · goldprice.dev

출처별로 그대로 전달

대부분의 금속 API는 여러 피드에서 시세를 수집하고 가중 중앙값을 계산한 뒤 입력값을 버리고 하나의 숫자를 제공합니다. 혼합 과정은 불투명합니다. 거래소 간 가격이 다를 때(롤오버, 정산, 각 시장 마감 전후에 매일 발생합니다), API의 숫자가 실제 상황을 반영하는지 API 내부 가중치를 반영하는지 알 수 없습니다.

현물가는 라이선스를 확보한 하나의 기본 출처에서 혼합이나 평균 계산 없이 그대로 전달합니다. 장애가 발생하면 라이선스를 확보한 백업 출처가 금과 은 시세를 제공합니다. 구리에는 백업이 없습니다. ?include=sources를 추가하면 시세를 제공한 출처와 해당 가격, fetched_at, source_timestamp를 확인할 수 있습니다.

GET /v1/prices?symbol=XAU-USD-SPOT&include=sources

{
  "symbol": "XAU",
  "price": "4803.94",
  "is_stale": false,
  "computed_at": "2026-05-01T02:34:02Z",
  "sources": [
    { "source": "oracle.xau_usd", "display_name": "Live spot", "price": "4803.94", "fetched_at": "...", "source_timestamp": "..." }
  ]
}

수집하는 출처

각 등급의 출처 범주입니다. 호출별로 특정 가격에 어떤 피드가 사용되었는지 보여 주는 근거는 /v1/prices 응답에 있습니다.

출처	용도	등급
기본 실시간 현물가 피드	금, 은, 구리의 실시간 현물가	모든 플랜; Free는 15분 지연, 유료 플랜은 실시간
백업 현물가 피드	기본 출처를 이용할 수 없는 동안에만 금과 은 현물가 제공	모든 플랜; Free는 15분 지연, 유료 플랜은 실시간
선물 정산 기준 데이터 (금 + 은 + 구리)	일일 정산, 선물 연속성, 정산가와 현물가의 차이	기존 플랜만 해당
exchangerate.dev 환율	USD 이외 통화의 금 시세를 위한 통화 환산	모든 등급

출처 식별자, 갱신 주기, 상위 제공자의 엔드포인트 세부 정보는 내부 문서로 관리하며 릴리스마다 변경됩니다. 법률 검토를 위해 이 수준의 세부 정보가 필요하면 사용 사례를 담아 hello@goldprice.dev로 이메일을 보내 주세요. 답변해 드리겠습니다.

통화 페이지의 USD 이외 통화 가격은 USD 금 현물가에 자매 통화 API인 exchangerate.dev의 실시간 환율을 곱한 값입니다. USD 이외 통화의 현물가 행은 저장된 환율을 대체값으로 사용하지 않습니다. 실시간 환율이 중단되면 /v1/convert와 /v1/carat는 최대 3일 된 저장 환율 중 최신 값을 사용하며, USD 이외 통화의 현물가 행은 오래된 가격을 유지합니다.

백업 현물가 피드

현물가는 라이선스를 확보한 기본 시장 데이터를 사용합니다. 매수/매도 호가는 유료 플랜에서만 선택적으로 제공하며, 일관된 양방향 호가가 필요합니다. 기본 출처가 중단되면 복구될 때까지 금과 은은 라이선스를 확보한 백업으로 전환됩니다. 백업 가격은 시장보다 최대 약 2분 늦을 수 있습니다. 백업을 사용하는 동안에는 응답에 매수 또는 매도 호가가 없습니다.

금속 시장이 닫혀 있을 때는 백업을 사용하지 않습니다. 매일 17:00부터 18:00까지, 금요일 17:00부터 일요일 18:00까지이며 모두 뉴욕 시간 기준입니다. 구리에는 백업이 없습니다. 구리 피드가 중단되면 마지막 구리 가격을 오래된 데이터로 표시합니다.

출처 간 괴리

최신 상태인 기본 출처가 2개 이상인 행에는 divergence_bps가 포함됩니다. 이는 평균 대비 가격 차이를 베이시스 포인트로 나타낸 값입니다. 현물가 행은 출처 하나를 사용하므로 이 필드를 생략합니다. GET /v1/prices/divergence는 모든 등급에서 가격 차이 임계값을 초과하는 심볼을 나열합니다.

XAU-USD-SPOT의 divergence_flag는 false로 유지됩니다. USD 이외 통화의 금 시세는 USD 현물가 × exchangerate.dev 실시간 환율을 사용합니다.

LBMA 고시가에 대해

출처별 데이터 노후 상태

가격을 제공하는 출처가 예상 갱신 시간을 넘기면 최상위 is_stale이 true가 됩니다. ?include=sources를 추가하면 해당 출처의 가격, fetched_at, source_timestamp를 확인하고 최신 상태인지 직접 판단할 수 있습니다.

미래 전망: 선물 곡선

시장이 내포하는 미래 가격 경로는 /v1/forward-view/{asset}에서 제공합니다. 아래 설명에서는 계산 방식, 출처, 갱신 주기를 다룹니다.

선물 곡선

앞으로 만기가 도래하는 금 선물 계약 5개입니다. 정산가는 기본 지연 피드 시계열을 통해 약 15분 지연되어 제공되며 보조 대체 피드가 있습니다. 선물 값은 공개적으로 이용 가능한 지연 피드에서 가져오며, 라이선스를 확보한 실시간 데이터가 아닙니다. 점선은 5개 정산 지점을 연결합니다. 특정 계약에 대해 기본 피드와 대체 피드가 모두 실패하면 간격이 생깁니다. 미결제약정과 거래량은 최선 노력 방식으로 처리되며 null이고, 응답에 표시되지 않습니다.

데이터 최신성

선물 정산가 갱신은 평일 20:30 UTC에 실행됩니다. 연중 단일 일정이며 EDT에서는 정산 후 +2h, EST에서는 +1h이고, 서머타임 전환에도 일정이 유지됩니다.

제공하지 않는 것

LBMA 고시가 위 내용을 참고하세요.
틱 단위 L2 주문장 시장 깊이가 아닌 가격을 게시합니다. 틱 단위 주문장은 이 API의 제공 범위 밖입니다.
1초 미만 지연 시간 보장 수치로 정한 지연 시간 SLA를 게시하지 않습니다.
알리지 않는 혼합 이 페이지의 핵심입니다.

자주 묻는 질문

시세의 출처와 백업 제공 범위의 작동 방식.

기본 및 백업 데이터 제공자는 누구인가요?

금, 은, 구리에 대해 라이선스를 확보한 하나의 기본 시장 데이터 제공자를 사용합니다. 라이선스를 확보한 백업 제공자는 금과 은을 지원합니다. 두 제공자의 이름은 공개하지 않습니다.

현물가는 합성 가격인가요, 아니면 단일 제공자의 호가인가요?

기본 제공자의 가격을 혼합이나 평균 계산 없이 그대로 전달합니다. 공식 벤치마크나 LBMA 고시가가 아닙니다. ?include=sources는 fetched_at과 source_timestamp가 포함된 sources[]를 반환합니다.

기본 피드가 중단되면 어떻게 되나요?

기본 출처를 이용할 수 없는 동안 라이선스를 확보한 백업이 금과 은 시세를 제공합니다. 약 2분 지연될 수 있으며 매수 또는 매도 호가가 없습니다. 구리에는 백업이 없습니다. 사용 중인 출처가 예상 갱신 시간을 넘기면 is_stale이 true가 됩니다.

방법론 변경 내역

버전	변경 사항
v3.3	데이터 출처, 백업 제공 범위, 그룹 웹사이트 사용을 업데이트했습니다. 현재 유료 플랜은 출처 표기가 필요하지 않습니다.
v3.2	API와 일치하도록 문구를 수정했습니다: Free 지연, 매수/매도 호가 제공 여부, 구리 현물가, 출처 필드.
v3.1	금과 은의 백업 현물가 피드를 추가했습니다. 토큰화 금 대체 수단을 폐지했습니다.
v3.0	공개 방법론을 출처 범주 + 괴리 + 데이터 노후 상태 개념으로 좁혔습니다. 출처별 식별자, 갱신 주기, 집계 세부 정보는 공개 페이지에서 옮겼습니다.
v2.1	금속으로 전환했습니다. XAG 오라클을 통한 은 현물가와 구리 선물 정산가를 추가했습니다.
v2.0	출처별 직접 전달 방식으로 전환했습니다. 혼합 중앙값 집계를 폐지했습니다. 실시간 현물가 오라클, ECB 환율, 토큰화 금(참고용)을 추가했습니다.
v1.0	초기 다중 출처 집계. 1등급 가중 중앙값(이후 대체됨).

방법론 개정 이외의 API 엔드포인트, 등급 및 제품 릴리스는 제품 변경 내역을 참고하세요.

질문, 정정, 이의 제기

잘못된 부분을 발견했거나 검토할 만한 출처가 있나요? hello@goldprice.dev로 이메일을 보내 주세요. 중요한 정정 사항은 여기에 게시합니다.

API에 대해 궁금한 점이 있나요? 문서 읽기.