DOCUMENTATION

Market Intelligence & Aggregation

Real-time market breadth, intraday momentum, sentiment indices, sector pulse, and macro dashboard aggregations.

Market Intelligence & Aggregation API

Real-time market breadth, intraday momentum, sentiment indices, sector pulse, and macro dashboard aggregations.

Endpoints Summary (21 endpoints)

EndpointMethodKey ParametersDescription
/v1/markets/macro/dashboardGETstart_date, end_date, indicators, limitGet Macro Dashboard
/v1/markets/market-breadthGETdate, start_time, end_time, limitGet Intraday Market Breadth
/v1/markets/market/dragon-tiger-statsGETsymbol, date, start_date, end_date, limitGet Dragon Tiger Stats
/v1/markets/market/hot-stock-trendGETsymbol, date, start_date, end_date, limitGet Hot Stock Trend
/v1/markets/market/hsgt-summaryGETstart_date, end_date, market_type, limitGet Hsgt Summary
/v1/markets/market/limit-statsGETsymbol, date, start_date, end_date, limitGet Limit Stats
/v1/markets/market/margin-summaryGETstart_date, end_date, limitGet Margin Summary
/v1/markets/market/regimeGETdateGet Market Regime
/v1/markets/market/sentimentGETdateGet Market Sentiment
/v1/markets/momentumGETsymbol, date, start_time, end_time, limitGet Intraday Momentum
/v1/markets/opportunity/watchlistGETdate, watch_action, limitGet Opportunity Watchlist
/v1/markets/risk/invalidationGETsymbol, logic_type, date, limitGet Risk Invalidation
/v1/markets/sector-pulseGETsector_name, date, start_time, end_time, limitGet Intraday Sector Pulse
/v1/markets/sector/breadthGETdate, sector_type, limitGet Sector Breadth
/v1/markets/sector/concept-heatGETplate_code, date, start_date, end_date, limitGet Concept Heat
/v1/markets/sector/rotationGETdate, sector_type, limitGet Sector Rotation
/v1/markets/stock/event-timelineGETsymbol, start_date, end_date, limitGet Stock Event Timeline
/v1/markets/stock/pledge-riskGETsymbol, date, start_date, end_date, limitGet Pledge Risk
/v1/markets/stock/profileGETsymbol, limitGet Stock Profile
/v1/markets/stock/shareholder-activityGETsymbol, date, start_date, end_date, limitGet Shareholder Activity
/v1/markets/stock/snapshotGETsymbol, dateGet Stock Snapshot

Detailed Endpoint Specifications

GET /v1/markets/macro/dashboard

Get Macro Dashboard

Retrieves macroeconomic dashboard summary data (DWS).

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
indicatorsstringOptional—Comma-separated indicator short names (cpi,gdp,pmi,m2,lpr,…); returns all by default
limitintegerOptional24Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/macro/dashboard?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/macro/dashboard"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "indicators": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/market-breadth

Get Intraday Market Breadth

Retrieves the intraday market breadth summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
datestringOptional—Trading date (YYYY-MM-DD, optional)
start_timestringOptional—Start time slice (HH:MM, optional)
end_timestringOptional—End time slice (HH:MM, optional)
limitintegerOptional240Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/market-breadth?date=2026-06-18&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/market-breadth"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "date": "value",
    "start_time": "value",
    "end_time": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/market/dragon-tiger-stats

Get Dragon Tiger Stats

Retrieves Dragon-Tiger list statistics summary data (DWS).

Includes aggregate statistics such as Dragon-Tiger list appearance frequency and net buy/sell amounts.

Request Parameters

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock symbol (e.g. sz.000001, sh.600519) (optional)
datestringOptional—Trading date (YYYY-MM-DD) (optional)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional30Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/market/dragon-tiger-stats?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/market/dragon-tiger-stats"
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/market/hot-stock-trend

Get Hot Stock Trend

Retrieves the hot stock trend summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock symbol (e.g. sz.000001, sh.600519) (optional)
datestringOptional—Trading date (YYYY-MM-DD) (optional)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional100Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/market/hot-stock-trend?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/market/hot-stock-trend"
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/market/hsgt-summary

Get Hsgt Summary

Retrieves Shanghai-Shenzhen-Hong Kong Stock Connect flow summary data (DWS).

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
market_typestringOptional—Market type (optional)
limitintegerOptional30Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/market/hsgt-summary?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/market/hsgt-summary"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "market_type": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/market/limit-stats

Get Limit Stats

Retrieves limit-up/limit-down statistics summary data (DWS).

Includes statistics such as limit-up (ZT) / limit-down (DT) counts and consecutive-day streaks.

Request Parameters

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock symbol (e.g. sz.000001, sh.600519) (optional)
datestringOptional—Trading date (YYYY-MM-DD) (optional)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional100Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/market/limit-stats?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/market/limit-stats"
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/market/margin-summary

Get Margin Summary

Retrieves margin trading and securities lending summary data (DWS).

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional30Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/market/margin-summary?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/market/margin-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/markets/market/regime

Get Market Regime

Retrieves the market regime summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
datestringOptional—Trading date (YYYY-MM-DD) (optional; returns the latest if omitted)

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/market/regime?date=2026-06-18" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/market/regime"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/market/sentiment

Get Market Sentiment

Retrieves the market sentiment summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
datestringOptional—Trading date (YYYY-MM-DD) (optional; returns the latest if omitted)

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/market/sentiment?date=2026-06-18" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/market/sentiment"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/momentum

Get Intraday Momentum

Retrieves the intraday momentum summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock symbol (optional)
datestringOptional—Trading date (YYYY-MM-DD, optional)
start_timestringOptional—Start time slice (HH:MM, optional)
end_timestringOptional—End time slice (HH:MM, optional)
limitintegerOptional120Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/momentum?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/momentum"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "symbol": "sz.000001",
    "date": "value",
    "start_time": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/opportunity/watchlist

Get Opportunity Watchlist

Retrieves the opportunity watchlist summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
datestringOptional—Trading date (YYYY-MM-DD, optional)
watch_actionstringOptional—Watch action filter (optional)
limitintegerOptional50Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/opportunity/watchlist?date=2026-06-18&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/opportunity/watchlist"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "date": "value",
    "watch_action": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/risk/invalidation

Get Risk Invalidation

Retrieves the risk invalidation/revocation logic summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock symbol (optional)
logic_typestringOptional—Logic type (optional)
datestringOptional—Trading date (YYYY-MM-DD, optional)
limitintegerOptional50Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/risk/invalidation?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/risk/invalidation"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "symbol": "sz.000001",
    "logic_type": "value",
    "date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/sector-pulse

Get Intraday Sector Pulse

Retrieves the intraday sector pulse summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
sector_namestringOptional—Sector name (optional)
datestringOptional—Trading date (YYYY-MM-DD, optional)
start_timestringOptional—Start time slice (HH:MM, optional)
end_timestringOptional—End time slice (HH:MM, optional)
limitintegerOptional120Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/sector-pulse?date=2026-06-18&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/sector-pulse"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "sector_name": "value",
    "date": "value",
    "start_time": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/sector/breadth

Get Sector Breadth

Retrieves the sector breadth summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
datestringOptional—Trading date (YYYY-MM-DD) (optional; returns the latest if omitted)
sector_typestringOptionalallSector type (concept/plate/sw/all)
limitintegerOptional20Number of rows to return (compatibility parameter)

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/sector/breadth?date=2026-06-18&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/sector/breadth"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "date": "value",
    "sector_type": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/sector/concept-heat

Get Concept Heat

Retrieves the concept heat summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
plate_codestringOptional—Sector code (optional)
datestringOptional—Trading date (YYYY-MM-DD) (optional)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional50Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/sector/concept-heat?date=2026-06-18&start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/sector/concept-heat"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "plate_code": "value",
    "date": "value",
    "start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/sector/rotation

Get Sector Rotation

Retrieves the sector rotation summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
datestringOptional—Trading date (YYYY-MM-DD) (optional; returns the latest if omitted)
sector_typestringOptionalallSector type (concept/plate/sw/all)
limitintegerOptional20Number of rows to return (compatibility parameter)

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/sector/rotation?date=2026-06-18&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/sector/rotation"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "date": "value",
    "sector_type": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/markets/stock/event-timeline

Get Stock Event Timeline

Retrieves the single-stock event timeline summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock symbol
start_datestringOptional—Start date (YYYY-MM-DD, optional)
end_datestringOptional—End date (YYYY-MM-DD, optional)
limitintegerOptional50Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/stock/event-timeline?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/markets/stock/event-timeline"
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/stock/pledge-risk

Get Pledge Risk

Retrieves stock pledge risk summary data (DWS).

Request Parameters

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock symbol (e.g. sz.000001, sh.600519) (optional)
datestringOptional—Trading date (YYYY-MM-DD) (optional)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional50Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/stock/pledge-risk?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/stock/pledge-risk"
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/stock/profile

Get Stock Profile

Retrieves stock profile summary data (DWS).

Request Parameters

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock symbol (e.g. sz.000001, sh.600519) (optional)
limitintegerOptional100Number of rows to return (compatibility parameter)

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/stock/profile?symbol=sz.000001&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/stock/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/stock/shareholder-activity

Get Shareholder Activity

Retrieves shareholder activity summary data (DWS).

Request Parameters

ParameterTypeRequiredDefaultDescription
symbolstringOptional—Stock symbol (e.g. sz.000001, sh.600519) (optional)
datestringOptional—Reporting period (YYYY-MM-DD) (optional)
start_datestringOptional—Start date (YYYY-MM-DD) (optional)
end_datestringOptional—End date (YYYY-MM-DD) (optional)
limitintegerOptional20Number of rows to return

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/stock/shareholder-activity?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/stock/shareholder-activity"
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/stock/snapshot

Get Stock Snapshot

Retrieves the single-stock snapshot summary.

Request Parameters

ParameterTypeRequiredDefaultDescription
symbolstringRequired—Stock symbol
datestringOptional—Trading date (YYYY-MM-DD, optional)

cURL Example

curl -X GET "https://tickerlab.org/v1/markets/stock/snapshot?symbol=sz.000001&date=2026-06-18" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/markets/stock/snapshot"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "symbol": "sz.000001",
    "date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())