API 接口文档

财务报表与公司基本面

财务报表、杜邦分析与衍生比率、股东结构、高管持股、分红派息、业绩预告与重大事件。

财务报表与公司基本面 API

财务报表、杜邦分析与衍生比率、股东结构、高管持股、分红派息、业绩预告与重大事件。

接口清单汇总(共 20 项)

接口端点请求方法关键查询参数功能说明
/v1/finance/balanceGETsymbol, date, start_date, end_date, limit资产负债表
/v1/finance/cash-flowGETsymbol, date, start_date, end_date, limit现金流量表
/v1/finance/core-indexGETsymbol, date, start_date, end_date, limit财务核心指标
/v1/finance/dividendGETsymbol, date, start_date, end_date, ex_dividend_start, ex_dividend_end, limit分红数据
/v1/finance/event-calendarGETsymbol, start_date, end_date, limit事件日历 (R17)
/v1/finance/event-confidenceGETsymbol, start_date, end_date, limit事件置信度 (R7)
/v1/finance/forecastGETsymbol, date, start_date, end_date, limit业绩预告
/v1/finance/holder-structureGETsymbol, report_date, limit股东结构 (R14)
/v1/finance/incomeGETsymbol, date, start_date, end_date, limit利润表
/v1/finance/institute-recommendGETstart_date, end_date, symbol, rating_type, limit机构评级
/v1/finance/liftingGETsymbol, start_date, end_date, limit限售解禁
/v1/finance/ratiosGETsymbol, date, start_date, end_date, limit财务衍生比率 (R9)
/v1/finance/research-reportsGETsymbol, start_date, end_date, limit研报数据 (R8)
/v1/finance/restricted-release-detailGETstart_date, end_date, symbol, limit限售解禁明细
/v1/finance/restricted-release-queueGETstart_date, end_date, symbol, limit限售解禁批次
/v1/finance/restricted-release-stockholderGETstart_date, end_date, symbol, shareholder_name, limit限售解禁股东明细
/v1/finance/restricted-release-summaryGETstart_date, end_date, limit限售解禁汇总
/v1/finance/sharesGETsymbol, start_date, end_date, limit股本变动
/v1/finance/stock-repurchaseGETstart_date, end_date, symbol, progress, limit股票回购
/v1/finance/summaryGETsymbol, date, start_date, end_date, limit财务摘要汇总

详细接口规范与调用示例

GET /v1/finance/balance

资产负债表

获取上市公司资产负债表数据

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (如: sz.000001, sh.600519)
datestring否—报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
limitinteger否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

现金流量表

获取上市公司现金流量表数据

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (如: sz.000001, sh.600519)
datestring否—报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
limitinteger否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

财务核心指标

获取上市公司财务核心指标数据

请求参数

参数名类型必填默认值描述
symbolstring否—股票代码 (如: sz.000001, sh.600519) (可选)
datestring否—报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
limitinteger否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

分红数据

获取上市公司分红送转历史数据

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (如: sz.000001, sh.600519)
datestring否—报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期并忽略 limit)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
ex_dividend_startstring否—除权除息日开始 (YYYY-MM-DD) (可选)
ex_dividend_endstring否—除权除息日结束 (YYYY-MM-DD) (可选)
limitinteger否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)

聚合事件日历: 分红除权 + 停复牌 + 限售解禁。

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (如: sh.600519)
start_datestring否—开始日期 (YYYY-MM-DD)
end_datestring否—结束日期 (YYYY-MM-DD)
limitinteger否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。

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (如: sh.600519)
start_datestring否—开始日期 (YYYY-MM-DD)
end_datestring否—结束日期 (YYYY-MM-DD)
limitinteger否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

业绩预告

获取上市公司业绩预告数据

请求参数

参数名类型必填默认值描述
symbolstring否—股票代码 (如: sz.000001, sh.600519) (可选)
datestring否—报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
limitinteger否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。

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (如: sh.600519)
report_datestring否—报告期 (YYYY-MM-DD)
limitinteger否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

利润表

获取上市公司利润表数据

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (如: sz.000001, sh.600519)
datestring否—报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
limitinteger否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_datestring否—Start Date
end_datestring否—End Date
symbolstring否—
rating_typestring否—Rating Type
limitinteger否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

限售解禁

获取限售股解禁数据

请求参数

参数名类型必填默认值描述
symbolstring否—股票代码 (如: sz.000001, sh.600519) (可选)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
limitinteger否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。

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (如: sh.600519)
datestring否—指定日期 (YYYY-MM-DD)
start_datestring否—开始日期 (YYYY-MM-DD)
end_datestring否—结束日期 (YYYY-MM-DD)
limitinteger否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预测 + 机构调研汇总。

请求参数

参数名类型必填默认值描述
symbolstring否—股票代码 (可选)
start_datestring否—开始日期 (YYYY-MM-DD)
end_datestring否—结束日期 (YYYY-MM-DD)
limitinteger否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_datestring否—Start Date
end_datestring否—End Date
symbolstring否—
limitinteger否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_datestring否—Start Date
end_datestring否—End Date
symbolstring否—
limitinteger否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_datestring否—Start Date
end_datestring否—End Date
symbolstring否—
shareholder_namestring否—Shareholder Name
limitinteger否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_datestring否—Start Date
end_datestring否—End Date
limitinteger否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

股本变动

获取上市公司股本变动历史数据

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (如: sz.000001, sh.600519)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
limitinteger否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_datestring否—Start Date
end_datestring否—End Date
symbolstring否—
progressstring否—
limitinteger否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)

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (如: sz.000001, sh.600519)
datestring否—报告期 (YYYY-MM-DD) (可选,若指定则精确查询该期财报并忽略 limit)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
limitinteger否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())