DOCUMENTATION

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)

EndpointMethodKey ParametersDescription
/v1/futures/commodity/historyGETsymbol, start_date, end_date, limitCommodity Futures K-line (R4)
/v1/futures/index/historyGETsymbol, start_date, end_date, limitStock Index Futures K-line (R1)
/v1/futures/index/snapshotGETsymbol, dateStock Index Futures Snapshot (R2)
/v1/futures/symbolsGET—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

ParameterTypeRequiredDefaultDescription
symbolstringOptionalRBProduct code (RB/SC/AU/CU/AL/M/RM/CF/SR/HC/FU/AG)
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional500Number 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

ParameterTypeRequiredDefaultDescription
symbolstringOptionalIFProduct code (IF/IC/IM/IH)
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional500Number 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

ParameterTypeRequiredDefaultDescription
symbolstringOptionalIFProduct code (IF/IC/IM/IH)
datestringOptional—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())