API 接口文档

市场行情与交易数据

历史K线行情、融资融券、大宗交易、期权快照与交易日历接口指南。

市场行情与交易数据 API

历史K线行情、融资融券、大宗交易、期权快照与交易日历接口指南。

接口清单汇总(共 16 项)

接口端点请求方法关键查询参数功能说明
/v1/export/historyGETsymbol, start_date, end_date, interval, format导出历史数据
/v1/markets/block-trade-dailyGETstart_date, end_date, limit大宗交易市场统计
/v1/markets/block-trade-detailGETsymbol, date, limit大宗交易明细
/v1/markets/board-summaryGETexchange, date, item, limit板块交易汇总数据
/v1/markets/bond/profileGETsymbol, limitGet Bond Profile
/v1/markets/calendarGETexchange, start_date, end_date, is_trading_day, page, page_sizeGet Trade Calendar
/v1/markets/finance/analyst-consensusGETsymbol, date, start_date, end_date, limitGet Analyst Consensus
/v1/markets/finance/forecast-summaryGETsymbol, date, start_date, end_date, limitGet Forecast Summary
/v1/markets/finance/growthGETsymbol, date, start_date, end_date, limitGet Finance Growth
/v1/markets/historyGETsymbol, interval, start_date, end_date, adjustGet Market History
/v1/markets/hsgt-stock-statisticsGETstart_date, end_date, symbol, limit北向持股统计
/v1/markets/ivixGETunderlying, start_date, end_date, limitETF 期权 iVIX (R3)
/v1/markets/marginGETstart_date, end_date, limit融资融券市场汇总
/v1/markets/margin-detailGETstart_date, end_date, exchange, symbol, limit融资融券个股明细
/v1/markets/options/snapshotGETunderlying, contract_code, date, limit期权行情快照
/v1/markets/suspend-resume-eventsGETstart_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 显示为准

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (例如: sz.000001)
start_datestring必填—开始日期 (YYYY-MM-DD)
end_datestring必填—结束日期 (YYYY-MM-DD)
intervalstring否1dK线周期 (支持: 1d/daily, 1w/weekly, 1M/monthly)
formatstring否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_datestring否—Start Date
end_datestring否—End Date
limitinteger否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

大宗交易明细

请求参数

参数名类型必填默认值描述
symbolstring否—
datestring否—
limitinteger否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

板块交易汇总数据

获取主要板块/交易所 (上交所、深交所) 的市场交易指标汇总 (如市价总值、平均市盈率等)。

请求参数

参数名类型必填默认值描述
exchangestring否—交易所代码 (如: SSE, SZSE) (可选)
datestring否—指定日期 (YYYY-MM-DD) (可选,默认返回最新数据)
itemstring否—指标项名称 (如: 市价总值, 平均市盈率) (可选)
limitinteger否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)。

包含可转债溢价率、转股价值、到期收益率等综合指标。

请求参数

参数名类型必填默认值描述
symbolstring否—债券代码(可选)
limitinteger否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

获取交易日历。

返回每个交易所的日期和交易日状态。

请求参数

参数名类型必填默认值描述
exchangestring否—交易所代码 (SSE/SZSE) (可选)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
is_trading_daystring否—过滤交易日 (1=是, 0=否) (可选)
pageinteger否1页码,从 1 开始
page_sizeinteger否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)。

包含机构评级、目标价、盈利预测等分析师共识数据。

请求参数

参数名类型必填默认值描述
symbolstring否—股票代码(可选,不填返回全市场)
datestring否—统计日期 (YYYY-MM-DD,可选)
start_datestring否—开始统计日期 (YYYY-MM-DD)
end_datestring否—结束统计日期 (YYYY-MM-DD)
limitinteger否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)。

请求参数

参数名类型必填默认值描述
symbolstring否—股票代码 (如: sz.000001, sh.600519) (可选)
datestring否—统计日期 (YYYY-MM-DD) (可选)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
limitinteger否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)。

请求参数

参数名类型必填默认值描述
symbolstring否—股票代码 (如: sz.000001, sh.600519) (可选)
datestring否—报告期 (YYYY-MM-DD) (可选)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
limitinteger否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数据导出。

请求参数

参数名类型必填默认值描述
symbolstring必填—股票代码 (如: sz.000001, sh.600519)
intervalstring否1dK线周期 (支持: 1d/daily, 1w/weekly, 1M/monthly)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
adjuststring否—复权类型 (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_datestring否—Start Date
end_datestring否—End Date
symbolstring否—
limitinteger否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 恐慌指数。

请求参数

参数名类型必填默认值描述
underlyingstring否—标的 (如 etf_option)
start_datestring否—开始日期 (YYYY-MM-DD)
end_datestring否—结束日期 (YYYY-MM-DD)
limitinteger否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_datestring否—Start Date
end_datestring否—End Date
limitinteger否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_datestring否—Start Date
end_datestring否—End Date
exchangestring否—
symbolstring否—
limitinteger否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

期权行情快照

获取期权市场的行情快照数据 (包括认购/认沽类型、行权价、到期日、最新价、结算价等)。

请求参数

参数名类型必填默认值描述
underlyingstring否—标的证券名称 (如: etf_option) (可选)
contract_codestring否—期权合约代码 (可选)
datestring否—指定日期 (YYYY-MM-DD) (可选)
limitinteger否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_datestring否—Start Date
end_datestring否—End Date
symbolstring否—
marketstring否—
limitinteger否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())