Financial Statements & Fundamentals
Financial 3-statements, derived financial ratios, shareholder structure, institutional surveys, dividends, and forecasts.
Financial Statements & Fundamentals API
Financial 3-statements, derived financial ratios, shareholder structure, institutional surveys, dividends, and forecasts.
Endpoints Summary (20 endpoints)
| Endpoint | Method | Key Parameters | Description |
|---|---|---|---|
/v1/finance/balance | GET | symbol, date, start_date, end_date, limit | Balance Sheet |
/v1/finance/cash-flow | GET | symbol, date, start_date, end_date, limit | Cash Flow Statement |
/v1/finance/core-index | GET | symbol, date, start_date, end_date, limit | Core Financial Metrics |
/v1/finance/dividend | GET | symbol, date, start_date, end_date, ex_dividend_start, ex_dividend_end, limit | Dividend Data |
/v1/finance/event-calendar | GET | symbol, start_date, end_date, limit | Event Calendar (R17) |
/v1/finance/event-confidence | GET | symbol, start_date, end_date, limit | Event Confidence (R7) |
/v1/finance/forecast | GET | symbol, date, start_date, end_date, limit | Earnings Forecast |
/v1/finance/holder-structure | GET | symbol, report_date, limit | Shareholder Structure (R14) |
/v1/finance/income | GET | symbol, date, start_date, end_date, limit | Income Statement |
/v1/finance/institute-recommend | GET | start_date, end_date, symbol, rating_type, limit | Institutional Ratings |
/v1/finance/lifting | GET | symbol, start_date, end_date, limit | Restricted-Share Unlock |
/v1/finance/ratios | GET | symbol, date, start_date, end_date, limit | Derived Financial Ratios (R9) |
/v1/finance/research-reports | GET | symbol, start_date, end_date, limit | Research Reports (R8) |
/v1/finance/restricted-release-detail | GET | start_date, end_date, symbol, limit | Restricted-Share Unlock Detail |
/v1/finance/restricted-release-queue | GET | start_date, end_date, symbol, limit | Restricted-Share Unlock Batches |
/v1/finance/restricted-release-stockholder | GET | start_date, end_date, symbol, shareholder_name, limit | Restricted-Share Unlock Shareholder Detail |
/v1/finance/restricted-release-summary | GET | start_date, end_date, limit | Restricted-Share Unlock Summary |
/v1/finance/shares | GET | symbol, start_date, end_date, limit | Share Capital Changes |
/v1/finance/stock-repurchase | GET | start_date, end_date, symbol, progress, limit | Stock Repurchase |
/v1/finance/summary | GET | symbol, date, start_date, end_date, limit | Financial Summary |
Detailed Endpoint Specifications
GET /v1/finance/balance
Balance Sheet
Retrieve balance sheet data for listed companies.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sz.000001, sh.600519) |
date | string | Optional | — | Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) (optional) |
end_date | string | Optional | — | End date (YYYY-MM-DD) (optional) |
limit | integer | Optional | 20 | Number of records returned (when date is not specified, fetches the most recent N periods) |
cURL Example
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 Example
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
Cash Flow Statement
Retrieve cash flow statement data for listed companies.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sz.000001, sh.600519) |
date | string | Optional | — | Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) (optional) |
end_date | string | Optional | — | End date (YYYY-MM-DD) (optional) |
limit | integer | Optional | 20 | Number of records returned (when date is not specified, fetches the most recent N periods) |
cURL Example
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 Example
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
Core Financial Metrics
Retrieve core financial metrics data for listed companies.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Optional | — | Stock code (e.g. sz.000001, sh.600519) (optional) |
date | string | Optional | — | Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) (optional) |
end_date | string | Optional | — | End date (YYYY-MM-DD) (optional) |
limit | integer | Optional | 100 | Number of records returned (when date is not specified, fetches the most recent N periods) |
cURL Example
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 Example
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
Dividend Data
Retrieve historical dividend and stock dividend/split data for listed companies.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sz.000001, sh.600519) |
date | string | Optional | — | Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that period and ignores limit) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) (optional) |
end_date | string | Optional | — | End date (YYYY-MM-DD) (optional) |
ex_dividend_start | string | Optional | — | Ex-dividend date start (YYYY-MM-DD) (optional) |
ex_dividend_end | string | Optional | — | Ex-dividend date end (YYYY-MM-DD) (optional) |
limit | integer | Optional | 100 | Number of records returned |
cURL Example
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 Example
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
Event Calendar (R17)
Aggregated event calendar: dividend ex-dates + trading halts/resumptions + restricted-share unlocks.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sh.600519) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) |
end_date | string | Optional | — | End date (YYYY-MM-DD) |
limit | integer | Optional | 50 | Number of events returned |
cURL Example
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 Example
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
Event Confidence (R7)
Retrieve event confidence scores: event_type/confidence/impact/bias/importance.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sh.600519) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) |
end_date | string | Optional | — | End date (YYYY-MM-DD) |
limit | integer | Optional | 30 | Number of records returned |
cURL Example
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 Example
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
Earnings Forecast
Retrieve earnings forecast data for listed companies.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Optional | — | Stock code (e.g. sz.000001, sh.600519) (optional) |
date | string | Optional | — | Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) (optional) |
end_date | string | Optional | — | End date (YYYY-MM-DD) (optional) |
limit | integer | Optional | 100 | Number of records returned (when date is not specified, fetches the most recent N periods) |
cURL Example
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 Example
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
Shareholder Structure (R14)
Retrieve shareholder count history + top 10 free-float shareholder details. Data comes from ods_shareholder_count + ods_top_shareholders_free.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sh.600519) |
report_date | string | Optional | — | Reporting period (YYYY-MM-DD) |
limit | integer | Optional | 8 | Number of periods returned (each period includes the top 10 free-float shareholders) |
cURL Example
curl -X GET "https://tickerlab.org/v1/finance/holder-structure?symbol=sz.000001&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
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
Income Statement
Retrieve income statement data for listed companies.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sz.000001, sh.600519) |
date | string | Optional | — | Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) (optional) |
end_date | string | Optional | — | End date (YYYY-MM-DD) (optional) |
limit | integer | Optional | 20 | Number of records returned (when date is not specified, fetches the most recent N periods) |
cURL Example
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 Example
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
Institutional Ratings
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date | string | Optional | — | Start Date |
end_date | string | Optional | — | End Date |
symbol | string | Optional | — | |
rating_type | string | Optional | — | Rating Type |
limit | integer | Optional | 200 |
cURL Example
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 Example
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
Restricted-Share Unlock
Retrieve restricted-share unlock data.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Optional | — | Stock code (e.g. sz.000001, sh.600519) (optional) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) (optional) |
end_date | string | Optional | — | End date (YYYY-MM-DD) (optional) |
limit | integer | Optional | 100 | Number of records returned |
cURL Example
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 Example
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
Derived Financial Ratios (R9)
Retrieve derived financial ratios: ROE/ROIC/gross margin/net margin/EPS/leverage/turnover/growth, etc. Data comes from dws_stock_quality_daily_snapshot + dwd_finance_core_index.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sh.600519) |
date | string | Optional | — | Specific date (YYYY-MM-DD) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) |
end_date | string | Optional | — | End date (YYYY-MM-DD) |
limit | integer | Optional | 20 | Number of records returned |
cURL Example
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 Example
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
Research Reports (R8)
Retrieve sell-side research reports: title/institution/analyst/rating/target price/EPS forecasts + institutional survey summaries.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Optional | — | Stock code (optional) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) |
end_date | string | Optional | — | End date (YYYY-MM-DD) |
limit | integer | Optional | 20 | Number of records returned |
cURL Example
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 Example
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
Restricted-Share Unlock Detail
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date | string | Optional | — | Start Date |
end_date | string | Optional | — | End Date |
symbol | string | Optional | — | |
limit | integer | Optional | 300 |
cURL Example
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 Example
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
Restricted-Share Unlock Batches
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date | string | Optional | — | Start Date |
end_date | string | Optional | — | End Date |
symbol | string | Optional | — | |
limit | integer | Optional | 300 |
cURL Example
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 Example
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
Restricted-Share Unlock Shareholder Detail
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date | string | Optional | — | Start Date |
end_date | string | Optional | — | End Date |
symbol | string | Optional | — | |
shareholder_name | string | Optional | — | Shareholder Name |
limit | integer | Optional | 300 |
cURL Example
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 Example
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
Restricted-Share Unlock Summary
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date | string | Optional | — | Start Date |
end_date | string | Optional | — | End Date |
limit | integer | Optional | 200 |
cURL Example
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 Example
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
Share Capital Changes
Retrieve share capital change history for listed companies.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sz.000001, sh.600519) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) (optional) |
end_date | string | Optional | — | End date (YYYY-MM-DD) (optional) |
limit | integer | Optional | 100 | Number of records returned |
cURL Example
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 Example
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
Stock Repurchase
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date | string | Optional | — | Start Date |
end_date | string | Optional | — | End Date |
symbol | string | Optional | — | |
progress | string | Optional | — | |
limit | integer | Optional | 200 |
cURL Example
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 Example
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
Financial Summary
Retrieve financial metrics summary for listed companies (ADS)
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sz.000001, sh.600519) |
date | string | Optional | — | Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) (optional) |
end_date | string | Optional | — | End date (YYYY-MM-DD) (optional) |
limit | integer | Optional | 20 | Number of records returned (when date is not specified, fetches the most recent N periods) |
cURL Example
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 Example
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())