finance-us-shares-kline

美股K線

呼叫價格

5 匠幣/次

快速接入請求欄位響應欄位介面簡介

快速接入

保持統一返回結構，直接透過服務端發起請求即可接入。

POSThttps://openapi.toolkk.com/v1/finance-us-shares-kline

cURL Python Go Java PHP

cURL 示例

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/finance-us-shares-kline' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "symbol": "品种代码",\n  "type": "k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，21600...",\n  "limit": "返回条数，默认10"\n}'

Python 示例

import os
import requests

url = "https://openapi.toolkk.com/v1/finance-us-shares-kline"
payload = {
  "symbol": "品种代码",
  "type": "k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，21600...",
  "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 示例

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    endpoint := "https://openapi.toolkk.com/v1/finance-us-shares-kline"
    payload := []byte("{\n  \"symbol\": \"品种代码\",\n  \"type\": \"k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，21600...\",\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 示例

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线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，21600...\",\n  \"limit\": \"返回条数，默认10\"\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/finance-us-shares-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 示例

<?php

$endpoint = 'https://openapi.toolkk.com/v1/finance-us-shares-kline';
$payload = "{\n  \"symbol\": \"品种代码\",\n  \"type\": \"k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，21600...\",\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;

響應示例

{
  "msg": "成功",
  "code": 200,
  "taskNo": "279719607212732212780135",
  "data": {
    "list": [
      {
        "volume": 1689339,
        "high": "220.5800",
        "amount": 371739000,
        "low": "219.6200",
        "day": "2024-07-03 11:00:00",
        "close": "220.5400",
        "open": "219.8300"
      }
    ]
  }
}

範例用於理解回傳結構，實際結果以介面回傳為準。

請求欄位

從伺服器發起請求，並在 X-API-Key 標頭中傳入金鑰。

請求欄位

欄位來自介面結構定義。未提供的說明和範例會標為未標註。

欄位路徑	型別	必填	說明	示例值
symbol	`string`	是	品种代码	`未標註`
type	`string`	是	k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，21600:季K，43200:半年K，86400:年K	`未標註`
limit	`string`	否	返回条数，默认10	`未標註`

請求示例

{
  "symbol": "品种代码",
  "type": "k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，21600...",
  "limit": "返回条数，默认10"
}

鑑權方式: 請求頭傳入 X-API-Key
預設限流: 60 次/分鐘
超時時間: 5000 ms

響應欄位

範例用於理解回傳結構，實際結果以介面回傳為準。

響應欄位

欄位來自介面結構定義。未提供的說明和範例會標為未標註。

欄位路徑	型別	必填	說明	示例值
msg	`string`	否	返回码对应描述	`成功`
code	`number`	否	返回码，详见返回码说明	`200`
taskNo	`string`	否	本次请求号	`279719607212732212780135`
data	`object`	否	未標註	`未標註`
data.list	`array`	否	未標註	`[{"volume":1689339,"high":"220.5800","amount":371739000,"low":"219.6200","day":"2024-07-03 11:00:00","close":"220.5400","open":"219.8300"}]`
data.list[]	`object`	未標註	未標註	`未標註`

響應示例

{
  "msg": "成功",
  "code": 200,
  "taskNo": "279719607212732212780135",
  "data": {
    "list": [
      {
        "volume": 1689339,
        "high": "220.5800",
        "amount": 371739000,
        "low": "219.6200",
        "day": "2024-07-03 11:00:00",
        "close": "220.5400",
        "open": "219.8300"
      }
    ]
  }
}

msg

data

list

open

high

low

close

volume

amount

day

美股K線數據查詢API - 多週期歷史行情接口 | 工具匠

美股K線

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

響應示例

請求欄位

請求欄位

請求示例

響應欄位

響應欄位

響應示例

介面簡介

介面簡介

適用場景

請求與返回說明

相關推薦

接入建議

美股K線查詢

開庭公告檢索

裁判文書檢索

法院公告檢索

審判流程檢索

法院公告詳情查詢

裁判文書詳情查詢

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

響應示例

請求欄位

請求欄位

請求示例

響應欄位

響應欄位

響應示例

介面簡介

介面簡介

適用場景

請求與返回說明

相關推薦

相關工具

相關 API

接入建議

美股K線查詢

開庭公告檢索

裁判文書檢索

法院公告檢索

審判流程檢索

法院公告詳情查詢

裁判文書詳情查詢