港股行情API怎么选?本地脚本搬上服务器,还要比较什么?
TickDB Research ·
港股行情API怎么选?本地脚本搬上服务器,还要比较什么?
摘要:个人港股脚本搬到团队服务器,选行情API要比较的不只是价格。本文对照富途OpenD官方运行条件和一次腾讯控股真实快照,把网关、登录、行情权限、数据时间与团队使用需求拆开,给出可直接交给开发和数据供应商的试用清单。
个人电脑上的港股观察脚本已经能跑,下一步想放到服务器,让团队每天打开看板都能看到数据。这时才发现,选型表上的“支持港股”和“支持Python”回答不了最关键的问题:以后谁负责让这条取数链一直处于可用状态?
容易走偏的判断是:券商接口只能在电脑上用,独立API才适合云端。查过富途官方文档后,这个分类就站不住了。OpenD本来就支持在本地或云端运行,也提供命令行方式。
因此,港股行情API选型要比较的是你的服务需要维持哪些条件。把条件列出来,才能判断现有路径是否值得保留。
服务器改变的,首先是责任分工
一个人运行脚本,登录失效时自己处理,缺几个字段也能临时改。团队服务需要把这些动作交接给别人:机器重启后谁检查、行情权限变化谁发现、看板展示的是哪个时间的数据。
先按同一个任务比较两条路径:为团队内部提供港股观察看板,暂不接交易指令。
| 要维持的条件 | 富途OpenD路径 | 直接REST取数路径 |
|---|---|---|
| 运行组件 | 业务程序、OpenD网关及连接 | 业务程序与HTTP请求 |
| 访问凭据 | OpenD登录及相应权限 | API密钥及相应权限 |
| 服务器可运行 | 官方支持本地和云端 | 需在目标服务器验证网络与请求 |
| 数据可用性 | 核API权限、额度与连接 | 核具体品种、字段、限频及账户条件 |
| 团队或对外用途 | 按实际用途核授权 | 同样按实际用途核授权 |
这张表没有给“谁更稳定”打分。少一个网关意味着少一项由团队维护的组件,不等于已经测过故障率,也不意味着另一条路径应该被淘汰。

图为运行组件示意。两条路径都可能部署在服务器上,授权、质量与持续可用性需要分别核查。
一个值得纠正的认识:APP能看,不代表API条件相同
富途官方说明,OpenD支持Windows、macOS、CentOS、Ubuntu,登录后启动Socket服务供程序连接;其API行情权限与APP行情权限不完全一样,还分别存在接口限频、订阅额度和历史K线额度。
这会改变试用顺序。先查看自己账户的API权限,再确认要取的是基本报价、盘口还是历史数据;不要把APP里能看到的内容,直接写成服务器也一定能取到的清单。
独立行情服务也要过同样的检查。REST只是接入形式,密钥能通过认证,也不代表所有字段、全部品种和使用范围都已经满足。
我们实际取到了一条什么记录
11月16日晚,我们用TickDB的REST快照接口查询腾讯控股700.HK。HTTP状态200,业务码0,返回的证券代码、名称与最新价字段为:
700.HK 腾讯控股
last_price = 390.4
数据时间 = 2026-11-16T16:08:13+08:00
注意最后一行。请求是在晚上发出的,记录时间仍是16:08:13。它可以作为页面上“该时间的最新返回记录”,不能因为请求成功,就把页头标成“刚刚成交”。我们没有核定这一条记录对应的具体市场阶段,也没有把它称为正式收盘价。
这次只是最小取数核验,运行环境不是一套已上线的云服务。真正上服务器时,还要验证该机器的网络、凭据读取、重启后的恢复,以及连续观察期间的数据更新。
这里选择TickDB港股行情API作为直接请求的实例:使用API密钥访问HTTP接口,取得港股快照输入,不需要在本次请求中启动券商网关。它解决的是这一步的接入组件问题;团队使用或向客户展示的权限,应按具体用途另外确认。
把最小请求带到自己的服务器
Python 3.9及以上,并安装requests(pip install requests)。先通过自己的安全配置提供环境变量TICKDB_API_KEY,不要把密钥写进代码或日志。下面查询的是快照,每次运行结果和时间会随实际返回变化。
import os, requests
from datetime import datetime
from zoneinfo import ZoneInfo
r = requests.get("https://api.tickdb.ai/v1/market/ticker",
params={"symbols": "700.HK", "type": "stock"},
headers={"X-API-Key": os.environ["TICKDB_API_KEY"]}, timeout=20)
r.raise_for_status()
result = r.json()
if result["code"] != 0:
raise RuntimeError(result.get("message", "Quote request failed"))
rows = [x for x in result["data"] if x.get("symbol") == "700.HK"]
if len(rows) != 1:
raise RuntimeError("Expected exactly one 700.HK record")
x = rows[0]
stamp = datetime.fromtimestamp(x["timestamp"] / 1000,
ZoneInfo("Asia/Hong_Kong"))
print(x["symbol"], x["last_price"], stamp.isoformat())
本次原始响应经相同字段解析后的输出为:
700.HK 390.4 2026-11-16T16:08:13+08:00
返回价格只放在数据时间后面阅读;代码没有实现推送订阅、自动重连或后台守护。
保留旧路径,还是增加一条新路径
如果团队本来就在使用OpenD,已有维护人员,账户和行情条件满足研究任务,继续使用它完全是合理候选。不要只为了接口形式不同就迁移。
如果主要任务是把报价送进团队看板,想减少自行维护的网关组件,可以试一条直接HTTP数据路径。把它与现有路径放在同一名单、同一观察时间内比较,逐项留下记录:
- 一只股票先核身份、字段与数据时间,再扩大到实际股票池。
- 在目标服务器运行,记录失败信息;进程重启后确认能否重新取数。
- 按页面功能检查缺字段怎么办、旧数据怎样显示,不用“0”填成假价格。
- 确认实际需要的请求频率、标的数量、权限及用途,交给供应商逐项答复。
如果页面需要连续变化,快照测试通过后还要另测推送及断线恢复;不能拿一次REST调用替持续行情验收。
这份清单最后应回答一个朴素的问题:现有路径欠的是数据、权限,还是维护精力?欠什么,再补什么,选型就不必变成整套系统推倒重来。
资料:富途API《OpenD概述》《权限与额度》;TickDB《行情快照》官方文档及2026年11月16日实际响应。官方条件读取于同日。