실시간 금 가격 차트는 어떻게 작동할까?
실시간 금 가격 차트가 현물 호가, OHLC 바, UTC 타임스탬프, 제어된 폴링을 결합하는 방식을 TypeScript와 SVG 예제로 알아봅니다.
읽기 →금 포트폴리오 템플릿을 Google Sheets로 가져오고 기준 가격을 업데이트해 보유 항목별 예상 가치, 매입 비용, 변동을 계산하세요.
금괴, 주화, 주얼리를 보유하고 있다면 총액 하나만으로는 내용을 확인하기 어렵습니다. 이 템플릿은 보유 항목마다 행을 만들고, 매입 비용과 현물 가격 기준의 예상 가치를 분리하며, 계산에 사용한 가격의 시각을 표시합니다. 감정가나 실제 매입 가격을 보장하는 도구가 아니라 참고용 계산표입니다.
금 포트폴리오 추적표를 다운로드합니다. Google Drive에서 New → File upload를 선택하고 .xlsx 파일을 연 다음 File → Save as Google Sheets를 선택하세요. 스프레드시트 파일을 열고 다운로드하는 방법은 Google 도움말에 설명되어 있습니다: https://support.google.com/docs/answer/49114.
워크북에는 세 개의 시트가 있습니다.
시트와 열의 이름은 파일과 수식이 일치하도록 영어로 유지했습니다.
Portfolio에서 세 개의 예시 행을 본인의 데이터로 바꿉니다. 한 행은 하나의 보유 항목 또는 조건이 같은 항목 묶음입니다.
| 열 | 입력할 값 |
|---|---|
| Holding | 1 oz bar, 18K ring 같은 이름 |
| Unit | grams 또는 troy oz |
| Quantity | 측정한 수량 |
| Purity | 99.9%, 18K는 75%, 또는 확인된 순도 |
| Purchase cost | Price Data와 같은 통화의 총 매입 비용 |
| Purchase date | 매입일 또는 기록일 |
| Notes | 판매자, 영수증, 식별 정보 등의 선택 메모 |
모든 비용을 하나의 통화로 입력하세요. 템플릿은 트로이온스를 31.1034768그램으로 변환하면서 원래 수량도 표시합니다.
템플릿이 사용하는 엔드포인트는 다음과 같습니다.
GET https://api.goldprice.dev/v1/carat?currency=USD
응답에는 price_gram_24k, timestamp, currency가 있습니다. 24K 숫자 값을 Price Data → B6에, 응답 시각을 B5에, 해당 견적 통화를 B7에 복사하고 세 셀을 같은 응답에서 함께 업데이트하세요. 다른 통화를 사용하려면 그 통화의 새 견적을 받은 뒤 B3을 바꾸고 매입 비용도 같은 통화로 맞추세요. B3만 바꿔 오래된 USD 견적을 IDR로 표시하면 안 됩니다. JSON 가격 필드는 소수 문자열이므로 시트에는 숫자로 입력해야 수식이 계산됩니다.
다운로드 파일에는 가져온 직후 수식이 보이도록 명확히 표시된 예시 데이터가 들어 있습니다. 실제 결과를 사용하기 전에 예시 가격을 교체하세요. 워크북은 자동으로 API를 호출하지 않으며 API 키도 저장하지 않습니다. 공유 문서에서 인증이 필요하면 서버 프록시를 사용하고, 다른 편집자가 확인할 수 있는 시트나 바운드 스크립트에 자격 증명을 넣지 마세요.
갱신 메뉴를 추가하려면 동봉된 Apps Script를 다운로드하고 Google Sheets에서 Extensions → Apps Script를 연 뒤 기본 코드를 지우고 파일 내용을 붙여 넣습니다. 저장한 다음 스프레드시트를 다시 불러오세요. Gold portfolio → Refresh price data 메뉴는 Price Data → B3의 통화를 사용해 키 없이 한 번만 요청합니다. HTTP 상태, 응답 통화, 양수이고 유한한 price_gram_24k, timestamp를 확인한 뒤 B5:B7을 함께 씁니다. 실패하면 이전 가격, 시각, 견적 통화를 유지합니다. 직접 붙여 넣는다면 같은 응답에서 B5, B6, B7을 업데이트하세요. 타이머나 백그라운드 polling은 만들지 않습니다.
각 행은 네 단계로 계산됩니다.
Weight (g)가 수량을 그램으로 변환합니다.Spot price/g가 Price Data의 24K 가격을 참조합니다.Indicative value가 Weight (g) × Purity × Spot price/g를 계산합니다.Change가 Indicative value − Purchase cost를 계산합니다.예를 들어 10그램, 순도 75%, 24K 가격 128.24라면 10 × 0.75 × 128.24 = 961.80입니다. 이는 기준 현물 가격에 따른 금 함량 가치이며, 세공비, 보석, 세금, 지역 프리미엄, 판매자 스프레드, 재매입 할인은 포함하지 않습니다.
요약은 수량이 입력된 행 수, 변환된 총중량, 총 매입 비용, 예상 현물 가치, 변동을 계산합니다. 빈 행은 계산 열에서도 빈 상태로 남습니다.
현물 가격은 변합니다. 요약의 **Price timestamp (UTC)**는 수식이 사용한 응답의 시각입니다. 가격을 갱신할 때 시각도 함께 갱신하세요. 보고서로 보관할 때는 원본 응답이나 시각을 남겨 계산을 재현할 수 있게 하세요.
0.999를 텍스트로 입력하지 말고 퍼센트로 99.9%를 입력하세요. USD 비용과 IDR 가격을 섞지 말고, 그램과 트로이온스도 구분하세요. Change는 보장된 수익이 아니라 판매 비용을 반영하지 않은 현물 가격 차이입니다. 이 템플릿은 감정, 회계 기록, 세금 신고, 투자 조언, 보장된 판매 가격이 아닙니다. 실제 거래 전에는 현지 규정과 판매자 견적을 확인하세요.
시트에서 실시간 및 과거 금 가격을 사용하는 방법은 Gold Price API Google Sheets 튜토리얼을 참고하세요.
관련 가이드
실시간 금 가격 차트가 현물 호가, OHLC 바, UTC 타임스탬프, 제어된 폴링을 결합하는 방식을 TypeScript와 SVG 예제로 알아봅니다.
읽기 →확정된 XAU/USD 일별 바(bar)와 과거 환율 관측치를 결합해, 당시에는 알 수 없었던 환율을 실수로 사용하지 않고 현지 통화로 금 전략을 테스트한다.
읽기 →iframe 하나로 WordPress에 무료로 설정 가능한 실시간 금 시세 위젯을 추가한다. Gutenberg와 Elementor에서 모두 작동하며, API 키도 플러그인도 필요 없다.
읽기 →goldprice.dev
실시간 금 시세, 과거 OHLC 데이터, 다중 소스 집계 — REST 및 SSE로 제공됩니다.