POSTPublicprecious-metal-inter-price

Global Precious Metals Quotes

Documentation

API Introduction

This API provides real-time market quotes for major international precious metal varieties (e.g., London Gold, Spot Silver). By passing a specific variety code (symbol), you can obtain complete market data including current price, bid/ask spread, rise/fall percentage, trading volume, and open interest, suitable for applications requiring integration of global precious metal market data.

Use Cases

Financial News Applications: Display real-time gold and silver price trends in apps or on websites.
Investment Analysis Tools: Provide basic price and volume data support for quantitative trading or technical analysis.
Enterprise Risk Management Systems: Monitor fluctuations in precious metal raw material costs, assisting procurement decisions.

Request and Response Details

Request Method: POST
Core Parameters: symbol (Required), specifies the international precious metal variety code to query.
Response Data:
data.price: Current latest transaction price.
data.bid / data.ask: Bid 1 price and Ask 1 price.
data.change / data.changeRate: Absolute and percentage change.
data.volume / data.hold: Trading volume and open interest.
data.update_time: Data update timestamp.

Integration Recommendations

Variety Code Confirmation: Ensure that the passed symbol matches the spot or futures variety codes supported by the upstream, otherwise data may not be retrievable.
Caching Strategy: Given the high-frequency changes in market data, it is recommended that the frontend sets a reasonable refresh frequency based on business needs to avoid invalid high-frequency requests.
Error Handling: Please validate the returned code field. For non-200 status codes, refer to the msg information for error prompts.

Integration Examples

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

Request Example

{
  "symbol": "国际贵金属品种，详见国际贵金属现货，详见国际贵金属期货"
}

Response Example

{
  "code": 200,
  "msg": "成功",
  "taskNo": "795463438161562841240471",
  "data": {
    "presettle": 614.51,
    "ask_vol": 3,
    "change": 3.71,
    "bid_vol": 1,
    "hold": 236472,
    "volume": 13396,
    "update_time": 1731090599,
    "high": 619.7,
    "low": 614.2,
    "price": 618.22,
    "name": "伦敦金（现货黄金）",
    "ask": 618.68,
    "preclose": 612.87,
    "bid": 616.02,
    "changeRate": 0.6,
    "value": 8273493248,
    "open": 614.3
  }
}

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.code	object	{...}
properties.code.type	string	number
properties.code.example	number	200
properties.code.description	string	返回码对应描述
properties.msg	object	{...}

curl --request POST \ --url 'https://openapi.toolkk.com/v1/precious-metal-inter-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/precious-metal-inter-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/precious-metal-inter-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/precious-metal-inter-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/precious-metal-inter-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 Precious Metals Quotes

Documentation

API Introduction

Use Cases

Request and Response Details

Integration Recommendations

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online