POST公開中finance-internal-futures-price

国内先物価格

導入ドキュメント

インターフェースの紹介

このインターフェースは、国内先物市場のリアルタイム相場データを提供します。先物商品コード（シンボル）を渡すことで、最新の価格、増減、出来高、建玉、買い1～5、売り1～売り5などの相場デプスデータを取得できます。データにはタイムスタンプが含まれているため、リアルタイムの相場表示が必要なビジネスシーンに最適です。

該当するシナリオ

財務情報アプリケーション: アプリまたはウェブサイトで先物品種のリアルタイムの傾向と主要な指標を表示します。
定量的取引支援: 戦略システムの基本的な価格と市場流動性のリファレンスを提供します。
リスク監視委員会: 特定の契約の価格変動と取引活動をリアルタイムで監視します。

リクエストと返品の手順

リクエスト方法: POST
コアパラメータ: symbol (必須)。これは先物商品コードであり、標準コードテーブルに従って渡す必要があります。
戻り構造:
code/msg: ビジネスステータスコードと説明。200 は成功を意味します。
data: 特定の市場フィールドが含まれます。
価格: 最新のリアルタイム価格。
change/changeRate: 増減量と増減率。
volume/hold: 取引高と建玉。
bid1〜bid5/ask1〜ask5：買値と売値の5段階。

提案へのアクセス

コードマッピング: クエリの失敗を避けるために、受信する「シンボル」が取引所またはサービスプロバイダーによって提供されるコードテーブルと一致していることを確認してください。
頻度制御: リアルタイムの市場データは頻繁に更新されます。無効な呼び出しを避けるために、実際のビジネスニーズに応じて適切なポーリング間隔を設定することをお勧めします。
データ検証: 返された code フィールドを解析してビジネスロジックが成功したことを確認し、表示または計算のために data 内の値を抽出します。

実装サンプルコード

Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。

リクエスト例

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

レスポンス例

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

リクエスト項目

以下の項目はサンプル JSON から自動抽出した参考情報です。

パス	型	サンプル値
type	string	object
properties	object	{...}
properties.symbol	object	{...}
properties.symbol.type	string	string
properties.symbol.description	string	期货品种代码，详见代码表
required	array	"symbol"
required[]	string	symbol

レスポンス項目

以下の項目はサンプル JSON から自動抽出した参考情報です。

パス	型	サンプル値
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;

国内先物価格

導入ドキュメント

インターフェースの紹介

該当するシナリオ

リクエストと返品の手順

提案へのアクセス

実装サンプルコード

リクエスト例

レスポンス例

リクエスト項目

レスポンス項目

Shell 例

Python 例

Go 例

Java 例

PHP 例

オンライン試用