途研智投 API 开放平台

欢迎使用途研智投API！我们提供基于价值投资理念的A股数据查询与分析接口。

5,297

A股股票

248万

日线数据

23.6万

财务指标

11

核心接口

快速开始

Base URL

https://api.tuyanzhitou.com

请求示例

curl -X GET "https://api.tuyanzhitou.com/v1/stocks?limit=10" \
  -H "Content-Type: application/json"

统一响应格式

所有接口返回统一的JSON格式：

{
    "code": 200,
    "message": "success",
    "data": {},
    "timestamp": 1702300800
}

状态码说明

状态码	说明
200	成功
400	请求参数错误
404	资源不存在
500	服务器错误

获取股票列表

GET /v1/stocks

请求参数

参数名	类型	必填	说明
page	int	否	页码，默认1
limit	int	否	每页数量，默认20，最大100
industry	string	否	行业筛选，如：银行
market	string	否	市场类型，如：主板
keyword	string	否	关键词搜索（代码或名称）

响应示例

{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "ts_code": "000001.SZ",
                "symbol": "000001",
                "name": "平安银行",
                "industry": "银行",
                "market": "主板",
                "list_date": "1991-04-03",
                "status": 1
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 20,
            "total": 5297,
            "pages": 265
        }
    },
    "timestamp": 1702300800
}

获取股票详情

GET /v1/stocks/{ts_code}

路径参数

参数名	类型	必填	说明
ts_code	string	是	股票代码，如：000001.SZ

响应示例

{
    "code": 200,
    "message": "success",
    "data": {
        "ts_code": "000001.SZ",
        "name": "平安银行",
        "industry": "银行",
        "latest_daily": {
            "trade_date": "20241213",
            "close": 13.75,
            "pct_chg": 1.70
        },
        "latest_valuation": {
            "pe": 5.23,
            "pb": 0.68
        },
        "latest_financial": {
            "roe": 11.25,
            "roa": 0.85
        }
    }
}

获取K线数据

GET /v1/stocks/{ts_code}/daily

请求参数

参数名	类型	必填	说明
ts_code	string	是	股票代码
start_date	string	否	开始日期，格式：YYYYMMDD
end_date	string	否	结束日期，格式：YYYYMMDD
limit	int	否	返回数量，默认30，最大365

获取财务指标

GET /v1/stocks/{ts_code}/financial

请求参数

参数名	类型	必填	说明
ts_code	string	是	股票代码
limit	int	否	返回期数，默认4，最大20

获取分红历史

GET /v1/stocks/{ts_code}/dividend

请求参数

参数名	类型	必填	说明
ts_code	string	是	股票代码
limit	int	否	返回数量，默认10，最大50
year	int	否	按年度筛选，如：2023

获取分红统计

GET /v1/stocks/{ts_code}/dividend/stats

获取股东结构

GET /v1/stocks/{ts_code}/holders

请求参数

参数名	类型	必填	说明
ts_code	string	是	股票代码
end_date	string	否	报告期，格式：YYYYMMDD，默认最新

获取股东趋势

GET /v1/stocks/{ts_code}/holders/trend

获取概念列表

GET /v1/concepts

请求参数

参数名	类型	必填	说明
page	int	否	页码，默认1
limit	int	否	每页数量，默认20，最大100
keyword	string	否	关键词搜索

获取概念成分股

GET /v1/concepts/{code}/stocks

获取股票概念

GET /v1/stocks/{ts_code}/concepts

股票筛选（核心功能）

POST /v1/stocks/screen

请求示例

{
    "filters": {
        "industry": ["银行", "保险"],
        "min_roe": 10,
        "max_pe": 15,
        "min_dividend": 0.5,
        "min_market_value": 100
    },
    "sort": {
        "field": "roe",
        "order": "desc"
    },
    "page": 1,
    "limit": 50
}

筛选条件说明

字段名	类型	说明
industry	array	行业筛选
market	string	市场类型
min_roe / max_roe	float	ROE范围
min_roa / max_roa	float	ROA范围
min_pe / max_pe	float	PE范围
min_pb / max_pb	float	PB范围
min_market_value	float	最小市值（亿元）
min_dividend	float	最低分红（元/股）

在线调试工具

请求URL

请求参数（JSON格式）

响应结果

等待请求...