API 接口文档

期货行情与基差

股指期货与商品期货主力连续合约 K 线行情、实时报价与基差快照。

期货行情与基差 API

股指期货与商品期货主力连续合约 K 线行情、实时报价与基差快照。

接口清单汇总(共 4 项)

接口端点请求方法关键查询参数功能说明
/v1/futures/commodity/historyGETsymbol, start_date, end_date, limit商品期货 K 线 (R4)
/v1/futures/index/historyGETsymbol, start_date, end_date, limit股指期货 K 线 (R1)
/v1/futures/index/snapshotGETsymbol, date股指期货快照 (R2)
/v1/futures/symbolsGET—期货品种列表

详细接口规范与调用示例

GET /v1/futures/commodity/history

商品期货 K 线 (R4)

获取商品期货主力连续日K线 (RB/SC/AU/CU/AL/M/RM/CF/SR/HC/FU/AG)。

请求参数

参数名类型必填默认值描述
symbolstring否RB品种代码 (RB/SC/AU/CU/AL/M/RM/CF/SR/HC/FU/AG)
start_datestring否—开始日期 (YYYY-MM-DD)
end_datestring否—结束日期 (YYYY-MM-DD)
limitinteger否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)。

请求参数

参数名类型必填默认值描述
symbolstring否IF品种代码 (IF/IC/IM/IH)
start_datestring否—开始日期 (YYYY-MM-DD)
end_datestring否—结束日期 (YYYY-MM-DD)
limitinteger否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 参数查询历史日期的报价。

请求参数

参数名类型必填默认值描述
symbolstring否IF品种代码 (IF/IC/IM/IH)
datestring否—截止日期 (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())