API 文档

FinPipe 提供标准化的 RESTful API，支持获取股票、基金、指数等金融市场数据。 所有 API 请求需要携带有效的 API Token 进行身份认证。

Base URL: https://api.finpipe.io/v1

认证 Authentication

所有 API 请求必须在请求头中包含有效的 API Token。 你可以在控制台页面获取和管理你的 API Token。

Request Header
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.finpipe.io/v1/stock/daily?ts_code=000001.SZ

错误响应 Error Response

401 Unauthorized
{
  "code": 401,
  "message": "Invalid or expired API token",
  "data": null
}

日线行情 Stock Daily

获取股票日线行情数据，包括开盘价、收盘价、最高价、最低价、成交量等。

GET/stock/daily

请求参数 Parameters

参数名类型必填说明
ts_codestring是股票代码，如 000001.SZ
start_datestring否开始日期，格式 YYYYMMDD
end_datestring否结束日期，格式 YYYYMMDD
limitinteger否返回条数，默认 100，最大 5000

请求示例 Example

bash
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://api.finpipe.io/v1/stock/daily?ts_code=000001.SZ&start_date=20240101&end_date=20240301"

响应示例 Response

200 OK
{
  "code": 200,
  "message": "success",
  "data": {
    "fields": ["ts_code", "trade_date", "open", "high", "low", "close", "vol", "amount"],
    "items": [
      ["000001.SZ", "20240301", 10.25, 10.52, 10.20, 10.48, 1025633, 1068542.5],
      ["000001.SZ", "20240229", 10.18, 10.30, 10.12, 10.26, 856421, 876543.2]
    ],
    "has_more": true
  }
}

基本信息 Stock Basic

获取股票基本信息，包括股票名称、上市日期、所属行业等。

GET/stock/basic
200 OK
{
  "code": 200,
  "message": "success",
  "data": {
    "fields": ["ts_code", "name", "area", "industry", "list_date"],
    "items": [
      ["000001.SZ", "平安银行", "深圳", "银行", "19910403"],
      ["000002.SZ", "万科A", "深圳", "房地产", "19910129"]
    ]
  }
}

财务数据 Financial Data

获取上市公司财务报表数据，包括利润表、资产负债表、现金流量表等核心财务指标。

GET/stock/finance

基金列表 Fund List

获取公募基金列表信息，支持按基金类型、管理公司等条件筛选。

GET/fund/list

基金净值 Fund NAV

获取基金历史净值数据，包括单位净值、累计净值等。

GET/fund/nav

指数列表 Index List

获取主要市场指数列表，包括上证指数、深证成指、沪深300等。

GET/index/list

指数日线 Index Daily

获取指数日线行情数据，包括开盘、收盘、最高、最低、成交量等。

GET/index/daily