Market Data
Historical K-line OHLCV time series, margin financing, block trades, option snapshots, and trading calendar.
Market Data API
Historical K-line OHLCV time series, margin financing, block trades, option snapshots, and trading calendar.
Endpoints Summary (16 endpoints)
| Endpoint | Method | Key Parameters | Description |
|---|---|---|---|
/v1/export/history | GET | symbol, start_date, end_date, interval, format | Export Historical Data |
/v1/markets/block-trade-daily | GET | start_date, end_date, limit | Block-Trade Market Statistics |
/v1/markets/block-trade-detail | GET | symbol, date, limit | Block-Trade Detail |
/v1/markets/board-summary | GET | exchange, date, item, limit | Sector Trading Summary |
/v1/markets/bond/profile | GET | symbol, limit | Get Bond Profile |
/v1/markets/calendar | GET | exchange, start_date, end_date, is_trading_day, page, page_size | Get Trade Calendar |
/v1/markets/finance/analyst-consensus | GET | symbol, date, start_date, end_date, limit | Get Analyst Consensus |
/v1/markets/finance/forecast-summary | GET | symbol, date, start_date, end_date, limit | Get Forecast Summary |
/v1/markets/finance/growth | GET | symbol, date, start_date, end_date, limit | Get Finance Growth |
/v1/markets/history | GET | symbol, interval, start_date, end_date, adjust | Get Market History |
/v1/markets/hsgt-stock-statistics | GET | start_date, end_date, symbol, limit | Northbound Holdings Statistics |
/v1/markets/ivix | GET | underlying, start_date, end_date, limit | ETF Options iVIX (R3) |
/v1/markets/margin | GET | start_date, end_date, limit | Margin Trading Market Summary |
/v1/markets/margin-detail | GET | start_date, end_date, exchange, symbol, limit | Per-Stock Margin Detail |
/v1/markets/options/snapshot | GET | underlying, contract_code, date, limit | Options Quote Snapshot |
/v1/markets/suspend-resume-events | GET | start_date, end_date, symbol, market, limit | Trading Halt & Resumption Events |
Detailed Endpoint Specifications
GET /v1/export/history
Export Historical Data
Download historical OHLCV data in CSV or JSON format.
Use Cases
- Backtest trading strategies
- Train machine learning models
- Generate reports
Example
curl -X GET "https://tickerlab.org/v1/export/history?symbol=sz.000001&start_date=2024-01-01&end_date=2024-12-31&format=csv" \
-H "X-API-Key: your_key" \
-o data.csv
Billing
- Only successful export requests are billed
formataffects billing quota; for the exact rules, refer to your current plan and the Playground
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sz.000001) |
start_date | string | Required | — | Start date (YYYY-MM-DD) |
end_date | string | Required | — | End date (YYYY-MM-DD) |
interval | string | Optional | 1d | K-line interval (supported: 1d/daily, 1w/weekly, 1M/monthly) |
format | string | Optional | csv | Export format |
cURL Example
curl -X GET "https://tickerlab.org/v1/export/history?symbol=sz.000001&start_date=2026-01-01&interval=1d" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
import requests
url = "https://tickerlab.org/v1/export/history"
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/markets/block-trade-daily
Block-Trade Market Statistics
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date | string | Optional | — | Start Date |
end_date | string | Optional | — | End Date |
limit | integer | Optional | 100 |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/block-trade-daily?start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
import requests
url = "https://tickerlab.org/v1/markets/block-trade-daily"
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/markets/block-trade-detail
Block-Trade Detail
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Optional | — | |
date | string | Optional | — | |
limit | integer | Optional | 100 |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/block-trade-detail?symbol=sz.000001&date=2026-06-18&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
import requests
url = "https://tickerlab.org/v1/markets/block-trade-detail"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value",
"limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/markets/board-summary
Sector Trading Summary
Get a summary of market trading indicators (such as total market capitalization and average P/E ratio) for major boards/exchanges (SSE, SZSE).
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
exchange | string | Optional | — | Exchange code (e.g. SSE, SZSE) (optional) |
date | string | Optional | — | Specific date (YYYY-MM-DD) (optional, defaults to the latest available data) |
item | string | Optional | — | Indicator name (e.g. total market capitalization, average P/E ratio) (optional) |
limit | integer | Optional | 500 | Number of rows to return |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/board-summary?date=2026-06-18&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
import requests
url = "https://tickerlab.org/v1/markets/board-summary"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"exchange": "value",
"date": "value",
"item": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/markets/bond/profile
Get Bond Profile
Get comprehensive bond profile summary data (DWS).
Includes comprehensive indicators such as convertible bond premium rate, conversion value, and yield to maturity.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Optional | — | Bond code (optional) |
limit | integer | Optional | 100 | Number of rows to return |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/bond/profile?symbol=sz.000001&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
import requests
url = "https://tickerlab.org/v1/markets/bond/profile"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/markets/calendar
Get Trade Calendar
Get the trading calendar.
Returns dates and trading-day status for each exchange.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
exchange | string | Optional | — | Exchange code (SSE/SZSE) (optional) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) (optional) |
end_date | string | Optional | — | End date (YYYY-MM-DD) (optional) |
is_trading_day | string | Optional | — | Filter trading days (1=yes, 0=no) (optional) |
page | integer | Optional | 1 | Page number, starting from 1 |
page_size | integer | Optional | 50 | Rows per page |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/calendar?start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
import requests
url = "https://tickerlab.org/v1/markets/calendar"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"exchange": "value",
"start_date": "2026-01-01",
"end_date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/markets/finance/analyst-consensus
Get Analyst Consensus
Get analyst consensus summary data (DWS).
Includes analyst consensus data such as institutional ratings, target prices, and earnings forecasts.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Optional | — | Stock code (optional; omit to return the entire market) |
date | string | Optional | — | Statistics date (YYYY-MM-DD, optional) |
start_date | string | Optional | — | Statistics start date (YYYY-MM-DD) |
end_date | string | Optional | — | Statistics end date (YYYY-MM-DD) |
limit | integer | Optional | 100 | Number of rows to return |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/finance/analyst-consensus?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/markets/finance/analyst-consensus"
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/markets/finance/forecast-summary
Get Forecast Summary
Get earnings pre-announcement and flash report summary data (DWS).
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Optional | — | Stock code (e.g. sz.000001, sh.600519) (optional) |
date | string | Optional | — | Statistics date (YYYY-MM-DD) (optional) |
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 rows to return |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/finance/forecast-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/markets/finance/forecast-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())
GET /v1/markets/finance/growth
Get Finance Growth
Get financial growth indicator data (DWS).
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) |
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 rows to return |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/finance/growth?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/markets/finance/growth"
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/markets/history
Get Market History
Get raw OHLCV data export.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Required | — | Stock code (e.g. sz.000001, sh.600519) |
interval | string | Optional | 1d | K-line interval (supported: 1d/daily, 1w/weekly, 1M/monthly) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) (optional) |
end_date | string | Optional | — | End date (YYYY-MM-DD) (optional) |
adjust | string | Optional | — | Adjustment type (qfq: forward-adjusted, hfq: backward-adjusted) (optional) |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/history?symbol=sz.000001&interval=1d&start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
import requests
url = "https://tickerlab.org/v1/markets/history"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"interval": "1d",
"start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/markets/hsgt-stock-statistics
Northbound Holdings Statistics
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 | 200 |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/hsgt-stock-statistics?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/markets/hsgt-stock-statistics"
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/markets/ivix
ETF Options iVIX (R3)
Implied volatility is backed out from ETF option Black-Scholes pricing, approximating a Chinese version of the VIX fear index.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
underlying | string | Optional | — | Underlying (e.g. etf_option) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) |
end_date | string | Optional | — | End date (YYYY-MM-DD) |
limit | integer | Optional | 30 | Number of rows to return |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/ivix?start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
import requests
url = "https://tickerlab.org/v1/markets/ivix"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"underlying": "value",
"start_date": "2026-01-01",
"end_date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/markets/margin
Margin Trading Market Summary
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date | string | Optional | — | Start Date |
end_date | string | Optional | — | End Date |
limit | integer | Optional | 100 |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/margin?start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
import requests
url = "https://tickerlab.org/v1/markets/margin"
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/markets/margin-detail
Per-Stock Margin Detail
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date | string | Optional | — | Start Date |
end_date | string | Optional | — | End Date |
exchange | string | Optional | — | |
symbol | string | Optional | — | |
limit | integer | Optional | 300 |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/margin-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/markets/margin-detail"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"start_date": "2026-01-01",
"end_date": "value",
"exchange": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/markets/options/snapshot
Options Quote Snapshot
Get quote snapshot data for the options market (including call/put type, strike price, expiration date, latest price, settlement price, and more).
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
underlying | string | Optional | — | Underlying security name (e.g. etf_option) (optional) |
contract_code | string | Optional | — | Option contract code (optional) |
date | string | Optional | — | Specific date (YYYY-MM-DD) (optional) |
limit | integer | Optional | 500 | Number of rows to return |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/options/snapshot?date=2026-06-18&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
import requests
url = "https://tickerlab.org/v1/markets/options/snapshot"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"underlying": "value",
"contract_code": "value",
"date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/markets/suspend-resume-events
Trading Halt & Resumption Events
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date | string | Optional | — | Start Date |
end_date | string | Optional | — | End Date |
symbol | string | Optional | — | |
market | string | Optional | — | |
limit | integer | Optional | 300 |
cURL Example
curl -X GET "https://tickerlab.org/v1/markets/suspend-resume-events?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/markets/suspend-resume-events"
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())