如何通过 API 获取黄金实时报价数据？QOS 行情 API 全流程详解

想轻松接入 黄金实时报价数据，助力量化策略、财经分析、投资决策？本文将带你快速了解如何使用 QOS 行情 API 通过 REST 或 WebSocket 接入黄金价格，体验专业稳定、毫秒级延迟的数据推送。

一、QOS 行情 API 简介

• 覆盖全面：支持实时获取股票、外汇、期货、加密货币、指数、大宗商品、贵金属（包括黄金和白银）等市场行情。(qos.hk)
  
• 双接口方式：
  • HTTP REST API：适合定期抓取行情快照或历史 K 线数据；
  • WebSocket：适用于毫秒级推送的实时行情更新。(qos.hk)
    
• 免费试用 & 灵活套餐：
  • 免费套餐每分钟可批量请求 10 次，支持实时逐笔价格、盘口、K 线、基础信息等；
    
  • 高级套餐按需组合，自由选择产品类别（如黄金、白银），请求频率最高可达每分钟 1800 次以上。(qos.hk)

二、接入步骤指导

1. 注册并获取 API Key

访问 QOS 官网注册账号并获取 API Key，即可获取访问权限。(qos.hk)

2. 获取黄金产品编码

使用 product-list 接口请求大宗商品类别（CM），可获取包括黄金在内的产品编码（如 CM:XAUUSD）。(qos.hk)

请求示例（JSON Body）：

{
  "market": ["CM"]
}

响应示例中包含：

"CM": [
  {
    "code": "CM:XAUUSD",
    "name": "黄金"
  },
  ...
]

3. 通过 REST API 获取黄金行情快照

Python 示例：

import requests, json

url = "https://api.qos.hk/snapshot?key=你的API_KEY"
payload = json.dumps({"codes": ["CM:XAUUSD"]})
headers = {'Content-Type': 'application/json'}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

此接口返回包括最新价格、昨日收盘价、高低价、成交量等关键行情数据。(qos.hk)

4. 使用 WebSocket 订阅实时行情（毫秒级更新）

Python 示例：

import websocket, threading, time, json

url = "wss://api.qos.hk/ws?key=你的API_KEY"

def on_message(ws, message):
    print("收到数据：", message)

def on_open(ws):
    subscribe = json.dumps({"type": "S", "codes": ["CM:XAUUSD"], "reqid": 1})
    ws.send(subscribe)

    # 心跳机制保持连接
    def heartbeat():
        while True:
            time.sleep(20)
            ws.send(json.dumps({"type": "H"}))
    threading.Thread(target=heartbeat, daemon=True).start()

ws = websocket.WebSocketApp(url, on_message=on_message, on_open=on_open)
ws.run_forever()

• type="S" 代表订阅行情快照，支持逐笔价格、盘口、K 线等多种类型推送；
  
• 心跳机制可保持连接稳定，确保持续获取数据流。(qos.hk)

三、小结：为什么选择 QOS 行情 API 获取黄金实时报价？