원화 원자재 가격 등 내 통화로 원자재 가격 확인하기

API 사용 방법

원자재 코드로 금속이나 원유를 고르고, 이어서 통화 코드로 표시 통화를 고르세요. 금은 루피아로 직접 요청할 수 있습니다. 은, 백금, 팔라듐, 구리, WTI, Brent 현물 가격은 미국 달러로 표시되므로 루피아로 계산하려면 USD/IDR 환율도 필요합니다.

현물 원자재와 FX 가격은 모든 계정에서 실시간입니다. 이는 금 직접 요청과 환산에 쓰는 가격 모두에 적용됩니다. 루피아 금액을 표시할 때는 가격 시각과 함께 트로이온스당인지 그램당인지도 함께 표시하세요.

1. API 키 받기 무료 키를 받아 환경 변수 NARWHAL_API_KEY에 보관하세요. https://api.narwhalapi.com으로 보내는 요청에 Authorization: Bearer YOUR_KEY로 실어 보냅니다. 원자재 요청과 FX 요청은 같은 계정과 키를 씁니다.
2. 표시 통화 고르기 루피아 기준 금은 GET /v1/commodities/spot/XAU/IDR을 요청하세요. 은은 달러 현물 가격과 GET /v1/fx/rates/USD?currencies=IDR을 요청합니다. 금 코드 뒤의 통화가 직접 시세의 통화를 정하고, FX 요청은 은을 환산하는 환율을 제공합니다.
3. 루피아 가격 계산하기 Python 스크립트로 금을 IDR로 직접 읽고, 은의 달러 가격에 USD/IDR 환율을 곱합니다. 또한 금 시세를 트로이온스당 그램 수로 나누어 반올림한 그램당 가격도 구합니다.
   Python, 인도네시아 루피아 기준 금과 은

   import os
   import requests
   
   H = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   API = "https://api.narwhalapi.com/v1"
   GRAMS_PER_TROY_OUNCE = 31.1034768
   
   # Gold is quoted in every FX currency we serve, so ask for rupiah directly.
   gold = requests.get(f"{API}/commodities/spot/XAU/IDR", headers=H, timeout=10).json()
   print(
       "gold IDR per oz  ",
       gold["price"],
       "->",
       round(float(gold["price"]) / GRAMS_PER_TROY_OUNCE),
       "per gram",
   )
   
   # Silver is quoted in US dollars only: convert with the USD/IDR rate.
   silver = float(
       requests.get(f"{API}/commodities/spot/XAG/USD", headers=H, timeout=10).json()[
           "price"
       ]
   )
   idr = float(
       requests.get(
           f"{API}/fx/rates/USD", params={"currencies": "IDR"}, headers=H, timeout=10
       ).json()["rates"][0]["rate"]
   )
   print("silver IDR per oz", round(silver * idr), "=", silver, "x", idr)

4. 가격에는 단위를 함께 두기 금 출력은 트로이온스당 루피아와 그램당 루피아로, 은 출력은 온스당 루피아로 읽으세요. 통화 환산은 은 시세의 통화를 바꾸고, 금에서 따로 하는 나눗셈은 무게 단위를 바꿉니다.

스크립트는 각 원자재 응답에서 price를, FX 응답의 rates 배열에서 rate를 읽습니다. 금의 그램당 금액은 나눗셈 뒤에, 은의 루피아 금액은 곱셈 뒤에 반올림됩니다. 출력되는 은 계산에는 그 곱셈에 쓴 달러 가격과 환율이 포함됩니다.

API 오류는 status, code, detail, request_id를 담은 application/problem+json으로 반환됩니다. 요청이 오류를 반환하면 가격 계산에 응답을 쓰기 전에 code와 detail을 읽어 보세요.

시트에서 또는 코드 없이 가격 얻기

코드 없이 금 가격을 보려면 Narwhal 금 가격 페이지를 여세요. 여러 통화로 표시된 금 가격을 볼 수 있습니다. 원자재와 FX 요청을 직접 작성하지 않고 내 통화의 금 가격을 읽고 싶을 때 이 방법을 쓰세요.

시트에서는 =XAUUSD * USDIDR을 사용하고, 두 셀 모두 API 값으로 채우세요. XAUUSD에는 미국 달러 기준 금 가격이, USDIDR에는 달러에서 루피아로의 환율이 들어 있습니다. 둘의 곱이 같은 무게 단위의 루피아 금 가격입니다. 이는 금의 환산 경로이며, API에서는 IDR 금을 직접 요청할 수도 있습니다.

상황별 계산 방법

루피아 금 가격이 직접 조회한 값과 환산한 값에서 다른 이유는 무엇인가요?

두 시세의 타임스탬프가 다르기 때문입니다. 2026년 10월 24일 예시에서 루피아 금 직접 시세의 시각은 2026년 10월 23일 20:59 UTC이고, FX 환율의 시각은 2026년 10월 23일 00:00 UTC입니다. 따라서 달러 금 시세에 그 환율을 곱하면 루피아 직접 시세와 다른 시각을 쓰게 됩니다.

2026년 10월 24일 예시에서 USD 3,996.00의 금에 USD/IDR 18,107.8을 곱하면 Rp 72,358,769가 되어, 직접 시세 Rp 72,145,300보다 0.3% 높습니다. 방법을 하나 정해 계속 그것을 쓰세요. 특정 시점의 가격이 필요하면 양쪽 모두에 같은 타임스탬프의 바를 사용하세요.

USD/IDR 환율은 곱하나요, 나누나요?

달러 기준 원자재 가격에 USD/IDR 환율을 곱하면 루피아 가격이 됩니다. 2026년 10월 24일 예시에서 USD/IDR 18,107.8은 1 미국 달러로 18,107.8 루피아를 살 수 있다는 뜻입니다. 환율을 달러당 루피아로 읽고, 원자재 시세의 달러 수에 곱하세요.

통화 환산과 무게 환산은 따로 하세요. USD/IDR을 곱하면 원자재 시세의 무게 단위 그대로 루피아 가격이 나옵니다. 금 가격을 그램당으로 나타내려면 트로이온스당 가격을 1 트로이온스의 그램 수인 31.1034768로 나누세요.

금은 어떤 통화로 직접 요청할 수 있나요?

금은 FX 지원 범위 목록에 있는 통화를 지원합니다. 현물 요청에서 XAU 뒤에 목록에 있는 통화 코드를 쓰세요. 404 currency_not_supported는 해당 원자재가 그 통화로 제공되지 않는다는 뜻입니다.

이 통화 목록은 금의 직접 시세에 적용됩니다. 은, 백금, 팔라듐, 구리, WTI, Brent 현물은 계속 미국 달러만 제공됩니다. 이런 원자재는 미국 달러 시세를 쓰고, 원하는 통화에 대한 달러 환율을 곱하세요.

실제 예시: 루피아 기준 금과 은

2026년 10월 24일 금 직접 시세는 트로이온스당 Rp 72,145,300이었습니다. 이 루피아 금액을 트로이온스당 31.1034768그램으로 나누세요. 결과를 가장 가까운 루피아로 반올림하면 그램당 Rp 2,319,525가 됩니다.

2026년 10월 24일 은은 온스당 USD 53.9171의 현물 가격에서 시작합니다. 여기에 USD/IDR 환율 18,107.8을 곱한 뒤 가장 가까운 루피아로 반올림하세요. 결과는 온스당 Rp 976,320입니다.