金价银价 API

黄金、白银实时价格（国际 + 国内）

GET /api/metals

无需参数。

返回字段

• international（array）：国际现货（新浪 hf_ 行情）：伦敦金 hf_XAU、伦敦银 hf_XAG，价格单位均为 美元/盎司（金衡盎司，1 盎司 = 31.1034768 克）。上游缺少某个品种时该项不出现
• international[].metal（string）：品种：gold 黄金 / silver 白银
• international[].symbol（string）：新浪行情代码：hf_XAU（伦敦金）或 hf_XAG（伦敦银）
• international[].unit（string）：价格单位，固定为 USD/oz（美元/盎司）
• international[].timezone（string）：time 所用时区，固定为 Asia/Shanghai（北京时间）
• international[].name（string|null）：新浪给出的品种名称（如 伦敦金（现货黄金））；上游为空时为 null
• international[].price（number|null）：最新价（美元/盎司）；上游为空时为 null
• international[].prevClose（number|null）：昨收价（美元/盎司）；上游为空时为 null
• international[].open（number|null）：今开价（美元/盎司）；上游为空时为 null
• international[].high（number|null）：今日最高价（美元/盎司）；上游为空时为 null
• international[].low（number|null）：今日最低价（美元/盎司）；上游为空时为 null
• international[].bid（number|null）：买价（美元/盎司）；上游为空时为 null
• international[].ask（number|null）：卖价（美元/盎司）；上游为空时为 null
• international[].change（number|null）：涨跌额（美元/盎司）= price − prevClose，保留 4 位小数；price 或 prevClose 为空时为 null
• international[].changePercent（number|null）：涨跌幅，百分数（0.26 表示 +0.26%），相对 prevClose，保留 2 位小数；change 为 null 时为 null
• international[].time（string|null）：行情时间，格式 YYYY-MM-DD HH:mm:ss，北京时间（UTC+8）；上游缺日期或时间时为 null
• international[].cnyPerGram（number）：按 usdCny 折算的人民币价格（元/克）= price × usdCny ÷ 31.1034768，保留 2 位小数，仅为汇率折算的参考值，不是国内市场成交价。仅在汇率获取成功（usdCny 不为 null）且 price 不为空时出现，否则不返回该字段
• domestic（array）：上海期货交易所（SHFE）沪金、沪银主力连续合约（新浪 nf_AU0 / nf_AG0），价格单位均为 元/克（沪银上游报价为 元/千克，已 ÷ 1000 换算为元/克）。上游缺少某个品种时该项不出现
• domestic[].metal（string）：品种：gold 黄金 / silver 白银
• domestic[].symbol（string）：新浪行情代码：nf_AU0（沪金连续）或 nf_AG0（沪银连续）
• domestic[].unit（string）：价格单位，固定为 CNY/g（人民币元/克）
• domestic[].exchange（string）：交易所，固定为 SHFE（上海期货交易所）
• domestic[].timezone（string）：time 所用时区，固定为 Asia/Shanghai（北京时间）
• domestic[].name（string|null）：新浪给出的合约名称（如 黄金连续、白银连续）；上游为空时为 null
• domestic[].price（number|null）：最新价（元/克）；上游为空时为 null
• domestic[].prevSettle（number|null）：昨日结算价（元/克）；上游为空时为 null
• domestic[].prevClose（number|null）：昨日收盘价（元/克）；上游为空时为 null
• domestic[].open（number|null）：今开价（元/克）；上游为空时为 null
• domestic[].high（number|null）：今日最高价（元/克）；上游为空时为 null
• domestic[].low（number|null）：今日最低价（元/克）；上游为空时为 null