股票查询API怎么接入代码列表行情详情与交易日判断如何分流

发布时间：2026-08-18 17:27 点击：7098次

股票查询 API 应按任务分流：先用市场分类列表取得股票代码，再按代码查询最新行情或分钟趋势；是否开市则单独调用交易日历，不能仅凭行情为空推断休市。

股票查询 API 有哪些端点

截至 2026 年 8 月 18 日，极速数据股票查询 API 官方文档列出四个端点，分别承担代码列表、分钟趋势、行情详情和交易日判断。

任务	端点	必要输入
获取市场股票列表	`https://api.jisuapi.com/stock/list`	`classid`
查询股票趋势	`https://api.jisuapi.com/stock/query`	`code`
查询行情详情	`https://api.jisuapi.com/stock/detail`	`code`
查询交易日	`https://api.jisuapi.com/stock/calendar`	`date` 可选

四个端点当前都支持 GET 和 POST。它们返回的是不同业务对象，不能用一个“股票接口”方法把所有响应强行映射成相同结构。

怎样先建立股票代码列表

列表端点按 classid 区分市场：1 为沪深股市，3 为港股，4 为北证 A 股。pagenum 默认 1，pagesize 默认 30。

curl --get "https://api.jisuapi.com/stock/list" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "classid=1" \
  --data-urlencode "pagenum=1" \
  --data-urlencode "pagesize=30"

返回结果包含当前页、每页数量、总数，以及股票名称和代码列表。官方示例响应还出现 classid，但返回参数表没有单独列出该字段；接入时可以按可选字段读取，不能把示例中的存在扩大为稳定必返承诺。

业务数据库应至少用“市场分类 + 股票代码”作为来源身份，避免只按名称去重。股票名称可能调整，同一数字代码在不同市场的解释也不应由系统擅自合并。列表同步时保留首次发现、最后发现和来源市场，缺失记录先标记停用，再根据业务规则处理历史数据。

趋势接口和详情接口怎么选

需要分钟趋势时调用 /stock/query，需要当前行情指标时调用 /stock/detail。两者都要求股票代码，但返回结构不同。

趋势请求：

curl --get "https://api.jisuapi.com/stock/query" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "code=YOUR_STOCK_CODE"

趋势响应包含名称、代码、最新价、昨收盘价、数据量、更新时间和 trend。文档说明 trend 中依次为时间、价格、成交量、成交总额和平均价。接入方应按真实响应验证它的嵌套结构和数据类型，不能只凭说明将其当作固定字符串拆分。

行情详情请求：

curl --get "https://api.jisuapi.com/stock/detail" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "code=YOUR_STOCK_CODE"

详情字段包括最新价、最高价、最低价、成交量、成交额、换手率、开盘价、昨收盘价、涨跌幅、涨跌额、振幅、量比、市盈率、市净率和更新时间。文档将这些返回字段列为字符串，业务侧应先保存来源文本，再按实际格式转换为数值。

价格、比例和成交数据不能使用同一解析规则。例如涨跌幅可能需要去除格式符后再存储，成交量字段又注明单位为“手”。转换失败时应保留原始值并标记未知，不要默认为 0，因为 0 与缺失具有不同含义。

交易日历为什么要单独调用

交易日历端点用于判断指定日期的大陆股市与香港股市是否开市，date 为可选字符串。返回字段包括 cntrading、hktrading 和日期，其中 1 表示开市，0 表示不开市。

curl --get "https://api.jisuapi.com/stock/calendar" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "date=YOUR_DATE"

不要用“行情没有变化”或“趋势为空”判断休市，因为无数据还可能来自代码错误、权限问题、接口异常或尚未更新。正确流程是先以交易日历确定市场日期状态，再处理行情结果。

同一天大陆股市与香港股市的状态可能不同，业务侧应按证券所属市场选择对应字段。当前文档没有列出半日市、临时停牌或单只证券交易状态字段，因此 cntrading 或 hktrading 只能说明市场层面的日期状态，不能证明某只股票当日一定可交易。

行情数据怎样缓存和版本化

所有行情记录都应同时保存接口返回的 updatetime 和系统抓取时间。前者表示来源标注的数据时间，后者表示系统何时取得结果；两者不能互相替代。

列表数据、行情详情和趋势数据适合分表或分对象保存：

{
  "source": "jisuapi-stock",
  "marketClassId": "SOURCE_CLASS_ID",
  "code": "SOURCE_CODE",
  "sourceUpdatedAt": "SOURCE_UPDATE_TIME",
  "fetchedAt": "ISO_TIMESTAMP"
}

这是自有系统的索引示例，不是官方响应。缓存周期应由业务对时效性的要求、调用限制和授权共同确定，不能写成官方刷新频率。若旧缓存用于降级，页面必须标出来源更新时间，避免将过期行情展示成实时价格。

趋势数据如果用于图表，还要验证时间顺序、重复点和缺失点。不要自行插值后继续标成原始行情；确需补点时，应把原始序列和业务侧生成序列明确分开。