API 接口文档
市场行情与交易数据
历史K线行情、融资融券、大宗交易、期权快照与交易日历接口指南。
市场行情与交易数据 API
历史K线行情、融资融券、大宗交易、期权快照与交易日历接口指南。
接口清单汇总(共 16 项)
| 接口端点 | 请求方法 | 关键查询参数 | 功能说明 |
|---|---|---|---|
/v1/export/history | GET | symbol, start_date, end_date, interval, format | 导出历史数据 |
/v1/markets/block-trade-daily | GET | start_date, end_date, limit | 大宗交易市场统计 |
/v1/markets/block-trade-detail | GET | symbol, date, limit | 大宗交易明细 |
/v1/markets/board-summary | GET | exchange, date, item, limit | 板块交易汇总数据 |
/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 | 北向持股统计 |
/v1/markets/ivix | GET | underlying, start_date, end_date, limit | ETF 期权 iVIX (R3) |
/v1/markets/margin | GET | start_date, end_date, limit | 融资融券市场汇总 |
/v1/markets/margin-detail | GET | start_date, end_date, exchange, symbol, limit | 融资融券个股明细 |
/v1/markets/options/snapshot | GET | underlying, contract_code, date, limit | 期权行情快照 |
/v1/markets/suspend-resume-events | GET | start_date, end_date, symbol, market, limit | 停复牌事件 |
详细接口规范与调用示例
GET /v1/export/history
导出历史数据
下载历史OHLCV数据为CSV或JSON格式。
使用场景
- 回测交易策略
- 训练机器学习模型
- 生成报告
示例
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
计费规则
- 仅成功导出的请求计费
format会影响计费额度,具体规则以当前套餐和 Playground 显示为准
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (例如: sz.000001) |
start_date | string | 必填 | — | 开始日期 (YYYY-MM-DD) |
end_date | string | 必填 | — | 结束日期 (YYYY-MM-DD) |
interval | string | 否 | 1d | K线周期 (支持: 1d/daily, 1w/weekly, 1M/monthly) |
format | string | 否 | csv | 导出格式 |
cURL 调用示例
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 调用示例
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
大宗交易市场统计
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | Start Date |
end_date | string | 否 | — | End Date |
limit | integer | 否 | 100 |
cURL 调用示例
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 调用示例
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
大宗交易明细
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | |
date | string | 否 | — | |
limit | integer | 否 | 100 |
cURL 调用示例
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 调用示例
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
板块交易汇总数据
获取主要板块/交易所 (上交所、深交所) 的市场交易指标汇总 (如市价总值、平均市盈率等)。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
exchange | string | 否 | — | 交易所代码 (如: SSE, SZSE) (可选) |
date | string | 否 | — | 指定日期 (YYYY-MM-DD) (可选,默认返回最新数据) |
item | string | 否 | — | 指标项名称 (如: 市价总值, 平均市盈率) (可选) |
limit | integer | 否 | 500 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/markets/board-summary?date=2026-06-18&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
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
获取债券综合信息汇总数据(DWS)。
包含可转债溢价率、转股价值、到期收益率等综合指标。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 债券代码(可选) |
limit | integer | 否 | 100 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/markets/bond/profile?symbol=sz.000001&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
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
获取交易日历。
返回每个交易所的日期和交易日状态。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
exchange | string | 否 | — | 交易所代码 (SSE/SZSE) (可选) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
is_trading_day | string | 否 | — | 过滤交易日 (1=是, 0=否) (可选) |
page | integer | 否 | 1 | 页码,从 1 开始 |
page_size | integer | 否 | 50 | 每页条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/markets/calendar?start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
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
获取分析师一致预期汇总数据(DWS)。
包含机构评级、目标价、盈利预测等分析师共识数据。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 股票代码(可选,不填返回全市场) |
date | string | 否 | — | 统计日期 (YYYY-MM-DD,可选) |
start_date | string | 否 | — | 开始统计日期 (YYYY-MM-DD) |
end_date | string | 否 | — | 结束统计日期 (YYYY-MM-DD) |
limit | integer | 否 | 100 | 返回条数 |
cURL 调用示例
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 调用示例
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
获取业绩预告与快报汇总数据(DWS)。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 股票代码 (如: sz.000001, sh.600519) (可选) |
date | string | 否 | — | 统计日期 (YYYY-MM-DD) (可选) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 20 | 返回条数 |
cURL 调用示例
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 调用示例
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
获取财务增长指标数据(DWS)。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 股票代码 (如: sz.000001, sh.600519) (可选) |
date | string | 否 | — | 报告期 (YYYY-MM-DD) (可选) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 100 | 返回条数 |
cURL 调用示例
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 调用示例
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
获取原始OHLCV数据导出。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sz.000001, sh.600519) |
interval | string | 否 | 1d | K线周期 (支持: 1d/daily, 1w/weekly, 1M/monthly) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
adjust | string | 否 | — | 复权类型 (qfq-前复权,hfq-后复权) (可选) |
cURL 调用示例
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 调用示例
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
北向持股统计
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | Start Date |
end_date | string | 否 | — | End Date |
symbol | string | 否 | — | |
limit | integer | 否 | 200 |
cURL 调用示例
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 调用示例
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 期权 iVIX (R3)
从 ETF 期权 BS 反推隐含波动率,近似中国版 VIX 恐慌指数。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
underlying | string | 否 | — | 标的 (如 etf_option) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) |
limit | integer | 否 | 30 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/markets/ivix?start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
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
融资融券市场汇总
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | Start Date |
end_date | string | 否 | — | End Date |
limit | integer | 否 | 100 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/markets/margin?start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
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
融资融券个股明细
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | Start Date |
end_date | string | 否 | — | End Date |
exchange | string | 否 | — | |
symbol | string | 否 | — | |
limit | integer | 否 | 300 |
cURL 调用示例
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 调用示例
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
期权行情快照
获取期权市场的行情快照数据 (包括认购/认沽类型、行权价、到期日、最新价、结算价等)。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
underlying | string | 否 | — | 标的证券名称 (如: etf_option) (可选) |
contract_code | string | 否 | — | 期权合约代码 (可选) |
date | string | 否 | — | 指定日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 500 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/markets/options/snapshot?date=2026-06-18&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
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
停复牌事件
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | Start Date |
end_date | string | 否 | — | End Date |
symbol | string | 否 | — | |
market | string | 否 | — | |
limit | integer | 否 | 300 |
cURL 调用示例
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 调用示例
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())