API 接口文档
期货行情与基差
股指期货与商品期货主力连续合约 K 线行情、实时报价与基差快照。
期货行情与基差 API
股指期货与商品期货主力连续合约 K 线行情、实时报价与基差快照。
接口清单汇总(共 4 项)
| 接口端点 | 请求方法 | 关键查询参数 | 功能说明 |
|---|---|---|---|
/v1/futures/commodity/history | GET | symbol, start_date, end_date, limit | 商品期货 K 线 (R4) |
/v1/futures/index/history | GET | symbol, start_date, end_date, limit | 股指期货 K 线 (R1) |
/v1/futures/index/snapshot | GET | symbol, date | 股指期货快照 (R2) |
/v1/futures/symbols | GET | — | 期货品种列表 |
详细接口规范与调用示例
GET /v1/futures/commodity/history
商品期货 K 线 (R4)
获取商品期货主力连续日K线 (RB/SC/AU/CU/AL/M/RM/CF/SR/HC/FU/AG)。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | RB | 品种代码 (RB/SC/AU/CU/AL/M/RM/CF/SR/HC/FU/AG) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) |
limit | integer | 否 | 500 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/futures/commodity/history?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/futures/commodity/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/futures/index/history
股指期货 K 线 (R1)
获取股指期货主力连续日K线 (IF/IC/IM/IH)。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | IF | 品种代码 (IF/IC/IM/IH) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) |
limit | integer | 否 | 500 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/futures/index/history?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/futures/index/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/futures/index/snapshot
股指期货快照 (R2)
获取指定股指期货品种的最新报价 (含基差占位字段)。可通过 date 参数查询历史日期的报价。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | IF | 品种代码 (IF/IC/IM/IH) |
date | string | 否 | — | 截止日期 (YYYY-MM-DD);不填则返回最新可用数据 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/futures/index/snapshot?symbol=sz.000001&date=2026-06-18" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/futures/index/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())
GET /v1/futures/symbols
期货品种列表
获取所有可用的期货品种列表。
(无需查询参数)
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/futures/symbols" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/futures/symbols"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())