International Futures Multi-Period K-Line Data API

We use cookies.This website uses essential cookies to operate core features. With your consent, we also use analytics cookies to understand traffic and improve the service. For more details, see our .

International Futures K-Line Data API - Multi-Period Market Query | Toolkk

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	{...}

Shell Example

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}'

Python Example

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())

Go Example

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))
}

Java Example

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 Example

<?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