POSTPublicinternational-crude-oil-price-query

International Crude Oil Price Quote

Retrieve the latest WTI and Brent crude oil prices and daily market data.

Documentation

Select WTI or Brent crude oil to retrieve the latest price, opening price, previous close, intraday high and low, absolute change, percentage change, and data timestamp.

Integration Examples

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

Shell ExamplePython ExampleGo ExampleJava ExamplePHP Example

Shell Example

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/international-crude-oil-price-query' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "code": "wti"\n}'

Python Example

import os
import requests

url = "https://openapi.toolkk.com/v1/international-crude-oil-price-query"
payload = {
  "code": "wti"
}

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/international-crude-oil-price-query"
    payload := []byte("{\n  \"code\": \"wti\"\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  \"code\": \"wti\"\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/international-crude-oil-price-query"))
            .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/international-crude-oil-price-query';
$payload = "{\n  \"code\": \"wti\"\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;

Request Example

{
  "code": "wti"
}

Response Example

{
  "name": "WTI原油",
  "nowPrice": 77.12,
  "todayOpenPrice": 76.58,
  "yestodayClosePrice": 76.41,
  "todayMax": 77.56,
  "todayMin": 75.98,
  "diffNum": 0.71,
  "diffRate": 0.93,
  "time": "2026-07-30 14:00:00"
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	wti

Response Fields