POSTPublicfinance-internal-futures-price

Chinese Domestic Futures Quotes

Documentation

API Introduction

This API provides real-time quote data for the domestic futures market. By passing the futures product code (symbol), you can obtain market depth data including the latest price, change percentage, trading volume, open interest, and bid/ask prices from level one to five. The data includes a timestamp, suitable for business scenarios requiring immediate market display.

Use Cases

Financial News Applications: Display real-time trends and key indicators of futures products in apps or on websites.
Quantitative Trading Assistance: Provide basic price and order book liquidity references for strategy systems.
Risk Monitoring Dashboard: Real-time monitoring of price fluctuations and trading activity for specific contracts.

Request and Response Description

Request Method: POST
Core Parameter: symbol (Required), the futures product code, must be passed according to the standard code table.
Response Structure:
code/msg: Business status code and description, 200 indicates success.
data: Contains specific market data fields.
price: Real-time latest price.
change/changeRate: Change amount and change rate.
volume/hold: Trading volume and open interest.
bid1~bid5/ask1~: Five-level bid and ask prices.

Integration Suggestions

Code Mapping: Please ensure that the symbol passed is consistent with the code table provided by the exchange or service provider to avoid query failures.
Frequency Control: Real-time market data updates frequently. It is recommended to set a reasonable polling interval based on actual business needs to avoid unnecessary calls.
Data Validation: Parse the returned code field to confirm successful business logic before extracting numerical values from data for display or calculation.

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": "202960247220113090298671",
  "data": {
    "ask_vol": "28",
    "settle": "558.180",
    "bid1_vol": "10",
    "hold": "179472.000",
    "update_time": 1715756400,
    "high": "559.900",
    "low": "556.140",
    "price": "559.020",
    "ask1_vol": "28",
    "bid2_vol": "11",
    "changeRate": "0.53",
    "ask5_vol": "5",
    "presettle": "556.060",
    "avg_px": "558.180",
    "bid4_vol": "3",
    "change": "2.960",
    "bid3_vol": "1",
    "bid_vol": "10",
    "ask2_vol": "2",
    "volume": "155143",
    "bid5_vol": "1",
    "ask4_vol": "4",
    "ask5": "559.100",
    "ask2": "559.040",
    "ask1": "559.020",
    "bid5": "558.840",
    "ask4": "559.080",
    "ask3": "559.060",
    "name": "黄金连续",
    "ask": "559.020",
    "bid3": "558.880",
    "bid4": "558.860",
    "bid1": "558.920",
    "bid2": "558.900",
    "bid": "558.920",
    "open": "556.980",
    "ask3_vol": "11"
  }
}

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-internal-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-internal-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-internal-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-internal-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-internal-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;

Chinese Domestic 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