POSTPublicfinance-internal-futures-kline

Domestic Futures Candlestick Chart

Domestic Futures Candlestick Charts

Documentation

API Introduction

This API provides historical K-line data query services for the domestic futures market. It supports obtaining market data for specified periods via futures product codes, covering core indicators such as open, close, high, low, and trading volume. Data is returned in an array format, facilitating front-end chart rendering or back-end quantitative calculations.

Use Cases

Quantitative Trading Strategy Backtesting: Obtain historical minute-level or daily data for strategy validation.
Financial Terminal Development: Provide real-time or historical K-line chart data sources for apps or web clients.
Market Trend Monitoring: Monitor the volatility of specific futures products to assist investment decisions.

Request and Response Description

Request Method: POST Key Parameters:

symbol (Required): Futures product code, must refer to the standard code table.
type (Required): K-line type, supports 0 (Daily K), 1 (1-minute), 5 (5-minute), 30/60/120/240 minutes, etc.
limit (Optional): Number of data entries to return, defaults to 10.

Response Structure:

data.lines: Two-dimensional array, each item represents a K-line, ordered corresponding to fields defined in fields (e.g., open, close, high, low, change, changeRate, volume, tick_at).
data.fields: Field definition array, clarifying the specific meaning of each value in lines.
code: Status code, 200 indicates success.

Integration Suggestions

Code Mapping: Please ensure that the symbol passed is consistent with the exchange's standard code to avoid query failures.
Period Selection: Choose the appropriate type based on business needs; minute-level data is recommended for high-frequency trading, and daily K-lines for trend analysis.
Data Parsing: The returned K-line data is in a compact array format and needs to be parsed with key-value mapping using the fields array to improve transmission efficiency.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "symbol": "期货品种代码，详见代码表",
  "type": "k线类型，0:日k，1:1分钟，5：五分钟；30:30分钟，60:60分钟，120:120分钟，240:240分钟",
  "limit": "返回条数，默认10"
}

Response Example

{
  "msg": "成功",
  "taskNo": "075556736233047430019762",
  "code": 200,
  "data": {
    "lines": [
      [
        552.44,
        552.82,
        553.2,
        552.36,
        0.38,
        0.07,
        2516,
        1717178400
      ]
    ],
    "fields": [
      "open",
      "close",
      "high",
      "low",
      "change",
      "changeRate",
      "volume",
      "tick_at"
    ]
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
type	string	object
properties	object	{...}
properties.symbol	object	{...}
properties.symbol.type	string	string
properties.symbol.description	string	期货品种代码，详见代码表
properties.type	object	{...}
properties.type.type	string

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
type	string	object
properties	object	{...}
properties.msg	object	{...}
properties.msg.type	string	string
properties.msg.example	string	成功
properties.msg.description	string	返回码对应描述
properties.taskNo	object	{...}

curl --request POST \ --url 'https://openapi.toolkk.com/v1/finance-internal-futures-kline' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "symbol": "期货品种代码，详见代码表",\n "type": "k线类型，0:日k，1:1分钟，5：五分钟；30:30分钟，60:60分钟，120:120分钟，240:240分钟",\n "limit": "返回条数，默认10"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/finance-internal-futures-kline" payload = { "symbol": "期货品种代码，详见代码表", "type": "k线类型，0:日k，1:1分钟，5：五分钟；30:30分钟，60:60分钟，120:120分钟，240:240分钟", "limit": "返回条数，默认10" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/finance-internal-futures-kline" payload := []byte("{\n \"symbol\": \"期货品种代码，详见代码表\",\n \"type\": \"k线类型，0:日k，1:1分钟，5：五分钟；30:30分钟，60:60分钟，120:120分钟，240:240分钟\",\n \"limit\": \"返回条数，默认10\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"symbol\": \"期货品种代码，详见代码表\",\n \"type\": \"k线类型，0:日k，1:1分钟，5：五分钟；30:30分钟，60:60分钟，120:120分钟，240:240分钟\",\n \"limit\": \"返回条数，默认10\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/finance-internal-futures-kline")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/finance-internal-futures-kline'; $payload = "{\n \"symbol\": \"期货品种代码，详见代码表\",\n \"type\": \"k线类型，0:日k，1:1分钟，5：五分钟；30:30分钟，60:60分钟，120:120分钟，240:240分钟\",\n \"limit\": \"返回条数，默认10\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

Domestic Futures Candlestick Chart

Documentation

API Introduction

Use Cases

Request and Response Description

Integration Suggestions

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online