API 接口文档
证券基础资料与特征
股票列表、基本资料、每日估值指标、IPO新股、风险警示板、指数、基金与可转债接口指南。
证券基础资料与特征 API
股票列表、基本资料、每日估值指标、IPO新股、风险警示板、指数、基金与可转债接口指南。
接口清单汇总(共 18 项)
| 接口端点 | 请求方法 | 关键查询参数 | 功能说明 |
|---|---|---|---|
/v1/bonds/detail | GET | symbol, limit | 债券详情 |
/v1/bonds/history | GET | symbol, interval, start_date, end_date, limit | 债券历史行情 |
/v1/bonds/info | GET | page, page_size, keyword, exchange, security_type | Get Bond List |
/v1/funds/history | GET | symbol, interval, start_date, end_date, limit | 基金历史行情 |
/v1/funds/info | GET | page, page_size, keyword, exchange, security_type | 基金列表 |
/v1/indices/history | GET | symbol, interval, start_date, end_date, limit | 指数历史行情 |
/v1/indices/info | GET | page, page_size, keyword, exchange | Get Index List |
/v1/stocks/adjust-factor | GET | symbol, start_date, end_date, limit | Get Adjust Factor |
/v1/stocks/daily-basic | GET | symbol, date, start_date, end_date, sort_by, order, page, page_size | 每日个股指标大师表 |
/v1/stocks/delisted | GET | exchange, start_date, end_date, limit | 退市股票列表 |
/v1/stocks/esg-rating | GET | symbol, date | 股票 ESG 评级 |
/v1/stocks/index-constituents | GET | index_code | 指数成分股 (R19) |
/v1/stocks/info | GET | page, page_size, keyword, exchange, security_type | Get Stock List |
/v1/stocks/ipo | GET | start_date, end_date, limit | IPO新股列表 |
/v1/stocks/name-history | GET | symbol, limit | 股票历史曾用名 |
/v1/stocks/profile | GET | symbol | 股票基本信息/Profile |
/v1/stocks/risk-board | GET | limit | 风险警示板/ST股票 |
/v1/stocks/search | GET | q, limit | 股票搜索 |
详细接口规范与调用示例
GET /v1/bonds/detail
债券详情
获取可转债详细信息
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 证券代码 (可选) |
limit | integer | 否 | 100 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/bonds/detail?symbol=sz.000001&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/bonds/detail"
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/bonds/history
债券历史行情
获取债券历史K线数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 债券代码 (如: sz.123059) |
interval | string | 否 | daily | K线周期 (支持: 1d/daily, 1w/weekly, 1M/monthly) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 200 | 返回条数 (兼容参数) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/bonds/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/bonds/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/bonds/info
Get Bond List
获取债券列表
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
page | integer | 否 | 1 | 页码,从 1 开始 |
page_size | integer | 否 | 50 | 每页条数 |
keyword | string | 否 | — | 代码/名称/类型关键词 (可选) |
exchange | string | 否 | — | 交易所过滤 (SSE/SZSE/BSE) (可选) |
security_type | string | 否 | — | 债券类型过滤 (可选) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/bonds/info" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/bonds/info"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"page": "value",
"page_size": "value",
"keyword": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/funds/history
基金历史行情
获取基金历史K线数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 基金代码 (如: sh.510300) |
interval | string | 否 | daily | K线周期 (支持: 1d/daily, 1w/weekly, 1M/monthly) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 200 | 返回条数 (兼容参数) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/funds/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/funds/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/funds/info
基金列表
获取全量基金/ETF列表数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
page | integer | 否 | 1 | 页码,从 1 开始 |
page_size | integer | 否 | 50 | 每页条数 |
keyword | string | 否 | — | 代码/名称/类型关键词 (可选) |
exchange | string | 否 | — | 交易所过滤 (SSE/SZSE/BSE) (可选) |
security_type | string | 否 | — | 基金类型过滤 (可选) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/funds/info" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/funds/info"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"page": "value",
"page_size": "value",
"keyword": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/indices/history
指数历史行情
获取指数历史K线数据
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 指数代码 (如: sh.000001, sz.399001) |
interval | string | 否 | daily | K线周期 (支持: 1d/daily, 1w/weekly, 1M/monthly) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 200 | 返回条数 (兼容参数) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/indices/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/indices/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/indices/info
Get Index List
获取指数列表
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
page | integer | 否 | 1 | 页码,从 1 开始 |
page_size | integer | 否 | 50 | 每页条数 |
keyword | string | 否 | — | 代码/名称关键词 (可选) |
exchange | string | 否 | — | 交易所过滤 (SSE/SZSE/BSE) (可选) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/indices/info" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/indices/info"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"page": "value",
"page_size": "value",
"keyword": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/stocks/adjust-factor
Get Adjust Factor
获取股票复权因子 (前复权/后复权)。
返回股票的每日向前和向后复权因子。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sz.000001, sh.600519) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 1000 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/adjust-factor?symbol=sz.000001&start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/adjust-factor"
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/stocks/daily-basic
每日个股指标大师表
获取个股每日综合指标汇总。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sz.000001, sh.600519) |
date | string | 否 | — | 交易日期 (YYYY-MM-DD) (可选) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
sort_by | string | 否 | — | 排序字段 (可选) |
order | string | 否 | desc | 排序方向 (asc/desc) |
page | integer | 否 | 1 | 页码,从 1 开始 |
page_size | integer | 否 | 50 | 每页条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/daily-basic?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/stocks/daily-basic"
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/stocks/delisted
退市股票列表
获取历史退市股票列表(含上交所、深交所、两网及退市整理股)。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
exchange | string | 否 | — | 交易所过滤 (SSE=上交所, SZSE=深交所, BSE=北交所) (可选) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 500 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/delisted?start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/delisted"
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/stocks/esg-rating
股票 ESG 评级
获取股票的 ESG 评级和各项得分 (包括环境、社会、治理以及争议得分)。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sz.000001, sh.600519) |
date | string | 否 | — | 指定日期 (YYYY-MM-DD) (可选,默认返回最新数据) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/esg-rating?symbol=sz.000001&date=2026-06-18" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/esg-rating"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/stocks/index-constituents
指数成分股 (R19)
获取指数成分股列表 (沪深300/中证500/上证50/中证1000/创业板指/科创50)。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
index_code | string | 否 | 000300 | 指数代码 (000300/000905/000016/000852/399006/000688) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/index-constituents" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/index-constituents"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"index_code": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/stocks/info
Get Stock List
获取上市公司列表
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
page | integer | 否 | 1 | 页码,从 1 开始 |
page_size | integer | 否 | 50 | 每页条数 |
keyword | string | 否 | — | 代码/名称/类型关键词 (可选) |
exchange | string | 否 | — | 交易所过滤 (SSE/SZSE/BSE) (可选) |
security_type | string | 否 | — | 证券类型过滤 (可选) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/info" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/info"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"page": "value",
"page_size": "value",
"keyword": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/stocks/ipo
IPO新股列表
获取新股发行上市列表,包含发行价、市盈率、募资金额等。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | IPO日期起 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | IPO日期止 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 200 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/ipo?start_date=2026-01-01&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/ipo"
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/stocks/name-history
股票历史曾用名
获取股票历史更名记录。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 股票代码 (如: sz.000001, sh.600519) (可选,不填返回全量) |
limit | integer | 否 | 200 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/name-history?symbol=sz.000001&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/name-history"
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/stocks/profile
股票基本信息/Profile
获取单个股票的基本信息和Profile数据。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 必填 | — | 股票代码 (如: sz.000001, sh.600519) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/profile?symbol=sz.000001" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/profile"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/stocks/risk-board
风险警示板/ST股票
获取当前处于风险警示板(ST/*ST/SST)的股票列表。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
limit | integer | 否 | 500 | 返回条数 (兼容参数) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/risk-board?limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/risk-board"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/stocks/search
股票搜索
通过代码或名称模糊搜索股票
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
q | string | 否 | — | 搜索关键词 (代码或名称) |
limit | integer | 否 | 10 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/search?limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/search"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"q": "value",
"limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())