港股行情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数据路径。把它与现有路径放在同一名单、同一观察时间内比较,逐项留下记录:

  1. 一只股票先核身份、字段与数据时间,再扩大到实际股票池。
  2. 在目标服务器运行,记录失败信息;进程重启后确认能否重新取数。
  3. 按页面功能检查缺字段怎么办、旧数据怎样显示,不用“0”填成假价格。
  4. 确认实际需要的请求频率、标的数量、权限及用途,交给供应商逐项答复。

如果页面需要连续变化,快照测试通过后还要另测推送及断线恢复;不能拿一次REST调用替持续行情验收。

这份清单最后应回答一个朴素的问题:现有路径欠的是数据、权限,还是维护精力?欠什么,再补什么,选型就不必变成整套系统推倒重来。

资料:富途API《OpenD概述》《权限与额度》;TickDB《行情快照》官方文档及2026年11月16日实际响应。官方条件读取于同日。

相关文章

黄金行情API怎么选?做黄金ETF工具,光有国际金价够吗?

为黄金ETF页面或持仓工具选择黄金行情API,国际金价只是其中一项输入。本文以518880和XAUUSD的真实返回为例,结合上金所及基金公司资料,拆清ETF成交价、国际金价与基金净值的分工,给出产品数据需求表和可复算的持仓参考金额。

TickDB Research ·

AI盯盘怎么用?自选股涨超3%,收到提醒后先看什么?

自己维护股票监控的量化投资者与投研成员,常常遇到同一只股票反复触发提醒,却不知道这次该看什么。本文通过TickDB股票行情API,取得2026年11月12日寒武纪、海光信息的真实分钟行情,重放两种提醒方式,并结合公司资讯梳理后续核查顺序:先看这次新增了什么变化,再看价格处在什么位置,接着查有没有值得更新原判断的信息。附可复制监控任务卡与重放代码,方便换成自己的自选股。

TickDB Research ·