Skip to Content
数据接口库API 文档API 接口文档

API 接口文档

Signal Feed 提供完整的金融数据 API 接口,支持股票、ETF基金、宏观、市场、新闻等多维度数据。

基础信息

  • Base URL: http://localhost:4000/api/v1
  • 认证方式: Bearer Token (所有接口都需要认证)
  • 数据格式: JSON
  • 响应格式: 统一响应格式

接口分类

📈 股票数据

  • 股票接口 - A股股票列表、详情、K线、选股、股东、业绩等
  • 支持A股股票搜索、行业分类、概念板块、风格分类等

💰 基金数据

  • 基金接口 - ETF - ETF基金列表、详情、持仓、资产配置等
  • 支持ETF基金筛选、K线、持仓明细、行业配置等

📊 宏观数据

  • 宏观接口 - PMI、CPI、GDP、货币供应量等
  • 提供宏观经济指标的时间序列数据

🌐 市场数据

  • 市场接口 - 大盘指数、资金流向、市场热力图等
  • 提供市场整体情况和资金流向数据

📰 新闻资讯

  • 新闻接口 - 市场概览、题材库、快讯要闻等
  • 提供市场资讯和题材分析数据

通用查询参数

所有支持分页和排序的接口都支持以下参数:

参数类型必需默认值说明
pagenumber1页码
pageSizenumber20每页数量
sortBystring-排序字段
sortOrderstringasc排序方向:asc(升序) 或 desc(降序)
fields[]string[]-返回字段数组

认证说明

所有 API 接口都需要通过 ApiAuthGuard 认证,使用 Bearer Token 方式:

Authorization: Bearer YOUR_API_TOKEN

错误处理

API 使用统一的错误响应格式,包含错误码和错误信息。

使用示例

Node.js 示例

const API_TOKEN = 'your_api_token'; const BASE_URL = process.env.API_BASE_URL || 'http://localhost:4000/api/v1'; // 基础请求函数 async function apiRequest(endpoint, options = {}) { const response = await fetch(`${BASE_URL}${endpoint}`, { headers: { 'Authorization': `Bearer ${API_TOKEN}`, 'Content-Type': 'application/json', ...options.headers }, ...options }); if (!response.ok) { const error = await response.json(); throw new Error(`API 错误: ${error.message} (${error.code})`); } return response.json(); } // 获取股票列表 async function getStockList(codes = '000001,600519') { return apiRequest(`/stock/list?codes=${codes}`); } // 获取市场概览 async function getMarketOverview() { return apiRequest('/news/overview'); } // 使用示例 async function example() { try { // 获取股票列表 const stocks = await getStockList('000001,600519'); console.log('股票列表:', stocks); // 获取市场概览 const overview = await getMarketOverview(); console.log('市场概览:', overview); } catch (error) { console.error('API 请求失败:', error); } }

接口列表

股票数据接口(A股)

基础信息

接口方法路径说明
股票列表GET/stock/list批量查询A股股票
股票详情GET/stock/detail/{code}获取A股股票基础信息
股票搜索GET/stock/search按关键词搜索A股股票
股票筛选GET/stock/selection获取A股股票筛选列表

行情数据

接口方法路径说明
K线数据GET/stock/kline获取A股股票K线数据
实时指标GET/stock/indicator/realtime/{code}获取A股实时行情指标

财务数据

接口方法路径说明
财务指标GET/stock/indicator/financial/{code}获取A股财务指标
主营业务GET/stock/business/main/{code}获取公司主营业务构成

分类数据

接口方法路径说明
行业列表GET/stock/industry/list获取A股行业分类列表
地域列表GET/stock/area/list获取A股地域分类列表
概念列表GET/stock/concept/list获取A股概念板块列表
风格列表GET/stock/style/list获取A股风格分类列表

股东数据

接口方法路径说明
股东研究GET/stock/shareholder/research/{code}获取A股股东持仓数据
股东持仓列表GET/stock/shareholder/list按股东代码查询持仓股票列表

业绩数据

接口方法路径说明
业绩预告GET/stock/earnings-forecast获取A股业绩预告数据
十年业绩GET/stock/performance/ten-years按行业与年份获取十年业绩数据

其他数据

接口方法路径说明
个股新闻GET/stock/news获取指定股票相关新闻
核心题材GET/stock/theme/core/{code}获取股票关联的核心概念与题材

基金接口 - ETF

基础信息

接口方法路径说明
ETF列表GET/fund/all-etf-list获取全量ETF基金列表
ETF详情GET/fund/detail/{code}获取ETF基金基础信息
ETF筛选GET/fund/selection获取ETF基金筛选列表

行情数据

接口方法路径说明
ETF K线GET/fund/kline获取ETF基金K线数据

持仓配置

接口方法路径说明
持仓明细GET/fund/holdings/{code}获取ETF基金持仓明细
资产配置GET/fund/asset-allocation/{code}获取ETF基金资产配置结构
行业配置GET/fund/industry-allocation/{code}获取ETF基金行业配置分布

其他数据

接口方法路径说明
调仓记录GET/fund/transactions/{code}获取ETF基金历史调仓记录
跟踪指数GET/fund/following-index/{code}获取ETF基金跟踪指数信息
估值分析GET/fund/valuation-analysis/{code}获取ETF基金估值分析

宏观数据接口

经济指标

接口方法路径说明
PMI数据GET/macro/pmi获取采购经理指数数据
PMI系列GET/macro/pmi/series获取PMI系列数据(图表用)
CPI数据GET/macro/cpi获取居民消费价格指数数据
CPI系列GET/macro/cpi/series获取CPI系列数据
PPI数据GET/macro/ppi获取工业品出厂价格指数数据
PPI系列GET/macro/ppi/series获取PPI系列数据
GDP数据GET/macro/gdp获取国内生产总值数据
GDP系列GET/macro/gdp/series获取GDP系列数据

货币金融

接口方法路径说明
货币供应量GET/macro/currency-supply获取M0/M1/M2货币供应量数据
货币供应量系列GET/macro/currency-supply/series获取货币供应量系列数据
LPR数据GET/macro/lpr获取贷款市场报价利率数据
LPR系列GET/macro/lpr/series获取LPR系列数据
新增信贷GET/macro/new-loans获取新增信贷数据
新增信贷系列GET/macro/new-loans/series获取新增信贷系列数据

其他指标

接口方法路径说明
固定资产投资GET/macro/fixed-asset-investment获取城镇固定资产投资数据
固定资产投资系列GET/macro/fixed-asset-investment/series获取固定资产投资系列数据
社会消费品零售总额GET/macro/total-retail获取社零数据
社会消费品零售总额系列GET/macro/total-retail/series获取社零系列数据
海关进出口GET/macro/customs-trade获取海关进出口增减情况
海关进出口系列GET/macro/customs-trade/series获取海关进出口系列数据
外汇和黄金储备GET/macro/gold-currency获取外汇与黄金储备数据
外汇和黄金储备系列GET/macro/gold-currency/series获取外汇黄金系列数据

市场数据接口

接口方法路径说明
大盘指数GET/market/indices获取主要股指实时数据
资金流向GET/market/flow获取资金流向数据
市场热力图GET/market/hotmap获取全市场热力图数据

新闻资讯接口

接口方法路径说明
市场概览GET/news/overview获取市场概览数据
市场主线GET/news/mainline获取市场主线主题
题材库列表GET/news/topic/library/list获取题材库分类列表
题材库详情GET/news/topic/library/detail/{themeId}获取题材详情
快讯要闻GET/news/feed获取快讯与要闻流

更多资源

Last updated on