在做投资理财工具、量化交易课程设计、行情看板项目时，很多同学都会遇到一个特别常见的难点：港股的数据不好拿，历史 K 线和实时行情要分开调用，接口不一样、格式不一样、字段不统一，写代码越写越乱。
这篇慕课手记就用最简单、最实战、最适合课程项目的方式，教你如何用一套接口轻松整合港股历史 + 实时行情，代码直接复制就能跑。
一、做港股项目时，你一定遇到过这些坑
不管是课程作业、个人项目，还是入门量化，大家基本都会卡在这里：
历史数据和实时数据要找两个不同接口，对接成本高
数据格式不一样，时间戳对不上，画图、回测全报错
实时行情用轮询，延迟高、请求多，很容易被限制
数据脏、缺 K 线，处理起来特别麻烦
其实只要思路对了，港股数据整合一点都不复杂。
二、核心思路：一套 API 搞定历史 + 实时
行业里最简单、最稳定的方案就是：用同一个数据源，统一数据格式，分别拉取历史、订阅实时。
好处非常明显：
只学一套接口，开发速度快
历史和实时字段一致，不会冲突
代码结构干净，方便扩展指标、画图、回测
项目可直接升级为量化策略系统
三、港股数据该怎么用？（项目直接套用）
1. 历史行情（回测、画图、算指标）
支持：日线、1 分钟 / 5 分钟 / 15 分钟 K 线
格式：JSON，方便 Python 处理
用途：策略回测、画 K 线图、计算均线、MACD 等指标
小技巧：先缓存，避免重复拉取，提升速度
2. 实时行情（报价、看板、实时提醒）
最佳方式：WebSocket 长连接订阅
比轮询延迟更低、更稳定、更省资源
用途：实时价格展示、盘中信号、价格提醒
支持：成交 Tick、买卖盘口、最新报价
四、项目实战：简洁可运行代码（直接用）
下面这段是港股实时行情订阅代码，适合课程设计、行情面板、实时监控。
import json
import websocket
# 收到实时行情时触发
def on_message(ws, message):
data = json.loads(message)
print("港股实时行情：", data)
# 连接成功后订阅
def on_open(ws):
ws.send(json.dumps({
"action": "subscribe",
"symbols": ["HK_00700", "HK_00001"]
}))
# 启动连接
if __name__ == "__main__":
ws = websocket.WebSocketApp(
"wss://apis.alltick.co/hk-ws",
on_message=on_message,
on_open=on_open
)
ws.run_forever()五、数据整合的关键（项目必看）
想让你的项目稳定、不出错，记住这 3 点：
历史与实时使用同一套字段命名，避免混乱
统一时间戳格式，画图、回测才能对齐
实时数据用来展示，历史数据用来计算，分工明确
这样做出来的港股行情工具、量化小项目，逻辑清晰、代码优雅、好扩展、好演示。
六、总结
对于学习开发、做课程项目的同学来说，港股数据最难的不是代码，而是整合。只要用一套 API 统一管理历史行情 + 实时行情，就能大幅降低难度，让项目更快落地、更稳定运行。
在实战项目中，AllTick API提供完整的港股数据支持，一份接口同时覆盖历史与实时，格式统一、接入简单，非常适合学习、课程设计与个人项目使用。