查询股票基础信息,用于获取股票代码、名称、上市状态、市场、交易所和所属行业等静态资料。
POST
/apiapiname:stockbasic生产专线(默认)深圳
http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
apiname | string(stockbasic) | 必选 | stockbasic | 固定接口名称,用于选择对应的数据能力。 |
apikey | string | 必选 | — | 猫爪数据 API Key。网页在线调试会为已登录用户自动注入,其他调用请从控制台获取。 |
fields | string|null | 可选 | code,symbol,name,area,industry,fullname,enname,cnspell,market,exchange,curr_type,list_status,list_date,delist_date,is_hs,act_name,act_ent_type | 需要返回的字段列表,多个字段使用英文逗号分隔;可选字段见下方返回字段表。 |
params | object | 可选 | {"symbols":"000001,600000,300750","list_status":"L"} | 查询条件对象;具体参数、格式和互斥关系见下方 params 参数表。 |
params 参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
symbols | string | 可选 | 000001,600000,300750 | 股票代码,支持单个或多个逗号分隔;不传则默认全市场标的。 |
keyword | string | 可选 | 平安 | 关键词,按股票代码或名称检索。 |
list_status | string(L / D / P) | 可选 | L | 上市状态:L=上市,D=退市,P=暂停上市。默认 L。 |
market | string | 可选 | 主板 | 市场类型,如 主板、创业板、科创板、北交所。 |
exchange | string | 可选 | SSE | 交易所代码,如 SSE、SZSE、BSE。 |
industry | string | 可选 | 银行 | 所属行业。 |
fields 返回字段
字段顺序与接口样例保持一致| 字段 | 类型 | 名称 | 示例值 | 描述 |
|---|---|---|---|---|
code | string | 完整股票代码 | 000001.SZ | 包含交易所后缀的股票代码。 |
symbol | string | 股票代码 | 000001 | 6 位股票代码。 |
name | string | 股票名称 | 平安银行 | 股票简称。 |
area | string|null | 所属地域 | 深圳 | 上市公司所属地域。 |
industry | string|null | 所属行业 | 银行 | 上市公司所属行业。 |
fullname | string|null | 公司全称 | 平安银行股份有限公司 | 上市公司中文全称。 |
enname | string|null | 英文名称 | Ping An Bank Co., Ltd. | 上市公司英文名称。 |
cnspell | string|null | 拼音缩写 | PAYH | 股票名称的拼音首字母缩写。 |
market | string|null | 市场类型 | 主板 | 股票所属市场板块。 |
exchange | string|null | 交易所 | SZSE | 股票上市交易所。 |
curr_type | string|null | 交易货币 | CNY | 证券交易使用的货币类型。 |
list_status | string|null | 上市状态 | L | L=上市、D=退市、P=暂停上市。 |
list_date | string|null | 上市日期 | 19910403 | 日期格式:YYYYMMDD。 |
delist_date | string|null | 退市日期 | — | 日期格式:YYYYMMDD;未退市时返回 null。 |
is_hs | string|null | 沪深港通标识 | S | H=沪股通、S=深股通、N=否。 |
act_name | string|null | 实控人名称 | 无实际控制人 | 上市公司实际控制人名称。 |
act_ent_type | string|null | 实控人类型 | 其他 | 上市公司实际控制人主体类型。 |
请求与响应样例
固定样例
{
"apiname": "stockbasic",
"apikey": "YOUR_API_KEY",
"fields": "code,symbol,name,area,industry,fullname,enname,cnspell,market,exchange,curr_type,list_status,list_date,delist_date,is_hs,act_name,act_ent_type",
"params": {
"symbols": "000001,600000,300750",
"list_status": "L"
}
}{
"code": 200,
"message": "success",
"data": {
"fields": [
"code",
"symbol",
"name",
"area",
"industry",
"fullname",
"enname",
"cnspell",
"market",
"exchange",
"curr_type",
"list_status",
"list_date",
"delist_date",
"is_hs",
"act_name",
"act_ent_type"
],
"items": [
[
"000001.SZ",
"000001",
"平安银行",
"深圳",
"银行",
"平安银行股份有限公司",
"Ping An Bank Co., Ltd.",
"PAYH",
"主板",
"SZSE",
"CNY",
"L",
"19910403",
null,
"S",
"无实际控制人",
"其他"
]
]
}
}