如何使用 QOS 行情 API 获取港股实时行情数据

在全球金融市场中，港股因其独特的投资价值吸引了大量投资者。然而，获取高效、稳定的港股实时报价数据一直是交易者和开发者关注的重点。QOS 行情 API 作为一款专业的行情数据接口，提供美股 API、港股 API、A 股 API，支持美股实时报价数据、港股实时报价数据、A 股实时报价数据，确保用户实时获取精准行情。同时，QOS API 还提供美股 K 线、港股 K 线、A 股 K 线等历史数据，助力技术分析和量化交易策略优化。

QOS API 支持REST API 和 WebSocket 接口，便于快速集成，为金融开发者与投资者提供专业的市场数据解决方案，助力精准投资与智能交易。

一、QOS 行情 API 介绍

QOS 行情 API 提供港股、美股、A股的实时行情数据，支持 REST API 和 WebSocket 两种方式，适用于各类金融应用开发。其主要特点包括：

• 港股、美股、A股实时行情：涵盖全市场股票，提供最新价格、涨跌幅等关键数据。
• 多种数据接口：支持 REST API 查询单个股票数据，也支持 WebSocket 进行实时推送。
• 高稳定性与低延迟：高并发架构，确保数据更新迅速。
• 免费试用与灵活套餐：提供免费试用额度，满足不同用户需求。

二、如何使用 QOS 行情 API 获取港股实时行情？

1. 注册并获取 API Key

要使用 QOS 行情 API，首先需要在 QOS 官网 注册账号，并在菜单栏右侧获取 API Key，这是访问 API 数据的凭证。

2. 通过 REST API 获取港股实时行情

REST API 适用于需要定期查询单只或多只股票的应用，以下是调用示例：

请求示例(python)：

import requests
import json

# 官网：https://qos.hk
# 免费api key注册申请：https://qos.hk
url = "https://api.qos.hk/snapshot?key=your-api-key"

payload = json.dumps({
  "codes": [
    "HK:700,9988"
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

返回示例：

{
    "msg": "OK",
    "data": [
        {
            "c": "HK:9988",
            "lp": "130",
            "yp": "129.8",
            "o": "129",
            "h": "132",
            "l": "128.4",
            "ts": 1743581305,
            "v": "61236236",
            "t": "7968615270",
            "s": 0
        },
        {
            "c": "HK:700",
            "lp": "504",
            "yp": "504",
            "o": "505",
            "h": "509",
            "l": "499.2",
            "ts": 1743581305,
            "v": "14247546",
            "t": "7168421768",
            "s": 0
        }
    ]
}

该接口返回腾讯控股（00700.HK和09988.HK）的最新价格、高开低收、涨跌幅等关键信息。

2. 通过 REST API 获取港股K线数据

REST API 适用于需要定期查询单只或多只股票的应用，以下是获取日K数据的调用示例：

请求示例(python)：

import requests
import json

# 官网：https://qos.hk
# 免费api key注册申请：https://qos.hk
url = "https://api.qos.hk/kline?key=your-api-key"

payload = json.dumps({
  "kline_reqs": [
    {
      "c": "HK:700,9988",
      "co": 1,
      "a": 0,
      "kt": 1001
    }
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

返回示例：

{
    "msg": "OK",
    "data": [
        {
            "c": "HK:700",
            "k": [
                {
                    "c": "HK:700",
                    "o": "505",
                    "cl": "504",
                    "h": "509",
                    "l": "499.2",
                    "v": "14247546",
                    "ts": 1743523200,
                    "kt": 1001
                }
            ]
        },
        {
            "c": "HK:9988",
            "k": [
                {
                    "c": "HK:9988",
                    "o": "129",
                    "cl": "130",
                    "h": "132",
                    "l": "128.4",
                    "v": "61236236",
                    "ts": 1743523200,
                    "kt": 1001
                }
            ]
        }
    ]
}

该接口返回腾讯控股（00700.HK和09988.HK）的最新一根日K数据。

3. 通过 WebSocket 获取实时推送数据

如果你的应用需要毫秒级更新数据，可以使用 WebSocket 订阅行情。

示例代码（python）：

import websocket
import time
import threading
import json

# WebSocket URL（根据实际情况替换）
url = "wss://api.qos.hk/ws"
# API Key（替换为你的API Key）
# 官网：https://qos.hk
# 免费api key注册申请：https://qos.hk
api_key = "your-api-key"

def on_message(ws, message):
    print("接收到消息:", message)

def on_error(ws, error):
    print("错误:", error)

def on_close(ws, close_status_code, close_msg):
    print("连接关闭")

def on_open(ws):
    # 发送初始订阅行情快照消息
    subscribe_message_1 = json.dumps({
        "type": "S",
        "codes": [
            "HK:700,9988"
        ],
        "reqid": 1
    })
    ws.send(subscribe_message_1)

    # 2秒后发送第二个订阅命令
    def send_second_subscription():
        time.sleep(1)
        subscribe_message_2 = json.dumps({
            "type": "T",
            "codes": [
                "HK:700,9988"
            ],
            "reqid": 1
        })
        ws.send(subscribe_message_2)
        
        time.sleep(1)
        
        subscribe_message_2 = json.dumps({
            "type": "D",
            "codes": [
                "HK:700,9988"
            ],
            "reqid": 1
        })
        ws.send(subscribe_message_2)

    threading.Thread(target=send_second_subscription).start()
    
    # 发送心跳包（每20秒）
    def send_heartbeat():
        while True:
            time.sleep(20)
            heartbeat_message = json.dumps({"type":"H"})
            ws.send(heartbeat_message)
            print("发送心跳包")

    threading.Thread(target=send_heartbeat, daemon=True).start()

# 创建WebSocket连接
ws = websocket.WebSocketApp(url + "?key=" + api_key,
                            on_message=on_message,
                            on_error=on_error,
                            on_close=on_close,
                            on_open=on_open)

# 运行WebSocket连接
ws.run_forever()

当订阅成功后，服务器会持续推送腾讯控股（00700.HK和09988.HK）的实时行情数据,实时盘口数据，实时逐笔成交数据。

三、QOS 行情 API 的优势

1. 数据精准

QOS 行情 API 依托权威数据源，确保行情数据高精度、低延迟，满足投资者对实时数据的严苛需求。无论是股票报价、K 线数据，还是深度盘口信息，均能提供稳定、准确的行情支持。

2. 高并发支持

采用先进的分布式架构，QOS 行情 API 具备强大的高并发处理能力，能够同时支持大量用户访问，确保在市场波动剧烈时依然保持数据传输稳定顺畅。

3. 免费试用，价格透明

新用户可免费试用部分 API，方便个人开发者、量化交易者和企业用户低成本体验高质量的行情数据服务。此外，所有套餐定价透明，无隐藏费用，用户可以根据自身需求灵活选择合适的服务方案。

结语

QOS 行情 API 专注于提供专业、稳定的港股、美股、A股行情数据，适用于个人投资者、金融网站、量化交易系统、证券分析软件等多种应用场景。凭借高精度的数据、强大的并发支持以及灵活透明的定价体系，QOS 行情 API 能够助力用户提升数据处理效率，优化投资决策。

无论是进行股票分析、搭建交易系统，还是开发智能投资工具，QOS 行情 API 都能为你提供高效、精准的行情支持。立即访问 QOS 官网，开启智能投资新体验！