POSTPublicfinance-external-futures-price

Global Futures Quotes

Documentation

API Introduction

This API provides real-time quote data for major international futures products. By passing a specific futures product code (symbol), you can obtain core market data fields including the latest price, bid/ask order book, trading volume, open interest, and change percentage. The data is suitable for business scenarios requiring monitoring of international commodities and financial derivatives prices.

Use Cases

Financial News Platforms: Display real-time dynamics and market trends of the international futures market.
Quantitative Trading Assistance: Provide basic price and volume data input for strategy models.
Enterprise Risk Management: Monitor international price fluctuations of raw materials (e.g., crude oil, metals, agricultural products).
Personal Investment Tools: Develop market monitoring software or price alert notification services.

Request and Response Description

Request Method: POST
Key Parameter: symbol (Required), the futures product code, must be passed with a valid value referencing the official code table.
Response Structure:
code/msg: API status code and description, 200 indicates success.
data: Object containing specific market data.
price: Real-time latest price.
bid/ask: Bid 1 price and Ask 1 price.
volume/hold: Trading volume and open interest.
change/changeRate: Change amount and change rate.

Integration Suggestions

Code Mapping: Please ensure to maintain a valid symbol code table to avoid query failures caused by passing invalid codes.
Frequency Control: Real-time market data updates frequently. It is recommended to set a reasonable polling interval based on actual business needs to avoid high-frequency invalid requests.
Data Validation: When parsing the returned data, please check the code field to ensure the request was successful, and pay attention to handling network exceptions or timeouts.
Time Zone Note: update_time is in timestamp format; it needs to be converted to the user's local time zone for front-end display.

Integration Examples

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

Request Example

{
  "symbol": "期货品种代码，详见代码表"
}

Response Example

{
  "msg": "成功",
  "code": 200,
  "taskNo": "883993816152322760914592",
  "data": {
    "change": "5.0300",
    "ask_vol": "3",
    "bid_vol": "10",
    "hold": "249261.000",
    "volume": "5347",
    "high": "312.800",
    "update_time": 1721629440,
    "low": "307.600",
    "price": "312.530",
    "name": "美黄豆粉",
    "ask": "312.600",
    "changeRate": "1.6358",
    "preclose": "307.500",
    "bid": "312.500",
    "open": "307.600"
  }
}

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	期货品种代码，详见代码表
required	array	"symbol"
required[]	string	symbol

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-price' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "symbol": "期货品种代码，详见代码表"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/finance-external-futures-price" payload = { "symbol": "期货品种代码，详见代码表" } 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-price" payload := []byte("{\n \"symbol\": \"期货品种代码，详见代码表\"\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}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/finance-external-futures-price")) .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-price'; $payload = "{\n \"symbol\": \"期货品种代码，详见代码表\"\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 Quotes

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