POSTPublicfinance-external-futures-kline

Global Futures Candlestick Charts

Documentation

API Introduction

This API provides historical K-line market data for major international futures products. It supports obtaining a complete OHLCV data array, including open, close, high, low, trading volume, and timestamp, by specifying the futures code and time period (e.g., 1-minute, 5-minute, 30-minute, 60-minute, daily K-line, etc.).

Use Cases

Quantitative Trading Strategy Backtesting: Obtain high-frequency or low-frequency historical data for model training and validation.
Real-time Market Monitoring: Build international futures charting tools to display price trends across different time dimensions.
Financial Data Analysis: A fundamental data source for volatility calculation and technical indicator analysis (e.g., MA, MACD).

Request and Response Description

Request Parameters:

symbol (Required): Futures product code, must be filled according to the code table provided by the platform.
type (Required): K-line type, supports '0' (Daily K), '1' (1-minute), '5' (5-minute), '30' (30-minute), '60' (60-minute), '120' (120-minute), '240' (240-minute).
limit (Optional): Number of data entries to return, defaults to 10.

Response Result:

code/msg: Status code and description, 200 indicates success.
fields: Field definition array, order corresponds to values in data rows, typically includes open, close, high, low, change, changeRate, volume, tick_at.
lines: Two-dimensional array, each row represents a K-line, numerical order corresponds one-to-one with fields.

Integration Suggestions

Code Mapping: Please ensure to obtain and maintain the latest futures product code table to ensure the symbol parameter is accurate.
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 lines is a pure numerical array; it needs to be parsed with key-value mapping using the fields array. Note that tick_at is typically a Unix timestamp.

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": "成功",
  "code": 200,
  "taskNo": "906962467150026863697586",
  "lines": [
    [
      2.419,
      2.422,
      2.422,
      2.419,
      0,
      0.12,
      65,
      1721696400
    ]
  ],
  "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.code	object	{...}

curl --request POST \ --url 'https://openapi.toolkk.com/v1/finance-external-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-external-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-external-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-external-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-external-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;

Global Futures Candlestick Charts

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