通用规则
行情字段说明
行情里每个字段的含义。WebSocket 推送的行情消息(Msg)和 HTTP 报价接口返回的行情(data 或 Msg)是同一份内容,都按这一页来读。字段分三组:核心字段、只有部分市场有的字段、可能缺失或者无意义的内容。
一、核心字段 最常用,15 个
| 字段 | 名称 | 说明 |
|---|---|---|
| code | 产品代码 | |
| name | 名称 | |
| Market | 市场代码 | |
| varieties | 品种 | 产品类型或品种,如 XNAS_CS、COMEXGC |
| price | 最新价 | 符合交易的最新价(今日收盘价) |
| open | 今开 | |
| high | 今高 | |
| low | 今低 | |
| close | 昨收 | 昨日收盘价,而非当前收盘价 |
| change | 涨跌 | 最新价 − 昨收;有昨结的品种是最新价 − 昨结 |
| up | 涨跌幅 | 百分比数值,1.02 表示 1.02% |
| volume | 成交量 | 当日累计 |
| NV | 现量 | 最近一笔成交的量 |
| tick | 时间 | Unix 秒 |
| T | 是否正常交易 | 日期(yyyy-MM-dd)。和当前时间相差 7 天,这只股票可能已经退市;仅股票有效 |
二、部分市场有的字段 只有一部分市场或品种返回,37 个
| 字段 | 名称 | 说明 |
|---|---|---|
| B1 ~ B5 | 买一 ~ 买五价 | |
| B1V ~ B5V | 买一 ~ 买五量 | |
| S1 ~ S5 | 卖一 ~ 卖五价 | |
| S1V ~ S5V | 卖一 ~ 卖五量 | |
| dealTransaction | 逐笔交易 | 依次是 时间(秒)、价格、量、方向、序号、时间(毫秒),用逗号隔开 |
| LP | 盘前、盘中、盘后最新价 | 仅美股支持,它是美国最新价的常用字段,也可以使用 odd |
| odd | 碎股交易 | 在美股 LP 的基础上增加了碎股交易,价格可能会超出当日最高价或最低价 |
| amount | 成交额 | 当日累计 |
| YS | 昨结 | 昨天的结算价 |
| settle | 结算价 | 仅期货支持 |
| position | 持仓 | 未平仓的合约数 |
| contract | 合约 | 合约月份或合约标识 |
| average | 均价 | |
| amplitude | 振幅 | (今高 − 今低)÷ 最新价 |
| turnoverRate | 换手率 | |
| YDP | 昨持仓 | 仅期货支持 |
| PDV | 昨日成交量 | 仅期货支持 |
| internalOrder | 内盘 | |
| exteriorOrder | 外盘 | |
| MRTA | 交易方向 | 1 买,2 卖 |
| ticks | 时间 | 毫秒 |
三、可能缺失的内容或者无意义内容 27 个
| 字段 | 名称 | 说明 |
|---|---|---|
| DTE | 距到期天数 | |
| raisingLimit | 涨停价 | 仅 A 股支持 |
| limitDown | 跌停价 | 仅 A 股支持 |
| marketValue | 总市值 | |
| mcc | 流通市值 | |
| PBR | 市净率 | |
| LYR | 静态市盈率 | |
| ChangeA | 与昨收的差 | 最新价 − 昨收 |
| CFO | 与今开的差 | 最新价 − 今开 |
| Range | 区间差 | 今高 − 今低 |
| VWAP | 成交量加权平均价 | |
| INDEX | 成交序号 | |
| DOWNUP | 涨跌方向 | 173 表示向上,其它表示向下 |
| Message | 本次更新的内容 | C 最后一笔合格成交,o 其它成交,b 买价更新,a 卖价更新 |
| DLP | 价格精度 | 小数位数 |
| ZC | 日增仓 | |
| NAV | 基金净值 | |
| POAV | 成交量百分比 | 当前总成交量 ÷ 平均成交量 |
| Varieties | 品种 | 同 varieties |
| lp | 最新价 | 同 price |
| ZDT | ||
| OCB1 | ||
| OCS1 | ||
| QR | ||
| a | ||
| TTM | ||
| MYTJ |
- 没有值的字段可能是空字符串。
- 同一个字段可能是数字,也可能是字符串,使用前统一转换。
示例:AAPL、TSLA
GET
/mini_prices?market=NASDAQ&symbol=AAPL,TSLA请求头 Authorization: 你的密钥 · HTTP 200
[
{
"status": 0, // 0 成功,500 失败
"interval": null, // K 线周期,只有 K 线接口有值
"market": "NASDAQ", // 市场代码
"code": "AAPL", // 产品代码
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": { // 行情内容,字段含义见「行情字段说明」
"code": "AAPL", // 产品代码
"name": "Apple Inc.", // 名称
"Market": "NASDAQ", // 市场代码
"varieties": "XNAS_CS", // 品种
"price": 333.69, // 最新价
"open": 333.26, // 今开
"high": 334.54, // 今高
"low": 330.61, // 今低
"volume": 68359.326131, // 成交量,当日累计
"close": 330.32, // 昨收:昨日收盘价,而非当前收盘价
"average": 332.7092, // 均价
"amount": "22743776.7096", // 成交额,当日累计
"up": "1.020", // 涨跌幅(%)
"change": "3.370", // 涨跌
"LP": 332.6, // 盘前、盘中、盘后最新价
"odd": 332.5332, // 碎股交易
"NV": 0.203149, // 现量,最近一笔成交的量
"MT": "2",
"MRTA": "2", // 交易方向:1 买,2 卖
"dealTransaction": "1791196790,332.5332,0.203149,2,", // 逐笔交易:时间(秒),价格,量,方向,序号,时间(毫秒)
"B1": 332.53, // 买一价
"B1V": 240, // 买一量
"S1": 332.66, // 卖一价
"S1V": 40, // 卖一量
"ticks": 1791196790429, // 时间,毫秒
"tick": 1791196790, // 时间,Unix 秒
"a": "12,37",
"T": "2026-10-05" // 是否正常交易:日期,和当前时间相差 7 天可能已退市
}
},
{
"status": 0, // 0 成功,500 失败
"interval": null, // K 线周期,只有 K 线接口有值
"market": "NASDAQ", // 市场代码
"code": "TSLA", // 产品代码
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": { // 行情内容,字段含义见「行情字段说明」
"code": "TSLA", // 产品代码
"name": "Tesla, Inc. Common Stock", // 名称
"Market": "NASDAQ", // 市场代码
"varieties": "XNAS_CS", // 品种
"price": 370.59, // 最新价
"open": 360.08, // 今开
"high": 374.6, // 今高
"low": 359.411, // 今低
"volume": 238802.135094, // 成交量,当日累计
"close": 354.11, // 昨收:昨日收盘价,而非当前收盘价
"average": 371.256, // 均价
"amount": "88656725.4665", // 成交额,当日累计
"up": "4.654", // 涨跌幅(%)
"change": "16.480", // 涨跌
"LP": 369.63, // 盘前、盘中、盘后最新价
"odd": 369.68, // 碎股交易
"NV": 3, // 现量,最近一笔成交的量
"MT": "2",
"MRTA": "2", // 交易方向:1 买,2 卖
"dealTransaction": "1791196803,369.68,3,2,", // 逐笔交易:时间(秒),价格,量,方向,序号,时间(毫秒)
"B1": 369.63, // 买一价
"B1V": 40, // 买一量
"S1": 369.86, // 卖一价
"S1V": 40, // 卖一量
"ticks": 1791196803317, // 时间,毫秒
"tick": 1791196803, // 时间,Unix 秒
"a": "14,12,37,41",
"T": "2026-10-05" // 是否正常交易:日期,和当前时间相差 7 天可能已退市
}
}
]
示例:COMEXGC
GET
/mini_prices?market=COMEX&symbol=COMEXGC请求头 Authorization: 你的密钥 · HTTP 200
[
{
"status": 0, // 0 成功,500 失败
"interval": null, // K 线周期,只有 K 线接口有值
"market": "COMEX", // 市场代码
"code": "COMEXGC", // 产品代码
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": { // 行情内容,字段含义见「行情字段说明」
"Market": "COMEX", // 市场代码
"varieties": "COMEXGC", // 品种
"contract": "COMEXGC", // 合约
"open": "4169.4", // 今开
"high": "4198.9", // 今高
"low": "4152.3", // 今低
"price": "4186.5", // 最新价
"close": "4162.3", // 昨收:昨日收盘价,而非当前收盘价
"volume": "50050", // 成交量,当日累计
"tick": "1791197283", // 时间,Unix 秒
"NV": "1", // 现量,最近一笔成交的量
"amplitude": "0.011131", // 振幅
"marketValue": "", // 总市值
"position": "324685", // 持仓,未平仓的合约数
"TTM": "",
"YS": "4162.3", // 昨结,昨天的结算价
"DTE": "85", // 距到期天数
"MT": "1",
"Message": "C", // 本次更新的内容
"DLP": "1", // 价格精度,小数位数
"PDV": "169001", // 昨日成交量
"NAV": "", // 基金净值
"CFO": "17.1", // 与今开的差
"POAV": "", // 成交量百分比
"B1": "4186.3", // 买一价
"B1V": "3", // 买一量
"S1": "4186.5", // 卖一价
"S1V": "1", // 卖一量
"Range": "46.6", // 区间差:今高 − 今低
"DOWNUP": "173", // 涨跌方向:173 表示向上,其它表示向下
"INDEX": "13166691", // 成交序号
"VWAP": "", // 成交量加权平均价
"ChangeA": "24.2", // 与昨收的差
"MRTA": "1", // 交易方向:1 买,2 卖
"MYTJ": "",
"ticks": "1791197283493", // 时间,毫秒
"dealTransaction": "1791197272,4186.1,1,1,13166678,1791197272614", // 逐笔交易:时间(秒),价格,量,方向,序号,时间(毫秒)
"code": "COMEXGC", // 产品代码
"change": "24.2", // 涨跌
"up": "0.58141", // 涨跌幅(%)
"name": "黄金 主连" // 名称
}
}
]