Futures Contracts
Index futures (IF, IC, IM, IH) and commodity futures continuous contract klines and basis snapshots.
Futures Contracts API
Index futures (IF, IC, IM, IH) and commodity futures continuous contract klines and basis snapshots.
Endpoints Summary (4 endpoints)
| Endpoint | Method | Key Parameters | Description |
|---|---|---|---|
/v1/futures/commodity/history | GET | symbol, start_date, end_date, limit | Commodity Futures K-line (R4) |
/v1/futures/index/history | GET | symbol, start_date, end_date, limit | Stock Index Futures K-line (R1) |
/v1/futures/index/snapshot | GET | symbol, date | Stock Index Futures Snapshot (R2) |
/v1/futures/symbols | GET | — | Futures Products List |
Detailed Endpoint Specifications
GET /v1/futures/commodity/history
Commodity Futures K-line (R4)
Get daily K-lines for commodity futures dominant continuous contracts (RB/SC/AU/CU/AL/M/RM/CF/SR/HC/FU/AG).
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Optional | RB | Product code (RB/SC/AU/CU/AL/M/RM/CF/SR/HC/FU/AG) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) |
end_date | string | Optional | — | End date (YYYY-MM-DD) |
limit | integer | Optional | 500 | Number of rows to return |
cURL Example
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 Example
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
Stock Index Futures K-line (R1)
Get daily K-lines for stock index futures dominant continuous contracts (IF/IC/IM/IH).
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Optional | IF | Product code (IF/IC/IM/IH) |
start_date | string | Optional | — | Start date (YYYY-MM-DD) |
end_date | string | Optional | — | End date (YYYY-MM-DD) |
limit | integer | Optional | 500 | Number of rows to return |
cURL Example
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 Example
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
Stock Index Futures Snapshot (R2)
Get the latest quotes for the specified stock index futures product (including a basis placeholder field). Use the date parameter to query quotes for a historical date.
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Optional | IF | Product code (IF/IC/IM/IH) |
date | string | Optional | — | Cutoff date (YYYY-MM-DD); if omitted, the latest available data is returned |
cURL Example
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 Example
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
Futures Products List
Get the list of all available futures products.
(No query parameters required)
cURL Example
curl -X GET "https://tickerlab.org/v1/futures/symbols" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python Example
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())