计算金银比

通过 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 脚本使用的精度显示所得比值。