計算金銀比

透過 API 計算比值

計算需要一個金價與一個銀價。Narwhal 透過大宗商品現貨 API 回傳這兩個價格，每個價格的單位皆為 troy_ounce。結果代表一盎司黃金可以買多少盎司白銀。整個計算過程請始終以金為分子、銀為分母。

1. 取得你的 API 金鑰 取得免費 API 金鑰，並存放在環境變數 NARWHAL_API_KEY 中。腳本會讀取該變數，並透過 Authorization: Bearer YOUR_KEY 標頭傳送金鑰。
2. 選擇金價與銀價 金價使用 GET /v1/commodities/spot/XAU/USD，銀價使用 GET /v1/commodities/spot/XAG/USD。這是兩個獨立的請求，兩個價格都以每金衡盎司美元計價，因此幣別與單位一致。
3. 用金價除以銀價 執行 Python 腳本，讀取每個回應中的 price，並用金價除以銀價。輸出會同時列出比值與兩個輸入價格，方便你連同輸入一起核對計算。
   Python:金銀比

   import os
   import requests
   
   H = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   API = "https://api.narwhalapi.com/v1/commodities/spot"
   
   
   def price(code):
       return float(
           requests.get(f"{API}/{code}/USD", headers=H, timeout=10).json()["price"]
       )
   
   
   gold, silver = price("XAU"), price("XAG")
   print(f"gold {gold:.2f} / silver {silver:.4f} = {gold / silver:.2f}")

4. 查看結果 以 2026 年 10 月 24 日的範例來看，輸出為 gold 3996.00 / silver 53.9171 = 74.11。比值代表每盎司黃金對應多少盎司白銀；兩個輸入價格是以每金衡盎司美元計的金額。

腳本中，price("XAU") 讀取金價，price("XAG") 讀取銀價。該函式會把各金屬代碼與 /USD 接到大宗商品現貨 URL 後面，再將 JSON 回應中的 price 欄位讀取為數字。最後一行會同時輸出金價、銀價及其商。腳本顯示的比值保留兩位小數，金價兩位，銀價四位。這些格式只作用於列印輸出；除法使用的是從回應中讀取的價格原值。凡是計算需要金銀比，都可以使用這個商；需要回頭查看輸入時，請保留各自的價格。

在試算表中計算或線上查看

開啟金銀比頁面，即可在網站上查看比值。如果只想看數值而不想自己發出兩次 API 請求，這是最直接的方式。你也可以把金價和銀價填入試算表，在表格中進行除法。

把金價填入 B1，銀價填入 B2，兩者都以每金衡盎司美元計。在要顯示比值的儲存格中輸入公式，並在輸入儲存格旁加上標籤，標明各是哪種金屬。

=B1/B2

輸入另一組價格時，替換 B1 中的金價輸入與 B2 中的銀價輸入。公式維持為金價除以銀價。如果想比較結果，請在表格與 API 計算中使用同一組價格。表格公式從這些儲存格取得輸入，而 Python 腳本則從現貨回應中取得輸入。

各種情況適合的方式

製作圖表或模型時，使用 GET /v1/commodities/spot/XAU/USD/bars 與 GET /v1/commodities/spot/XAG/USD/bars。設定 interval=1d，並為兩種金屬提供所需的起訖日期。為金與銀請求相同的日期範圍，然後在相同日期上逐根 K 線用金價除以銀價。每一組資料就是圖表或模型中該日期比值的輸入。與現貨計算一樣，整段歷史中都要讓金的序列作分子。若要設定提醒，請儲存計算出的比值，並依照大宗商品價格提醒指南中的方法進行比較。

兩個價格需要是同一時間的嗎？

是的，請使用同一時間的價格，因為時間不同會為比值帶來雜訊。可同時請求兩個現貨價格，或使用相同日期的日線。建立比值歷史時，先把每根金價 K 線與同一日期的銀價 K 線配對，再進行除法。

計算現貨比值時，請同時發出金與銀的請求。對於日線序列，用日期來配對輸入：某一日期的金價要與同一日期的銀價配對。對每一組配對好的資料進行除法。

為什麼不能使用其他幣別的銀價？

只有當兩個價格使用同一幣別時，比值才不受幣別影響。本計算的兩個請求都使用 USD。以 USD 計價的金價與以其他幣別計價的銀價不符合這項條件，即使兩個價格都按每金衡盎司報價也一樣。幣別與單位必須一致。

比值是即時的嗎？

是的。大宗商品現貨價格對每個帳戶都是即時的，因此比值會隨市場變動。讀取結果時，請查看每個價格的 timestamp。除法維持不變：金價除以銀價，兩個價格都以每金衡盎司美元計。

計算範例：計算金銀比

2026 年 10 月 24 日的範例中，金價為每金衡盎司 $3,996.00，銀價為 $53.9171。先取金價，再除以銀價。計算時保留給定的銀價原值，並依 Python 腳本使用的精度顯示所得比值。