S SPARKDATA
← 返回数据列表

债券

债券实时行情

BondRealTimeQuote
免费JSON支持在线试运行

接口试运行

债券实时行情

BondRealTimeQuote
管理 API Key

正在读取账户…

示例已填好,选择 API Key 后即可运行。

使用账户的现有权限与额度。字段说明独立展示,复制出的 JSON 可直接调用。

  • bondObject: 25国债17 · 019790.SH
  • 样例使用已核验的标的和字典值;返回记录取决于查询范围、数据更新及当前 Key 权限。
  • 默认请求 5 条;部分业务聚合可能返回更多记录,以实际响应为准。
示例字段说明 3
bondObject债券代码 · 必填
查询债券代码,是债券唯一标识的编码可填写准确名称或字典代码。 25国债17 (728376)
pageNo页面编号
定位分页查询的目标页码,默认值为1页码从 1 开始;样例读取第一页。
pageSize页内记录数
单页返回的最大记录条数,默认为500样例限制为 5 条,便于快速查看结果。
POST /v1/data/operations/BondRealTimeQuote

curl 调用示例(含字段注释)
# bondObject: 债券代码(必填) — 查询债券代码,是债券唯一标识的编码
# pageNo: 页面编号 — 定位分页查询的目标页码,默认值为1
# pageSize: 页内记录数 — 单页返回的最大记录条数,默认为500
curl --silent --show-error --fail-with-body --request POST \
  'https://spark-data.cn/v1/data/operations/BondRealTimeQuote' \
  --header "Authorization: Bearer ${SPARKDATA_API_KEY:?Set SPARKDATA_API_KEY first}" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data-binary '{"parameters":{"bondObject":["728376"],"pageNo":1,"pageSize":5}}'

此接口免费开放,使用账户下任一 API Key 即可查询。

数据说明

获取沪深交易所指定债券的实时行情数据,涵盖交易状态、最新价、开盘价、最高/最低价、均价、加权均价、前收盘价、成交量(手)、成交额、换手率、涨跌、涨跌幅、振幅、量比、外盘/内盘、委比/委差、涨停/跌停价等指标,为债券实时交易提供数据支持。 交易时间说明: 沪深交易所债券的连续竞价交易时间为每周一至周五(法定节假日除外)上午9:30-11:30、下午13:00-15:00。本接口在非交易时段返回当日最新的静态行情数据。 使用场景: -获取指定债券的实时价格、涨跌和成交量,用于快速了解当前价格水平与日内波动区间,评估债券的流动性及买卖力量对比,辅助判断日内价格变动幅度及市场情绪。 -返回涨停价与跌停价,用于监测价格是否临近涨跌停限制。 -支持输入多个债券代码,批量获取实时行情数据,用于组合持仓盯盘或批量策略扫描。

POST /v1/data/operations/BondRealTimeQuote · JSON

输入参数

字段类型约束说明与示例
bondObject
债券代码
文本列表
string_array
必填
按字典选择: BOND
查询债券代码,是债券唯一标识的编码

示例: ["728376"]

pageNo
页面编号
数字
number
可选定位分页查询的目标页码,默认值为1

示例: 1

pageSize
页内记录数
数字
number
可选单页返回的最大记录条数,默认为500

示例: 5

返回字段

字段类型约束说明与示例
bondObject
债券内码
文本
string
—债券唯一标识的编码

示例: 示例文本

bondAbbr
债券简称
文本
string
—债券通用的证券简称

示例: 示例文本

bondCode
债券代码
文本
string
—债券通用的证券代码

示例: 示例文本

tradingTimestamp
交易时间
日期(年-月-日)
date
—当前行情对应的交易时间点。

示例: 2026-09-30

tradeStatus
交易状态
文本
string
—指定时间戳债券的交易状态,如正常交易、停牌等。

示例: 示例文本

latestPrice
最新价(元)
数字
number
—最近一笔成交的价格。

示例: 1

openPrice
开盘价(元)
数字
number
—当日第一笔成交的价格。

示例: 1

highPrice
最高价(元)
数字
number
—当日达到的最高成交价格。

示例: 1

lowPrice
最低价(元)
数字
number
—当日达到的最低成交价格。

示例: 1

avgPrice
均价(元)
数字
number
—当日成交金额除以成交量的加权平均价。

示例: 1

weightedPrice
加权平均价(元)
数字
number
—按成交量加权的平均成交价格。

示例: 1

prevClosePrice
前收盘价(元)
数字
number
—上一个交易日的收盘价格。

示例: 1

turnoverVolumeLot
总成交量(手)
数字
number
—当日累计成交的总手数(1手=10张)。

示例: 1

realTimeVolumeLot
现手(手)
数字
number
—最近一笔成交的手数。

示例: 1

turnoverValue
成交额
数字
number
—当日累计成交的总金额。

示例: 1

turnoverRate
换手率(%)
数字
number
—成交量占流通量的比例。

示例: 1

changeOfPrice
涨跌(元)
数字
number
—最新价较前收盘的绝对变动值。

示例: 1

changePCT
涨跌幅(%)
数字
number
—最新价较前收盘的百分比变动。

示例: 1

rangePCT
振幅(%)
数字
number
—最高价与最低价之差相对于前收盘的比例。

示例: 1

volumeRate
量比
数字
number
—当前成交量与过去5日平均成交量的比值。

示例: 1

selloutVolumeLot
外盘(手)
数字
number
—主动买入的成交量(以卖价成交)。

示例: 1

buyinVolumeLot
内盘(手)
数字
number
—主动卖出的成交量(以买价成交)。

示例: 1

entrustRate
委比(%)
数字
number
—委买与委卖差额占总委託量的比例。

示例: 1

entrustDiff
委差(手)
数字
number
—委买总量与委卖总量的差值。

示例: 1

limitUpPrice
涨停价(元)
数字
number
—当日允许的最高成交价格上限。

示例: 1

limitDownPrice
跌停价(元)
数字
number
—当日允许的最低成交价格下限。

示例: 1

调用示例

已填入示例标的、必填参数与适用的分页限制。点击试运行,在右侧抽屉查看字段说明并获取真实返回。

{
  "parameters": {
    "bondObject": [
      "728376"
    ],
    "pageNo": 1,
    "pageSize": 5
  }
}
  • bondObject: 25国债17 · 019790.SH
  • 样例使用已核验的标的和字典值;返回记录取决于查询范围、数据更新及当前 Key 权限。
  • 默认请求 5 条;部分业务聚合可能返回更多记录,以实际响应为准。

覆盖与使用边界

请先运行示例,确认所需证券、日期范围和字段是否可用。可用历史范围与内容使用许可因接口而异;查询使用账户和所选 API Key 的权限与额度。

分钟周期、复权方式和时间单位请按上方参数说明填写。接口没有返回的数据不代表数值为零。