API 接口文档
财务报表与公司基本面
财务报表、杜邦分析与衍生比率、股东结构、高管持股、分红派息、业绩预告与重大事件。
财务报表与公司基本面 API
财务报表、杜邦分析与衍生比率、股东结构、高管持股、分红派息、业绩预告与重大事件。
接口清单汇总(共 20 项)
| 接口端点 | 请求方法 | 关键查询参数 | 功能说明 |
|---|---|---|---|
/v1/finance/balance | GET | symbol, date, start_date, end_date, limit | 资产负债表 |
/v1/finance/cash-flow | GET | symbol, date, start_date, end_date, limit | 现金流量表 |
/v1/finance/core-index | GET | symbol, date, start_date, end_date, limit | 财务核心指标 |
/v1/finance/dividend | GET | symbol, date, start_date, end_date, ex_dividend_start, ex_dividend_end, limit | 分红数据 |
/v1/finance/event-calendar | GET | symbol, start_date, end_date, limit | 事件日历 (R17) |
/v1/finance/event-confidence | GET | symbol, start_date, end_date, limit | 事件置信度 (R7) |
/v1/finance/forecast | GET | symbol, date, start_date, end_date, limit | 业绩预告 |
/v1/finance/holder-structure | GET | symbol, report_date, limit | 股东结构 (R14) |
/v1/finance/income | GET | symbol, date, start_date, end_date, limit | 利润表 |
/v1/finance/institute-recommend | GET | start_date, end_date, symbol, rating_type, limit | 机构评级 |
/v1/finance/lifting | GET | symbol, start_date, end_date, limit | 限售解禁 |
/v1/finance/ratios | GET | symbol, date, start_date, end_date, limit | 财务衍生比率 (R9) |
/v1/finance/research-reports | GET | symbol, start_date, end_date, limit | 研报数据 (R8) |
/v1/finance/restricted-release-detail | GET | start_date, end_date, symbol, limit | 限售解禁明细 |
/v1/finance/restricted-release-queue | GET | start_date, end_date, symbol, limit | 限售解禁批次 |
/v1/finance/restricted-release-stockholder | GET | start_date, end_date, symbol, shareholder_name, limit | 限售解禁股东明细 |
/v1/finance/restricted-release-summary | GET | start_date, end_date, limit | 限售解禁汇总 |
/v1/finance/shares | GET | symbol, start_date, end_date, limit | 股本变动 |
/v1/finance/stock-repurchase | GET | start_date, end_date, symbol, progress, limit | 股票回购 |
/v1/finance/summary | GET | symbol, date, start_date, end_date, limit | 财务摘要汇总 |
详细接口规范与调用示例
GET /v1/finance/balance
资产负债表
获取上市公司资产负债表数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sz.000001, sh.600519) |
date | string | 否 | — | 报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 20 | 返回条数 (当不指定 date 时,获取最近 N 期数据) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/balance?symbol=sz.000001&date=2026-06-18&start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/balance"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value",
"start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/cash-flow
现金流量表
获取上市公司现金流量表数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sz.000001, sh.600519) |
date | string | 否 | — | 报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 20 | 返回条数 (当不指定 date 时,获取最近 N 期数据) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/cash-flow?symbol=sz.000001&date=2026-06-18&start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/cash-flow"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value",
"start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/core-index
财务核心指标
获取上市公司财务核心指标数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 股票代码 (如: sz.000001, sh.600519) (可选) |
date | string | 否 | — | 报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 100 | 返回条数 (当不指定 date 时,获取最近 N 期数据) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/core-index?symbol=sz.000001&date=2026-06-18&start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/core-index"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value",
"start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/dividend
分红数据
获取上市公司分红送转历史数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sz.000001, sh.600519) |
date | string | 否 | — | 报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期并忽略 limit) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
ex_dividend_start | string | 否 | — | 除权除息日开始 (YYYY-MM-DD) (可选) |
ex_dividend_end | string | 否 | — | 除权除息日结束 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 100 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/dividend?symbol=sz.000001&date=2026-06-18&start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/dividend"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value",
"start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/event-calendar
事件日历 (R17)
聚合事件日历: 分红除权 + 停复牌 + 限售解禁。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sh.600519) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) |
limit | integer | 否 | 50 | 返回事件数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/event-calendar?symbol=sz.000001&start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/event-calendar"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"start_date": "2026-01-01",
"end_date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/event-confidence
事件置信度 (R7)
获取事件置信度评分: event_type/confidence/impact/bias/importance。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sh.600519) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) |
limit | integer | 否 | 30 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/event-confidence?symbol=sz.000001&start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/event-confidence"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"start_date": "2026-01-01",
"end_date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/forecast
业绩预告
获取上市公司业绩预告数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 股票代码 (如: sz.000001, sh.600519) (可选) |
date | string | 否 | — | 报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 100 | 返回条数 (当不指定 date 时,获取最近 N 期数据) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/forecast?symbol=sz.000001&date=2026-06-18&start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/forecast"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value",
"start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/holder-structure
股东结构 (R14)
获取股东户数历史 + 十大流通股东明细。数据来自 ods_shareholder_count + ods_top_shareholders_free。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sh.600519) |
report_date | string | 否 | — | 报告期 (YYYY-MM-DD) |
limit | integer | 否 | 8 | 返回期数 (每期含 top10 流通股东) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/holder-structure?symbol=sz.000001&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/holder-structure"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"report_date": "value",
"limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/income
利润表
获取上市公司利润表数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sz.000001, sh.600519) |
date | string | 否 | — | 报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 20 | 返回条数 (当不指定 date 时,获取最近 N 期数据) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/income?symbol=sz.000001&date=2026-06-18&start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/income"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value",
"start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/institute-recommend
机构评级
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | Start Date |
end_date | string | 否 | — | End Date |
symbol | string | 否 | — | |
rating_type | string | 否 | — | Rating Type |
limit | integer | 否 | 200 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/institute-recommend?start_date=2026-01-01&symbol=sz.000001&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/institute-recommend"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"start_date": "2026-01-01",
"end_date": "value",
"symbol": "sz.000001"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/lifting
限售解禁
获取限售股解禁数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 股票代码 (如: sz.000001, sh.600519) (可选) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 100 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/lifting?symbol=sz.000001&start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/lifting"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"start_date": "2026-01-01",
"end_date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/ratios
财务衍生比率 (R9)
获取财务衍生比率: ROE/ROIC/毛利率/净利率/EPS/杠杆/周转/增长等。数据来自 dws_stock_quality_daily_snapshot + dwd_finance_core_index。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sh.600519) |
date | string | 否 | — | 指定日期 (YYYY-MM-DD) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) |
limit | integer | 否 | 20 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/ratios?symbol=sz.000001&date=2026-06-18&start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/ratios"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value",
"start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/research-reports
研报数据 (R8)
获取卖方研报: 标题/机构/分析师/评级/目标价/EPS预测 + 机构调研汇总。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 股票代码 (可选) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) |
limit | integer | 否 | 20 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/research-reports?symbol=sz.000001&start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/research-reports"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"start_date": "2026-01-01",
"end_date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/restricted-release-detail
限售解禁明细
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | Start Date |
end_date | string | 否 | — | End Date |
symbol | string | 否 | — | |
limit | integer | 否 | 300 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/restricted-release-detail?start_date=2026-01-01&symbol=sz.000001&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/restricted-release-detail"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"start_date": "2026-01-01",
"end_date": "value",
"symbol": "sz.000001"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/restricted-release-queue
限售解禁批次
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | Start Date |
end_date | string | 否 | — | End Date |
symbol | string | 否 | — | |
limit | integer | 否 | 300 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/restricted-release-queue?start_date=2026-01-01&symbol=sz.000001&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/restricted-release-queue"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"start_date": "2026-01-01",
"end_date": "value",
"symbol": "sz.000001"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/restricted-release-stockholder
限售解禁股东明细
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | Start Date |
end_date | string | 否 | — | End Date |
symbol | string | 否 | — | |
shareholder_name | string | 否 | — | Shareholder Name |
limit | integer | 否 | 300 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/restricted-release-stockholder?start_date=2026-01-01&symbol=sz.000001&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/restricted-release-stockholder"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"start_date": "2026-01-01",
"end_date": "value",
"symbol": "sz.000001"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/restricted-release-summary
限售解禁汇总
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | Start Date |
end_date | string | 否 | — | End Date |
limit | integer | 否 | 200 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/restricted-release-summary?start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/restricted-release-summary"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"start_date": "2026-01-01",
"end_date": "value",
"limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/shares
股本变动
获取上市公司股本变动历史数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sz.000001, sh.600519) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 100 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/shares?symbol=sz.000001&start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/shares"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"start_date": "2026-01-01",
"end_date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/stock-repurchase
股票回购
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | Start Date |
end_date | string | 否 | — | End Date |
symbol | string | 否 | — | |
progress | string | 否 | — | |
limit | integer | 否 | 200 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/stock-repurchase?start_date=2026-01-01&symbol=sz.000001&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/stock-repurchase"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"start_date": "2026-01-01",
"end_date": "value",
"symbol": "sz.000001"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/finance/summary
财务摘要汇总
获取上市公司财务指标摘要 (ADS)
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sz.000001, sh.600519) |
date | string | 否 | — | 报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 20 | 返回条数 (当不指定 date 时,获取最近 N 期数据) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/finance/summary?symbol=sz.000001&date=2026-06-18&start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/finance/summary"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value",
"start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())