股票接口 - A股

Signal Feed 提供完整的 A 股股票数据接口，支持 A 股股票列表、详情、K线、选股、股东、业绩等功能。

基础信息

Base URL: http://localhost:4000/api/v1
认证方式: Bearer Token
数据格式: JSON
接口前缀: /stock

主要接口

基础信息

列表


GET /api/v1/stock/list?codes=000001,600519

按股票代码列表批量获取，逗号分隔，支持 6 位或 000001.SZ 格式。

详情


GET /api/v1/stock/detail/{code}

获取单只股票基础信息。

搜索


GET /api/v1/stock/search?keyword=平安

按关键词搜索股票代码与名称。

选股

股票选股


GET /api/v1/stock/selection?page=1&pageSize=50&filter=

分页获取股票选股列表，支持自定义筛选条件（filter 可与行业、地域、概念、风格等组合）。

行情数据

K线


GET /api/v1/stock/kline?code=000001&period=day&fqt=pre

获取股票日/周/月K线，支持复权类型。

查询参数:

code: 股票代码（必需）
period: 周期，可选值：day(日)、week(周)、month(月)
fqt: 复权类型，可选值：pre(前复权)、post(后复权)、none(不复权)

实时行情


GET /api/v1/stock/indicator/realtime/{code}

获取指定股票的实时行情。

实时行情 SSE


GET /api/v1/stock/indicator/realtime/sse?codes=000001,600519

实时行情推送，返回 text/event-stream。

查询参数:

codes: 股票代码，逗号分隔（必需），支持 6 位数字或带后缀
pz: 每次推送条数，1-100，默认 20（可选）

注意: 需要配置 BROWSER_SERVICE_URL 方可使用。

财务数据

财务指标


GET /api/v1/stock/indicator/financial/{code}

获取指定股票的财务指标。

主营业务


GET /api/v1/stock/business/main/{code}

获取公司主营业务构成与收入结构。

分类数据

行业列表


GET /api/v1/stock/industry/list

获取行业分类列表。

地域列表


GET /api/v1/stock/area/list

获取地域分类列表。

概念列表


GET /api/v1/stock/concept/list

获取概念板块列表。

风格列表


GET /api/v1/stock/style/list

获取风格分类列表。

股东数据

股东研究


GET /api/v1/stock/shareholder/research/{code}?endDate=2024-06-30

获取股票的十大流通股东数据，endDate 必填。

股东持仓列表


GET /api/v1/stock/shareholder/list?code=10671586&endDate=2024-06-30

按股东代码查询该股东持仓的股票列表。code 为股东代码（如 10671586），非股票代码；查某股票的股东请用 shareholder/research/{code}。

股东研究最新报告期


GET /api/v1/stock/shareholder/research/latest/{code}

获取该股股东研究最新可用报告日期。

业绩数据

业绩预告


GET /api/v1/stock/earnings-forecast?reportDate=2024-06-30&page=1&pageSize=20

获取业绩预告列表，按报告期与分页。

十年业绩


GET /api/v1/stock/performance/ten-years?industryName=银行&year=2024

按行业与年份获取十年业绩数据。

十年业绩最新报告期


GET /api/v1/stock/performance/ten-years/latest/{code}

获取该股十年业绩最新可用报告日期。

板块与行业

板块/行业信息


GET /api/v1/stock/board/info/{code}

获取股票所属板块与行业信息。

行业信息


GET /api/v1/stock/industry/info/{code}

获取股票所属行业及行业信息。

个股诊断

综合评分


GET /api/v1/stock/diagnosis/comprehensive/{code}

获取个股综合诊断评分。

消息面


GET /api/v1/stock/diagnosis/message/{code}

获取个股消息面诊断。

财务评估


GET /api/v1/stock/diagnosis/financial/evaluation/{code}

获取财务健康状况与风险分析。

财务画像


GET /api/v1/stock/diagnosis/financial/portrait/{code}

获取详细财务画像与趋势。

其他

个股新闻


GET /api/v1/stock/news?code=000001&pageIndex=1&pageSize=20

获取指定股票相关新闻，支持分页。

核心题材


GET /api/v1/stock/theme/core/{code}

获取股票关联的核心概念与题材。

使用示例


const API_TOKEN = 'your_api_token';
const BASE_URL = 'http://localhost:4000/api/v1';
 
// 获取股票详情
async function getStockDetail(code) {
  const response = await fetch(`${BASE_URL}/stock/detail/${code}`, {
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`
    }
  });
  return response.json();
}
 
// 获取股票K线
async function getStockKline(code, period = 'day', fqt = 'pre') {
  const params = new URLSearchParams({ code, period, fqt });
  const response = await fetch(`${BASE_URL}/stock/kline?${params}`, {
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`
    }
  });
  return response.json();
}
 
// 股票筛选
async function stockSelection(filter = '', page = 1, pageSize = 50) {
  const params = new URLSearchParams({ filter, page: page.toString(), pageSize: pageSize.toString() });
  const response = await fetch(`${BASE_URL}/stock/selection?${params}`, {
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`
    }
  });
  return response.json();
}

响应格式

所有接口统一返回以下格式：


{
  "success": true,
  "data": {
    // 具体数据内容
  }
}

注：stock/indicator/realtime/sse 接口返回流式数据，不遵循上述 JSON 格式。