实时选股
根据服务、资产与周期选择本接口。先核对请求参数,再用响应字段和单位解释结果。
查询股票行情、涨跌停、集合竞价、资金和题材指标。支持全市场或指定股票,可查询最新数据或指定交易日;通过 fields 选择需要返回的字段。
接口用于查询;实时指标会随行情变化,同一查询在不同时刻的结果可能不同。
接口简介
查询股票行情、涨跌停、集合竞价、资金和题材指标。支持全市场或指定股票,可查询最新数据或指定交易日;通过 fields 选择需要返回的字段。
接口用于查询;实时指标会随行情变化,同一查询在不同时刻的结果可能不同。
调用方式
| 项目 | 内容 |
|---|---|
| 请求方法 | POST |
| 请求格式 | application/json |
| 接口名称 | screening |
| 深圳日内节点 | https://sz.meoz.cn:6688/api |
| 上海日内节点 | https://sh.meoz.cn:6688/api |
| 鉴权方式 | 在请求体 apikey 中填写你的 API Key |
数据范围、权限与频率
文档登记的可用套餐:pro / flagship;数据起始月份:2017-01。
| 账户频率限制 | 统计窗口 |
|---|---|
| 500 次 | 60 秒 |
| 5 次 | 1 秒 |
以上为当前发布文档登记的限制;调用时还需满足账户实际权益和额度。收到 HTTP 429 时,按响应中的 Retry-After 等待后重试。
请求参数
请求体参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
apikey |
string |
是 | 空字符串;调用时填写有效密钥 | 猫爪数据 API Key。网页在线调试会为已登录用户自动注入,其他调用请从控制台获取。 |
apiname |
string |
是 | screening |
固定填写 screening |
fields |
string / null |
否 | 见下方默认返回字段 | 选择要返回的字段,多个字段用英文逗号分隔。 |
params |
object |
否 | 未指定 | 查询条件对象,包含下面列出的业务查询参数;未指定日期时按最新交易日查询。 |
业务查询参数(params)
| 参数 | 类型 | 必填 | 约束与说明 | 示例 |
|---|---|---|---|---|
symbols |
string / array<string> |
否 | 股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。 | 000001,600000 |
tradedate |
string |
否 | 查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。 | 20260724 |
startdate |
string |
否 | 查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。 | 20260701 |
enddate |
string |
否 | 查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。 | 20260724 |
recentdays |
integer |
否 | 最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。 最小值:1。 | 5 |
tradedate_offset |
integer |
否 | 相对最新交易日的单日偏移,0 表示最新交易日,-1 表示上一交易日。 最大值:0。 | -1 |
日期参数使用 YYYYMMDD 格式。recentdays 不能与 tradedate/startdate/enddate 同时传;tradedate 不能与 startdate/enddate 同时传。
默认返回字段
不指定 fields 时,使用以下默认字段;也可以从下方完整字段表中选择需要的字段,用英文逗号连接。
tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f,free_float_mv,type,limit_times,fd_amount,auc_pct_chg,auc_net_amount,auc_amt,theme_names_kpl,reason_main_kpl
返回结构
成功响应包含 code、message 和 data。
| 字段 | 类型 | 说明 |
|---|---|---|
code |
integer |
业务状态码,成功时为 200;错误码见下表。 |
message |
string |
请求结果说明或错误原因。 |
data |
object / null |
成功时返回的数据对象。 |
data.fields |
array<string> |
返回字段名列表,由请求体 fields 指定。 |
data.items |
array<array> |
数据行列表;每行的值按 data.fields 的顺序排列,字段类型见请求体 fields 列表。 |
每个 items 数据行的第 N 个值,对应 fields 中第 N 个字段。请求 fields 的字段代码也就是下方表格的“字段代码”;不是字段中文名称。
返回字段
以下完整列出 84 个可选字段。number 表示数值,string 表示文本,integer 表示整数。“可空”为“是”时,该字段允许返回 null。
基础信息
| 字段代码 | 中文名称 | 类型 | 可空 | 说明 | 示例 |
|---|---|---|---|---|---|
tradedate |
交易日期 | string |
否 | 日期格式:YYYYMMDD。 | 20260724 |
symbol |
股票代码 | string |
否 | 6 位股票代码。 | 000001 |
name |
股票名称 | string |
是 | 股票简称。 | 平安银行 |
is_st |
是否 ST | string / boolean |
是 | 股票的 ST 状态标识。 | null |
code |
完整证券代码 | string |
是 | 含交易所后缀,如 000001.SZ。历史查询返回当前证券代码;缺失返回 null。 | 000001.SZ |
area |
地域 | string |
是 | 股票当前所属地域。历史查询也使用当前资料;缺失返回 null。 | 深圳 |
market |
上市板块 | string |
是 | 股票当前上市板块,如主板、创业板、科创板。历史查询也使用当前资料;缺失返回 null。 | 主板 |
行情数据
| 字段代码 | 中文名称 | 类型 | 可空 | 说明 | 示例 |
|---|---|---|---|---|---|
open |
开盘价(元) | number |
是 | 当前周期的开盘价。 | 12.35 |
high |
最高价(元) | number |
是 | 当前周期的最高价。 | 12.68 |
low |
最低价(元) | number |
是 | 当前周期的最低价。 | 12.21 |
close |
收盘价(元) | number |
是 | 最新交易日盘中为最新价,历史周期为收盘价。 | 12.56 |
change |
涨跌额(元) | number |
是 | 收盘价或最新价与昨收价之差。 | 0.25 |
pct_chg |
涨跌幅(%) | number |
是 | 相对昨收价的涨跌幅。 | 2.03 |
vol |
成交量(手) | number |
是 | 当前周期的累计成交量。 | 1234567 |
amount |
成交额(元) | number |
是 | 当前周期的累计成交金额。 | 1543210987.65 |
up_limit |
涨停价(元) | number |
是 | 当日涨停价格。 | 13.54 |
down_limit |
跌停价(元) | number |
是 | 当日跌停价格。 | 11.08 |
turnover_rate_f |
实际换手率(%) | number |
是 | 按自由流通股本计算的换手率。 | null |
volume_ratio |
量比 | number |
是 | 当前成交量相对近期平均成交量的倍数。 | null |
free_float_mv |
自由流通市值(元) | number |
是 | 按自由流通股本计算的市值。 | null |
circ_mv |
流通市值(元) | number |
是 | 按流通股本计算的市值。 | null |
total_mv |
总市值(元) | number |
是 | 按总股本计算的市值。 | null |
main_net_amount |
主力净额(元) | number |
是 | 开盘啦当日累计的主力买卖净额,正值为净流入,负值为净流出。与 auc_net_amount 口径不同;缺失返回 null,真实零保留为 0。 | 138000000 |
集合竞价
| 字段代码 | 中文名称 | 类型 | 可空 | 说明 | 示例 |
|---|---|---|---|---|---|
m_price |
竞价撮合价 | number |
是 | 集合竞价的撮合成交价格。 | null |
auc_pct_chg |
竞价涨幅(%) | number |
是 | 集合竞价相对昨收价的涨跌幅。 | null |
auc_net_amount |
竞价净额(元) | number |
是 | 集合竞价的净额指标,单位元。 | null |
auc_amt |
竞价成交额(元) | number |
是 | 集合竞价的成交金额。 | null |
auc_vol |
竞价成交量(手) | number |
是 | 集合竞价的成交量。 | null |
auc_turnover |
真实竞价换手率(%) | number |
是 | 集合竞价阶段的实际换手率。 | null |
ztwme |
涨停委买额(元) | number |
是 | 涨停价位的委买金额。 | null |
ztwme20 |
20分后涨停委买额(元) | number |
是 | 20分后的涨停价位委买金额。 | null |
fa_0915 |
0915 封单额(元) | number |
是 | 09:15 的封单金额。 | null |
fa_0920f |
20分后封单额(元) | number |
是 | 20分后的封单金额。 | null |
fa_0925l |
开盘封单额(元) | number |
是 | 开盘时的封单金额。 | null |
auc_vol_ratio |
竞价量比 | number |
是 | 竞价成交量 ÷ 前五个交易日平均每分钟成交量(五日总量 ÷ 1200)。09:25 前使用买一匹配量;分母缺失或为 0 返回 null。 | 2.14 |
um_vol |
竞价未匹配量(手) | number |
是 | 竞价买二、卖二未匹配量中的较大值,不表示买卖方向。盘口缺失返回 null,真实零保留为 0。 | 86000 |
auction_main_net_amount |
竞价主力净额(元) | number |
是 | 开盘啦当日竞价阶段的主力买卖净额,正值为净流入,负值为净流出。与 auc_net_amount 口径不同;缺失返回 null,真实零保留为 0。 | 138000000 |
涨停打板
| 字段代码 | 中文名称 | 类型 | 可空 | 说明 | 示例 |
|---|---|---|---|---|---|
type |
涨跌停池类型 | string |
是 | u=涨停、d=跌停、ub=涨停炸板、db=跌停炸板。 | u |
is_break |
是否炸板 | boolean |
是 | true 表示炸板,false 表示未炸板。 | False |
limit_times |
连续涨跌停天数 | integer |
是 | 涨停为正、跌停为负、非封板为 0。 | 2 |
fd_amount |
封单额(元) | number |
是 | 封单额(元):涨停取买一、跌停取卖一,非封板或盘口无效返回 null。 | null |
fd_to_turnover |
封成比 | number |
是 | 封成比 | null |
first_time |
首次封板时间 | string |
是 | 格式:HH:mm:ss。 | 09:31:16 |
last_time |
最后封板时间 | string |
是 | 格式:HH:mm:ss。 | 14:42:08 |
open_times |
炸板次数 | integer |
是 | 当日涨停或跌停封板后被打开的次数。真实零保留为 0;不适用或缺失返回 null。 | 1 |
limit_type |
板型编码 | integer |
是 | 1=一字板,2=T字涨停,3=反包涨停,4=换手板,5=天地板,6=地天板,7=其他跌停,9=反包跌停。8 须结合 type 判断:涨停时为其他涨停,跌停时为 T字跌停。无有效板型返回 null。 | 4 |
昨日数据
| 字段代码 | 中文名称 | 类型 | 可空 | 说明 | 示例 |
|---|---|---|---|---|---|
pre_close |
昨收价(元) | number |
是 | 前复权可比昨收价;最新交易日作为实时涨幅基准价。 | 12.31 |
pre_limit_times |
上一交易日连续涨跌停天数 | integer |
是 | 方向符号与 limit_times 相同;无有效前日时返回 null。 | 1 |
pre_fd_amount |
昨日封单额(元) | number |
是 | 上一交易日的封单金额。 | null |
prev_fd_amount |
前日封单额(元) | number |
是 | 前日的封单金额。 | null |
fd_to_yesterday |
封昨比 | number |
是 | 封昨比 | null |
pre_pct_chg |
昨日涨跌幅(%) | number |
是 | 上一交易日涨跌幅,1.25 表示 1.25%。停复牌股票的实时查询可能使用最近可用行情;缺失返回 null。 | 1.25 |
pre_amount |
昨日成交额(元) | number |
是 | 上一交易日全天成交额。停复牌股票的实时查询可能使用最近可用行情;缺失返回 null。 | 1250000000 |
pre_vol |
昨日成交量(手) | number |
是 | 上一交易日全天成交量。停复牌股票的实时查询可能使用最近可用行情;缺失返回 null。 | 1234567 |
prev_turnover_rate_f |
昨日实际换手率(%) | number |
是 | 上一交易日实际换手率,口径与 turnover_rate_f 一致。停复牌股票的实时查询可能使用最近可用指标;缺失返回 null。 | 6.81 |
pre_auc_vol |
昨日竞价成交量(手) | number |
是 | 上一交易日的竞价成交量;缺失返回 null。 | 200000 |
auc_to_pre_vol_pct |
竞昨成交比(%) | number |
是 | 竞价成交量 ÷ 昨日成交量 × 100。停复牌股票的实时查询可能使用最近可用成交量;分母缺失或为 0 返回 null。 | 2.72 |
auc_to_pre_auc_vol_ratio |
竞昨量比 | number |
是 | 竞价成交量 ÷ 昨日竞价成交量,单位为倍。分母缺失或为 0 返回 null。 | 1.42 |
pre_type |
昨日涨跌停池类型 | string |
是 | 上一交易日类型:u/u1/u1n/ul=涨停相关,d=跌停,ub/db=涨停/跌停炸板,bu/bd=大涨/大跌。不适用或缺失返回 null。 | u |
pre_main_net_amount |
昨日主力净额(元) | number |
是 | 开盘啦上一交易日累计的主力买卖净额,正值为净流入,负值为净流出。与 auc_net_amount 口径不同;缺失返回 null,真实零保留为 0。 | 138000000 |
pre_auction_main_net_amount |
昨日竞价主力净额(元) | number |
是 | 开盘啦上一交易日竞价阶段的主力买卖净额,正值为净流入,负值为净流出。与 auc_net_amount 口径不同;缺失返回 null,真实零保留为 0。 | 138000000 |
pre_ztwme |
昨日涨停委买额(元) | number |
是 | 上一交易日的涨停委买额。缺失或未达金额门槛返回 null。 | 72427532 |
prev_ztwme |
前日涨停委买额(元) | number |
是 | 前两个交易日的涨停委买额。缺失或未达金额门槛返回 null。 | 72427532 |
实时热搜
| 字段代码 | 中文名称 | 类型 | 可空 | 说明 | 示例 |
|---|---|---|---|---|---|
hot_ths_normal_rank |
同花顺热度排名 | integer |
是 | 同花顺热股榜排名。 | 8 |
hot_dfcf_biaos_rank |
东方财富热度排名 | integer |
是 | 东方财富飙升榜排名。 | 12 |
hot_xq_resou_rank |
雪球热度排名 | integer |
是 | 雪球热搜榜排名。 | 5 |
hot_tdx_resou_rank |
通达信热度排名 | integer |
是 | 通达信热搜榜排名。 | 9 |
选股宝
| 字段代码 | 中文名称 | 类型 | 可空 | 说明 | 示例 |
|---|---|---|---|---|---|
theme_names_xgb |
选股宝题材 | string |
是 | 选股宝来源的当日题材名称。 | null |
reason_xgb |
选股宝涨停原因 | string |
是 | 选股宝来源的涨停原因。 | null |
theme_symbols_xgb |
选股宝当日题材代码 | string |
是 | 选股宝当日涨停题材代码,仅适用于该来源。多个代码用英文逗号分隔;无有效题材返回 null。 | 85945106x |
latest_theme_symbols_xgb |
选股宝近期题材代码 | string |
是 | 截至查询日期的近 180 个交易日中,最近一次有效涨停的选股宝题材代码。多个代码用英文逗号分隔;无记录返回 null。 | 85945106x |
latest_theme_names_xgb |
选股宝近期题材名称 | string |
是 | 与同来源近期题材代码对应的题材名称。多个名称用英文逗号分隔;名称缺失返回 null。 | 人工智能,机器人 |
开盘啦
| 字段代码 | 中文名称 | 类型 | 可空 | 说明 | 示例 |
|---|---|---|---|---|---|
theme_names_kpl |
开盘啦题材 | string |
是 | 开盘啦来源的当日题材名称。 | null |
reason_kpl |
开盘啦涨停原因 | string |
是 | 开盘啦来源的涨停原因。 | null |
reason_main_kpl |
开盘啦关键因素 | string |
是 | 开盘啦来源的核心驱动因素。 | null |
theme_symbols_kpl |
开盘啦当日题材代码 | string |
是 | 开盘啦当日涨停题材代码,仅适用于该来源。多个代码用英文逗号分隔;无有效题材返回 null。 | 85945106k |
latest_theme_symbols_kpl |
开盘啦近期题材代码 | string |
是 | 截至查询日期的近 180 个交易日中,最近一次有效涨停的开盘啦题材代码。多个代码用英文逗号分隔;无记录返回 null。 | 85945106k |
latest_theme_names_kpl |
开盘啦近期题材名称 | string |
是 | 与同来源近期题材代码对应的题材名称。多个名称用英文逗号分隔;名称缺失返回 null。 | 人工智能,机器人 |
韭菜公社
| 字段代码 | 中文名称 | 类型 | 可空 | 说明 | 示例 |
|---|---|---|---|---|---|
theme_names_jygs |
韭菜公社题材 | string |
是 | 韭菜公社来源的当日题材名称。 | null |
reason_jygs |
韭菜公社涨停原因 | string |
是 | 韭菜公社来源的涨停原因。 | null |
reason_main_jygs |
韭菜公社关键因素 | string |
是 | 韭菜公社来源的核心驱动因素。 | null |
theme_symbols_jygs |
韭菜公社当日题材代码 | string |
是 | 韭菜公社当日涨停题材代码,仅适用于该来源。多个代码用英文逗号分隔;无有效题材返回 null。 | 85945106j |
latest_theme_symbols_jygs |
韭菜公社近期题材代码 | string |
是 | 截至查询日期的近 180 个交易日中,最近一次有效涨停的韭菜公社题材代码。多个代码用英文逗号分隔;无记录返回 null。 | 85945106j |
latest_theme_names_jygs |
韭菜公社近期题材名称 | string |
是 | 与同来源近期题材代码对应的题材名称。多个名称用英文逗号分隔;名称缺失返回 null。 | 人工智能,机器人 |
调用示例
以下请求沿用已发布定义中的示例;将 YOUR_API_KEY 替换为自己的密钥。日期与股票代码是示例输入,未在本次任务中调用线上行情接口。
最新全市场(latest)
不传日期和股票代码,查询最新交易日的全市场标的;盘中返回实时数据。
{
"apikey": "YOUR_API_KEY",
"fields": "tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f",
"params": {},
"apiname": "screening"
}
指定股票(symbols)
只查询指定股票的最新交易日数据;多个代码用英文逗号分隔。
{
"apikey": "YOUR_API_KEY",
"fields": "tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f",
"params": {
"symbols": "000001,600000"
},
"apiname": "screening"
}
指定交易日(date)
查询指定股票在某个交易日的数据。日期为示例值,可按需替换。
{
"apikey": "YOUR_API_KEY",
"fields": "tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f",
"params": {
"symbols": "000001",
"tradedate": "20260724"
},
"apiname": "screening"
}
最近 N 个交易日(recent)
查询指定股票最近 5 个交易日的数据;recentdays 不与显式日期同时使用。
{
"apikey": "YOUR_API_KEY",
"fields": "tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f",
"params": {
"symbols": "000001",
"recentdays": 5
},
"apiname": "screening"
}
日期区间(range)
查询指定股票在起止日期范围内的数据;startdate/enddate 不与 tradedate 同时使用。
{
"apikey": "YOUR_API_KEY",
"fields": "tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f",
"params": {
"enddate": "20260724",
"symbols": "000001",
"startdate": "20260701"
},
"apiname": "screening"
}
Python 调用
import requests
payload = {'apikey': 'YOUR_API_KEY', 'fields': 'tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f', 'params': {}, 'apiname': 'screening'}
response = requests.post(
"https://sz.meoz.cn:6688/api",
json=payload,
timeout=30,
)
response.raise_for_status()
result = response.json()
print(result)
成功返回示例
以下是从发布文档中的示例值组合出的结构示意,不是本次实时查询结果。
{
"code": 200,
"message": "success",
"data": {
"fields": [
"tradedate",
"symbol",
"name",
"close",
"pct_chg",
"amount",
"turnover_rate_f",
"free_float_mv",
"type",
"limit_times",
"fd_amount",
"auc_pct_chg",
"auc_net_amount",
"auc_amt",
"theme_names_kpl",
"reason_main_kpl"
],
"items": [
[
"20260724",
"000001",
"平安银行",
12.56,
2.03,
1543210987.65,
2.35,
9850000000.25,
"u",
2,
358000000.12,
1.23,
45800000.25,
58000000.25,
"机器人、人工智能",
"机器人"
]
]
}
}
错误与处理
需要同时检查 HTTP 状态和响应体中的 code;部分业务错误仍以 HTTP 200 返回。
| 业务码 | HTTP 状态 | 含义 | 处理建议 |
|---|---|---|---|
401 |
200 |
API Key 缺失或无效 | 检查请求体 apikey,确认密钥有效。 |
403 |
200 |
API Key 已停用、接口权限不足或调用额度受限 | 查看 message,检查密钥状态、套餐及剩余额度。 |
422 |
200 / 422 |
请求参数校验失败 | 检查必填字段、JSON 类型、日期格式、互斥参数及字段名;HTTP 422 表示进入业务处理前的校验失败。 |
429 |
429 |
请求频率超限 | 降低并发,按 Retry-After 等待后重试。 |
1002 |
200 |
未找到选股数据 | 检查股票代码、交易日期及数据覆盖范围。 |
1004 |
200 |
不支持的接口名称 | 确认 apiname 为 screening。 |
1000 |
200 |
选股查询或内部处理失败 | 保留 message、调用时间及参数,稍后重试;持续失败联系支持。 |
503 |
200 |
调用额度或计数服务暂不可用 | 稍后重试;持续失败联系支持。 |
500 |
500 |
未捕获的服务异常 | 稍后重试,并提供调用时间及返回信息。 |
接口名称 screening
请求方法 POST /api
- https://sz.meoz.cn:6688
- https://sh.meoz.cn:6688
返回字段
| 字段 | 名称 | 类型 | 描述 | 单位 |
|---|---|---|---|---|
| tradedate | 交易日期 | string | 日期格式:YYYYMMDD。 | |
| symbol | 股票代码 | string | 6 位股票代码。 | |
| name | 股票名称 | string|null | 股票简称。 | |
| is_st | 是否 ST | string|boolean|null | 股票的 ST 状态标识。 | |
| code | 完整证券代码 | string|null | 含交易所后缀,如 000001.SZ。历史查询返回当前证券代码;缺失返回 null。 | |
| area | 地域 | string|null | 股票当前所属地域。历史查询也使用当前资料;缺失返回 null。 | |
| market | 上市板块 | string|null | 股票当前上市板块,如主板、创业板、科创板。历史查询也使用当前资料;缺失返回 null。 | |
| open | 开盘价(元) | number|null | 当前周期的开盘价。 | |
| high | 最高价(元) | number|null | 当前周期的最高价。 | |
| low | 最低价(元) | number|null | 当前周期的最低价。 | |
| close | 收盘价(元) | number|null | 最新交易日盘中为最新价,历史周期为收盘价。 | |
| change | 涨跌额(元) | number|null | 收盘价或最新价与昨收价之差。 | |
| pct_chg | 涨跌幅(%) | number|null | 相对昨收价的涨跌幅。 | |
| vol | 成交量(手) | number|null | 当前周期的累计成交量。 | |
| amount | 成交额(元) | number|null | 当前周期的累计成交金额。 | |
| up_limit | 涨停价(元) | number|null | 当日涨停价格。 | |
| down_limit | 跌停价(元) | number|null | 当日跌停价格。 | |
| turnover_rate_f | 实际换手率(%) | number|null | 按自由流通股本计算的换手率。 | |
| volume_ratio | 量比 | number|null | 当前成交量相对近期平均成交量的倍数。 | |
| free_float_mv | 自由流通市值(元) | number|null | 按自由流通股本计算的市值。 | |
| circ_mv | 流通市值(元) | number|null | 按流通股本计算的市值。 | |
| total_mv | 总市值(元) | number|null | 按总股本计算的市值。 | |
| main_net_amount | 主力净额(元) | number|null | 开盘啦当日累计的主力买卖净额,正值为净流入,负值为净流出。与 auc_net_amount 口径不同;缺失返回 null,真实零保留为 0。 | |
| m_price | 竞价撮合价 | number|null | 集合竞价的撮合成交价格;该字段的单位、数值尺度或源口径尚未确认;不据名称推定。 | |
| auc_pct_chg | 竞价涨幅(%) | number|null | 集合竞价相对昨收价的涨跌幅。 | |
| auc_net_amount | 竞价净额(元) | number|null | 集合竞价的净额指标,单位元。 | |
| auc_amt | 竞价成交额(元) | number|null | 集合竞价的成交金额。 | |
| auc_vol | 竞价成交量(手) | number|null | 集合竞价的成交量。 | |
| auc_turnover | 真实竞价换手率(%) | number|null | 集合竞价阶段的实际换手率。 | |
| ztwme | 涨停委买额(元) | number|null | 涨停价位的委买金额。 | |
| ztwme20 | 20分后涨停委买额(元) | number|null | 20分后的涨停价位委买金额。 | |
| fa_0915 | 0915 封单额(元) | number|null | 09:15 的封单金额。 | |
| fa_0920f | 20分后封单额(元) | number|null | 20分后的封单金额。 | |
| fa_0925l | 开盘封单额(元) | number|null | 开盘时的封单金额。 | |
| auc_vol_ratio | 竞价量比 | number|null | 竞价成交量 ÷ 前五个交易日平均每分钟成交量(五日总量 ÷ 1200)。09:25 前使用买一匹配量;分母缺失或为 0 返回 null。 | |
| um_vol | 竞价未匹配量(手) | number|null | 竞价买二、卖二未匹配量中的较大值,不表示买卖方向。盘口缺失返回 null,真实零保留为 0。 | |
| auction_main_net_amount | 竞价主力净额(元) | number|null | 开盘啦当日竞价阶段的主力买卖净额,正值为净流入,负值为净流出。与 auc_net_amount 口径不同;缺失返回 null,真实零保留为 0。 | |
| type | 涨跌停池类型 | string|null | u=涨停、d=跌停、ub=涨停炸板、db=跌停炸板。 | |
| is_break | 是否炸板 | boolean|null | true 表示炸板,false 表示未炸板。 | |
| limit_times | 连续涨跌停天数 | integer|null | 涨停为正、跌停为负、非封板为 0。 | |
| fd_amount | 封单额(元) | number|null | 封单额(元):涨停取买一、跌停取卖一,非封板或盘口无效返回 null。 | |
| fd_to_turnover | 封成比 | number|null | 封成比;该字段的单位、数值尺度或源口径尚未确认;不据名称推定。 | |
| first_time | 首次封板时间 | string|null | 格式:HH:mm:ss。 | |
| last_time | 最后封板时间 | string|null | 格式:HH:mm:ss。 | |
| open_times | 炸板次数 | integer|null | 当日涨停或跌停封板后被打开的次数。真实零保留为 0;不适用或缺失返回 null。 | |
| limit_type | 板型编码 | integer|null | 1=一字板,2=T字涨停,3=反包涨停,4=换手板,5=天地板,6=地天板,7=其他跌停,9=反包跌停。8 须结合 type 判断:涨停时为其他涨停,跌停时为 T字跌停。无有效板型返回 null。 | |
| pre_close | 昨收价(元) | number|null | 前复权可比昨收价;最新交易日作为实时涨幅基准价。 | |
| pre_limit_times | 上一交易日连续涨跌停天数 | integer|null | 方向符号与 limit_times 相同;无有效前日时返回 null。 | |
| pre_fd_amount | 昨日封单额(元) | number|null | 上一交易日的封单金额。 | |
| prev_fd_amount | 前日封单额(元) | number|null | 前日的封单金额。 | |
| fd_to_yesterday | 封昨比 | number|null | 封单额 / 昨日封单额,返回原倍率,保留 2 位小数;缺失或昨日封单额为 0 时返回 null,不乘 100;单位:倍。 | 倍 |
| pre_pct_chg | 昨日涨跌幅(%) | number|null | 上一交易日涨跌幅,1.25 表示 1.25%。停复牌股票的实时查询可能使用最近可用行情;缺失返回 null。 | |
| pre_amount | 昨日成交额(元) | number|null | 上一交易日全天成交额。停复牌股票的实时查询可能使用最近可用行情;缺失返回 null。 | |
| pre_vol | 昨日成交量(手) | number|null | 上一交易日全天成交量。停复牌股票的实时查询可能使用最近可用行情;缺失返回 null。 | |
| prev_turnover_rate_f | 昨日实际换手率(%) | number|null | 上一交易日实际换手率,口径与 turnover_rate_f 一致。停复牌股票的实时查询可能使用最近可用指标;缺失返回 null。 | |
| pre_auc_vol | 昨日竞价成交量(手) | number|null | 上一交易日的竞价成交量;缺失返回 null。 | |
| auc_to_pre_vol_pct | 竞昨成交比(%) | number|null | 竞价成交量 ÷ 昨日成交量 × 100。停复牌股票的实时查询可能使用最近可用成交量;分母缺失或为 0 返回 null。 | |
| auc_to_pre_auc_vol_ratio | 竞昨量比 | number|null | 竞价成交量 ÷ 昨日竞价成交量,单位为倍。分母缺失或为 0 返回 null。 | |
| pre_type | 昨日涨跌停池类型 | string|null | 上一交易日类型:u/u1/u1n/ul=涨停相关,d=跌停,ub/db=涨停/跌停炸板,bu/bd=大涨/大跌。不适用或缺失返回 null。 | |
| pre_main_net_amount | 昨日主力净额(元) | number|null | 开盘啦上一交易日累计的主力买卖净额,正值为净流入,负值为净流出。与 auc_net_amount 口径不同;缺失返回 null,真实零保留为 0。 | |
| pre_auction_main_net_amount | 昨日竞价主力净额(元) | number|null | 开盘啦上一交易日竞价阶段的主力买卖净额,正值为净流入,负值为净流出。与 auc_net_amount 口径不同;缺失返回 null,真实零保留为 0。 | |
| pre_ztwme | 昨日涨停委买额(元) | number|null | 上一交易日的涨停委买额。缺失或未达金额门槛返回 null。 | |
| prev_ztwme | 前日涨停委买额(元) | number|null | 前两个交易日的涨停委买额。缺失或未达金额门槛返回 null。 | |
| hot_ths_normal_rank | 同花顺热度排名 | integer|null | 同花顺热股榜排名。 | |
| hot_dfcf_biaos_rank | 东方财富热度排名 | integer|null | 东方财富飙升榜排名。 | |
| hot_xq_resou_rank | 雪球热度排名 | integer|null | 雪球热搜榜排名。 | |
| hot_tdx_resou_rank | 通达信热度排名 | integer|null | 通达信热搜榜排名。 | |
| theme_names_xgb | 选股宝题材 | string|null | 选股宝来源的当日题材名称。 | |
| reason_xgb | 选股宝涨停原因 | string|null | 选股宝来源的涨停原因。 | |
| theme_symbols_xgb | 选股宝当日题材代码 | string|null | 选股宝当日涨停题材代码,仅适用于该来源。多个代码用英文逗号分隔;无有效题材返回 null。 | |
| latest_theme_symbols_xgb | 选股宝近期题材代码 | string|null | 截至查询日期的近 180 个交易日中,最近一次有效涨停的选股宝题材代码。多个代码用英文逗号分隔;无记录返回 null。 | |
| latest_theme_names_xgb | 选股宝近期题材名称 | string|null | 与同来源近期题材代码对应的题材名称。多个名称用英文逗号分隔;名称缺失返回 null。 | |
| theme_names_kpl | 开盘啦题材 | string|null | 开盘啦来源的当日题材名称。 | |
| reason_kpl | 开盘啦涨停原因 | string|null | 开盘啦来源的涨停原因。 | |
| reason_main_kpl | 开盘啦关键因素 | string|null | 开盘啦来源的核心驱动因素。 | |
| theme_symbols_kpl | 开盘啦当日题材代码 | string|null | 开盘啦当日涨停题材代码,仅适用于该来源。多个代码用英文逗号分隔;无有效题材返回 null。 | |
| latest_theme_symbols_kpl | 开盘啦近期题材代码 | string|null | 截至查询日期的近 180 个交易日中,最近一次有效涨停的开盘啦题材代码。多个代码用英文逗号分隔;无记录返回 null。 | |
| latest_theme_names_kpl | 开盘啦近期题材名称 | string|null | 与同来源近期题材代码对应的题材名称。多个名称用英文逗号分隔;名称缺失返回 null。 | |
| theme_names_jygs | 韭菜公社题材 | string|null | 韭菜公社来源的当日题材名称。 | |
| reason_jygs | 韭菜公社涨停原因 | string|null | 韭菜公社来源的涨停原因。 | |
| reason_main_jygs | 韭菜公社关键因素 | string|null | 韭菜公社来源的核心驱动因素。 | |
| theme_symbols_jygs | 韭菜公社当日题材代码 | string|null | 韭菜公社当日涨停题材代码,仅适用于该来源。多个代码用英文逗号分隔;无有效题材返回 null。 | |
| latest_theme_symbols_jygs | 韭菜公社近期题材代码 | string|null | 截至查询日期的近 180 个交易日中,最近一次有效涨停的韭菜公社题材代码。多个代码用英文逗号分隔;无记录返回 null。 | |
| latest_theme_names_jygs | 韭菜公社近期题材名称 | string|null | 与同来源近期题材代码对应的题材名称。多个名称用英文逗号分隔;名称缺失返回 null。 |
请求
{"content":{"application/json":{"example":{"apikey":"YOUR_API_KEY","apiname":"screening","fields":"tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f","params":{}},"examples":{"date":{"description":"查询指定股票在某个交易日的数据。日期为示例值,可按需替换。","summary":"指定交易日","value":{"apikey":"YOUR_API_KEY","apiname":"screening","fields":"tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f","params":{"symbols":"000001","tradedate":"20260724"}}},"latest":{"description":"不传日期和股票代码,查询最新交易日的全市场标的;盘中返回实时数据。","summary":"最新全市场","value":{"apikey":"YOUR_API_KEY","apiname":"screening","fields":"tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f","params":{}}},"range":{"description":"查询指定股票在起止日期范围内的数据;startdate/enddate 不与 tradedate 同时使用。","summary":"日期区间","value":{"apikey":"YOUR_API_KEY","apiname":"screening","fields":"tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f","params":{"enddate":"20260724","startdate":"20260701","symbols":"000001"}}},"recent":{"description":"查询指定股票最近 5 个交易日的数据;recentdays 不与显式日期同时使用。","summary":"最近 N 个交易日","value":{"apikey":"YOUR_API_KEY","apiname":"screening","fields":"tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f","params":{"recentdays":5,"symbols":"000001"}}},"symbols":{"description":"只查询指定股票的最新交易日数据;多个代码用英文逗号分隔。","summary":"指定股票","value":{"apikey":"YOUR_API_KEY","apiname":"screening","fields":"tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f","params":{"symbols":"000001,600000"}}}},"schema":{"properties":{"apikey":{"default":"","description":"猫爪数据 API Key。网页在线调试会为已登录用户自动注入,其他调用请从控制台获取。","type":"string"},"apiname":{"default":"screening","description":"固定填写 screening","enum":["screening"],"type":"string"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"tradedate,symbol,name,close,pct_chg,amount,turnover_rate_f,free_float_mv,type,limit_times,fd_amount,auc_pct_chg,auc_net_amount,auc_amt,theme_names_kpl,reason_main_kpl","description":"选择要返回的字段,多个字段用英文逗号分隔。"},"params":{"additionalProperties":false,"description":"查询条件对象,包含下面列出的业务查询参数;未指定日期时按最新交易日查询。","properties":{"enddate":{"description":"查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。","example":"20260724","pattern":"^\\d{8}$","title":"结束日期","type":"string"},"recentdays":{"description":"最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。 最小值:1。","example":5,"minimum":1,"title":"最近交易日数量","type":"integer"},"startdate":{"description":"查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。","example":"20260701","pattern":"^\\d{8}$","title":"开始日期","type":"string"},"symbols":{"description":"股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。","example":"000001,600000","oneOf":[{"description":"单个或多个逗号分隔股票代码","type":"string"},{"description":"股票代码数组","items":{"type":"string"},"type":"array"}],"title":"股票代码"},"tradedate":{"description":"查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。","example":"20260724","pattern":"^\\d{8}$","title":"交易日","type":"string"},"tradedate_offset":{"description":"相对最新交易日的单日偏移,0 表示最新交易日,-1 表示上一交易日。 最大值:0。","example":-1,"maximum":0,"title":"交易日偏移","type":"integer"}},"type":"object"}},"required":["apikey","apiname"],"type":"object"}}},"description":"| 参数 | 类型 | 是否必选 | 固定值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `apiname` | `string` | 必选 | `screening` | 接口名称 |\n| `apikey` | `string` | 必选 | [访问个人中心获取](/console) | 访问密钥 |","required":true}
响应
{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"业务状态码,成功时为 200;错误码见下表。","example":200,"type":"integer"},"data":{"description":"成功时返回的数据对象。","nullable":true,"properties":{"fields":{"description":"返回字段名列表,由请求体 fields 指定。","example":["tradedate","symbol","name","close","pct_chg","amount","turnover_rate_f","free_float_mv","type","limit_times","fd_amount","auc_pct_chg","auc_net_amount","auc_amt","theme_names_kpl","reason_main_kpl"],"items":{"type":"string"},"type":"array"},"items":{"description":"数据行列表;每行的值按 data.fields 的顺序排列,字段类型见请求体 fields 列表。","example":[["20260724","000001","平安银行",12.56,2.03,1543210987.65,2.35,9850000000.25,"u",2,358000000.12,1.23,45800000.25,58000000.25,"机器人、人工智能","机器人"]],"items":{"items":{},"type":"array"},"type":"array"}},"required":["fields","items"],"type":"object"},"message":{"description":"请求结果说明或错误原因。","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Successful Response"},"429":{"content":{"application/json":{"schema":{"properties":{"code":{"example":429,"type":"integer"},"data":{"example":null,"nullable":true},"message":{"example":"请求频率超限:daily_auc_detail 接口的调用上限为 3 次/秒,请降低该接口的调用频率,建议 1 秒后重试。","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"账户总调用频率或单个重接口调用频率超过当前套餐限额。","headers":{"Retry-After":{"description":"建议等待后重试的秒数。","schema":{"minimum":1,"type":"integer"}}}}}