DOCUMENTATION

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)

EndpointMethodKey ParametersDescription
/v1/finance/balanceGETsymbol, date, start_date, end_date, limitBalance Sheet
/v1/finance/cash-flowGETsymbol, date, start_date, end_date, limitCash Flow Statement
/v1/finance/core-indexGETsymbol, date, start_date, end_date, limitCore Financial Metrics
/v1/finance/dividendGETsymbol, date, start_date, end_date, ex_dividend_start, ex_dividend_end, limitDividend Data
/v1/finance/event-calendarGETsymbol, start_date, end_date, limitEvent Calendar (R17)
/v1/finance/event-confidenceGETsymbol, start_date, end_date, limitEvent Confidence (R7)
/v1/finance/forecastGETsymbol, date, start_date, end_date, limitEarnings Forecast
/v1/finance/holder-structureGETsymbol, report_date, limitShareholder Structure (R14)
/v1/finance/incomeGETsymbol, date, start_date, end_date, limitIncome Statement
/v1/finance/institute-recommendGETstart_date, end_date, symbol, rating_type, limitInstitutional Ratings
/v1/finance/liftingGETsymbol, start_date, end_date, limitRestricted-Share Unlock
/v1/finance/ratiosGETsymbol, date, start_date, end_date, limitDerived Financial Ratios (R9)
/v1/finance/research-reportsGETsymbol, start_date, end_date, limitResearch Reports (R8)
/v1/finance/restricted-release-detailGETstart_date, end_date, symbol, limitRestricted-Share Unlock Detail
/v1/finance/restricted-release-queueGETstart_date, end_date, symbol, limitRestricted-Share Unlock Batches
/v1/finance/restricted-release-stockholderGETstart_date, end_date, symbol, shareholder_name, limitRestricted-Share Unlock Shareholder Detail
/v1/finance/restricted-release-summaryGETstart_date, end_date, limitRestricted-Share Unlock Summary
/v1/finance/sharesGETsymbol, start_date, end_date, limitShare Capital Changes
/v1/finance/stock-repurchaseGETstart_date, end_date, symbol, progress, limitStock Repurchase
/v1/finance/summaryGETsymbol, date, start_date, end_date, limitFinancial Summary

Detailed Endpoint Specifications

GET /v1/finance/balance

Balance Sheet

Retrieve balance sheet data for listed companies.

Request Parameters

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock code (e.g. sz.000001, sh.600519)
datestringOptional—Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional20Number 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

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock code (e.g. sz.000001, sh.600519)
datestringOptional—Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional20Number 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

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock code (e.g. sz.000001, sh.600519) (optional)
datestringOptional—Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional100Number 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

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock code (e.g. sz.000001, sh.600519)
datestringOptional—Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that period and ignores limit)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
ex_dividend_startstringOptional—Ex-dividend date start (YYYY-MM-DD) (optional)
ex_dividend_endstringOptional—Ex-dividend date end (YYYY-MM-DD) (optional)
limitintegerOptional100Number 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

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock code (e.g. sh.600519)
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional50Number 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

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock code (e.g. sh.600519)
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional30Number 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

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock code (e.g. sz.000001, sh.600519) (optional)
datestringOptional—Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional100Number 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

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock code (e.g. sh.600519)
report_datestringOptional—Reporting period (YYYY-MM-DD)
limitintegerOptional8Number 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

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock code (e.g. sz.000001, sh.600519)
datestringOptional—Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional20Number 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

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start Date
end_datestringOptional—End Date
symbolstringOptional—
rating_typestringOptional—Rating Type
limitintegerOptional200

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

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock code (e.g. sz.000001, sh.600519) (optional)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional100Number 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

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock code (e.g. sh.600519)
datestringOptional—Specific date (YYYY-MM-DD)
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional20Number 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

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock code (optional)
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional20Number 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

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start Date
end_datestringOptional—End Date
symbolstringOptional—
limitintegerOptional300

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

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start Date
end_datestringOptional—End Date
symbolstringOptional—
limitintegerOptional300

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

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start Date
end_datestringOptional—End Date
symbolstringOptional—
shareholder_namestringOptional—Shareholder Name
limitintegerOptional300

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

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start Date
end_datestringOptional—End Date
limitintegerOptional200

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

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock code (e.g. sz.000001, sh.600519)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional100Number 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

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start Date
end_datestringOptional—End Date
symbolstringOptional—
progressstringOptional—
limitintegerOptional200

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

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock code (e.g. sz.000001, sh.600519)
datestringOptional—Reporting period (YYYY-MM-DD) (optional; if specified, queries exactly that report period and ignores limit)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional20Number 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())