获取股票基础信息

查询沪深两市股票的基础信息,包括股票代码、名称、行业、上市日期等核心数据。

接口名称: stock_basic

基本用法

1import { TushareClient } from '@hestudy/tushare-sdk';
2
3const client = new TushareClient({ token: 'YOUR_TOKEN' });
4
5// 获取所有上市股票
6const stocks = await client.getStockBasic({ list_status: 'L' });
7console.log(`共查询到 ${stocks.length} 只上市股票`);

参数说明

输入参数

1interface StockBasicParams {
2  /** 股票代码 */
3  ts_code?: string;
4
5  /** 上市状态 */
6  list_status?: 'L' | 'D' | 'P';
7
8  /** 交易所 */
9  exchange?: 'SSE' | 'SZSE';
10}
参数名 类型 必需 说明 示例
ts_code string 股票代码 (TS格式) '000001.SZ'
list_status 'L' | 'D' | 'P' 上市状态 'L' (上市), 'D' (退市), 'P' (暂停)
exchange 'SSE' | 'SZSE' 交易所 'SSE' (上交所), 'SZSE' (深交所)

返回值说明

返回类型

1interface StockBasicItem {
2  /** 股票代码 (如 000001.SZ) */
3  ts_code: string;
4
5  /** 股票简称 (如 000001) */
6  symbol: string;
7
8  /** 股票名称 (如 平安银行) */
9  name: string;
10
11  /** 地域 */
12  area: string;
13
14  /** 行业 */
15  industry: string;
16
17  /** 上市日期 (YYYYMMDD) */
18  list_date: string;
19
20  /** 上市状态: L上市 D退市 P暂停上市 */
21  list_status?: 'L' | 'D' | 'P';
22
23  /** 交易所: SSE上交所 SZSE深交所 */
24  exchange?: 'SSE' | 'SZSE';
25}
26
27// 方法返回 Promise<StockBasicItem[]>
字段名 类型 说明 格式/示例
ts_code string 股票代码 (TS格式) '000001.SZ'
symbol string 股票简称 (不含后缀) '000001'
name string 股票名称 '平安银行'
area string 地域 '深圳'
industry string 所属行业 '银行'
list_date string 上市日期 '19910403' (YYYYMMDD)
list_status 'L' | 'D' | 'P' 上市状态 'L' (上市), 'D' (退市), 'P' (暂停)
exchange 'SSE' | 'SZSE' 交易所 'SSE' (上交所), 'SZSE' (深交所)

使用示例

示例1:获取所有上市股票

1import { TushareClient } from '@hestudy/tushare-sdk';
2
3const client = new TushareClient({ token: 'YOUR_TOKEN' });
4
5const stocks = await client.getStockBasic({ list_status: 'L' });
6console.log(`共有 ${stocks.length} 只上市股票`);
7console.log(stocks[0]);

示例2:查询指定股票信息

1const client = new TushareClient({ token: 'YOUR_TOKEN' });
2
3// 查询平安银行的基础信息
4const stocks = await client.getStockBasic({ ts_code: '000001.SZ' });
5if (stocks.length > 0) {
6  const stock = stocks[0];
7  console.log(`名称: ${stock.name}`);
8  console.log(`行业: ${stock.industry}`);
9  console.log(`上市日期: ${stock.list_date}`);
10}

示例3:按交易所筛选

1const client = new TushareClient({ token: 'YOUR_TOKEN' });
2
3// 获取上海交易所的所有上市股票
4const sseStocks = await client.getStockBasic({
5  exchange: 'SSE',
6  list_status: 'L'
7});
8console.log(`上交所共有 ${sseStocks.length} 只上市股票`);
9
10// 获取深圳交易所的所有上市股票
11const szseStocks = await client.getStockBasic({
12  exchange: 'SZSE',
13  list_status: 'L'
14});
15console.log(`深交所共有 ${szseStocks.length} 只上市股票`);

示例4:错误处理

1import { TushareClient, ApiError } from '@hestudy/tushare-sdk';
2
3const client = new TushareClient({ token: 'YOUR_TOKEN' });
4
5try {
6  const stocks = await client.getStockBasic({ list_status: 'L' });
7  console.log(stocks);
8} catch (error) {
9  if (error instanceof ApiError) {
10    console.error(`API错误: ${error.type} - ${error.message}`);
11  } else {
12    console.error('未知错误:', error);
13  }
14}

注意事项

  • 不传参数时会返回所有股票(包括已退市),数据量较大(约5000+条),建议使用 list_status 参数过滤
  • 股票代码必须包含交易所后缀,如 .SZ.SH
  • 上市日期格式为 YYYYMMDD,如 19910403
  • 部分字段(list_status, exchange)可能为空,使用前请做空值检查

相关 API