多市场行情数据接入实践：使用Python获取A股、港股、美股实时行情 - 文章 - 开发者社区

本文场景面向量化开发、金融数据调研开发者，分享跨市场股票API选型思路与可运行WebSocket实战样例。

在日常的金融数据调研工作中，我经常需要同时跟踪A股、港股、美股的多组标的行情。过去我的工作方式是同时开启多款行情客户端，在不同窗口之间来回切换比对价格。

有一次遇到时间窗口重叠：港股开盘时段刚好撞上美股盘前交易，我同时打开多个界面人工核对报价。受限于手动操作的反应延迟，没能及时捕捉到关键价格信号。这件事之后我意识到，依靠多客户端人肉盯盘的模式效率低下且容易出错，不如直接通过行情API，把境内外多个市场的行情收敛到同一套程序中，交由代码完成实时监控。

跨市场股票API，该从哪些维度做选型评估？

市面上不少服务宣称支持全球金融行情，但真正落地到开发集成，体验差异非常明显。结合实际开发踩坑经验，我会从4个核心维度评估股票API能力，优先级从前到后依次排列。

交易市场覆盖能力 需要同时支持A股、港股、美股核心市场。部分服务商只聚焦单一海外市场，其余品种需要额外对接其他数据源，会带来对接工作量上升、多源数据对齐、维护成本抬高等一系列问题。
推送延迟与链路稳定性 集合竞价、开盘瞬间行情报文流量大，是稳定性的压力测试窗口。如果WebSocket链路在这个阶段发生卡顿、断连，会直接导致行情接收中断，量化观测、回测前置、实时监控等工作都会直接失效。
数据返回结构标准化程度 很多开发者容易忽略这一点。如果不同市场返回的数据字段名、价格精度、时间戳格式各不相同，业务代码就要写大量分支判断做格式适配，会显著增加开发和后续维护成本。理想状态下，多市场使用同一套数据协议与字段体系。
计费策略与免费配额 只有前面三项核心能力达标，再去权衡成本与额度。倘若数据源稳定性、兼容性不达标，再低廉的接口也无法投入实际业务使用。

经过多家对比测试，我选择 AllTick API 作为行情数据源。它将A股、港股、美股、外汇、加密行情统一封装在同一套WebSocket协议，订阅接口逻辑完全一致，不用针对不同市场单独编写解析逻辑，降低了跨市场行情的接入复杂度。

Python WebSocket 实战：单连接订阅A股、港股、美股实时报价

下面基于 websocket‑client 实现长连接订阅，在同一个WebSocket会话下同时接收三个市场标的的实时推送。样例参考官方文档 alltick.co，代码可以直接调试运行。

import json
import websocket

# 替换为你的实际token
TOKEN = "YOUR_TOKEN"

WS_URL = (
    "wss://quote.alltick.co/quote-stock-b-ws-api"
    f"?token={TOKEN}"
)

# 同时配置 A股、美股、港股标的
symbols = [
    {"code": "688036.SH"},
    {"code": "AAPL.US"},
    {"code": "700.HK"},
]


def on_open(ws):
    """连接建立完成，发起行情订阅请求"""
    print("WebSocket connected")
    subscribe_req = {
        "cmd_id": 22002,
        "seq_id": 1,
        "trace": "python_dev_demo",
        "data": {
            "symbol_list": [
                {"code": item["code"], "depth_level": 1}
                for item in symbols
            ]
        }
    }
    ws.send(json.dumps(subscribe_req))


def on_message(ws, message):
    """接收行情推送消息"""
    try:
        payload = json.loads(message)
        print(payload)
    except json.JSONDecodeError:
        print("Invalid JSON message")


def on_error(ws, error):
    print(f"WebSocket error: {error}")


def on_close(ws, code, msg):
    print(f"WebSocket closed, code:{code}, msg:{msg}")


if __name__ == "__main__":
    ws_app = websocket.WebSocketApp(
        WS_URL,
        on_open=on_open,
        on_message=on_message,
        on_error=on_error,
        on_close=on_close
    )
    ws_app.run_forever()

运行脚本之后，控制台就会持续打印传音控股、Apple、腾讯控股的实时行情数据。所有市场统一采用毫秒级时间戳，核心报价字段保持一致，不需要大量if‑else分支区分市场类型。

工程补充提示：样例仅做基础演示，生产环境建议在外层增加循环实现断线自动重连，规避网络抖动导致连接中断。我在实盘观测场景增加重连逻辑后，整体链路可用性表现良好。

接入后的实际效果总结

脚本启动后，A股、港股、美股行情全部收敛至同一个程序输出，不再需要来回切换多个客户端。即便是港股集合竞价这类行情波动剧烈的时段，数据推送也没有明显延迟，接口返回报价和网页行情源能够基本对齐。

对于需要做多市场研究、实时观测的开发者来说，这套方案解决的不只是操作繁琐的问题，更规避了人工切换工具带来的时间差，避免错过重要的价格异动信号。

延伸思考

测试环境务必控制订阅标的数量，避免超出接口限流；
生产使用建议做好日志落盘、异常告警、重连退避策略；
不同交易时段部分品种会无推送，属于正常市场状态，业务代码需要做好空数据兼容。

参考文档：https://alltick.co/apis/zh
GitHub：https://github.com/alltick/alltick-realtime-forex-crypto-stock-tick-finance-websocket-api