POST已開放exchange-rate-convert

匯率查詢+匯率轉換

提供匯率查詢與轉換API服務，便於開發者快速查詢匯率相關資訊並整合至業務系統。

接入文件

匯率查詢+匯率轉換介面說明

匯率查詢+匯率轉換API用於協助開發者在系統中快速完成匯率查詢與轉換相關處理，返回結構化結果，適合金融業務接入、對帳處理、自動化系統整合等場景。

適用場景

支援將匯率查詢與轉換能力接入內部系統、SaaS 平台、自動化工作流程或營運後台。
適合需要穩定呼叫、標準化返回和可編排介面能力的業務場景。
建議結合請求頻率控制、失敗重試和結果快取策略，提升整體接入穩定性。

接入建議

接入前請確認請求參數格式、驗證方式和錯誤碼處理邏輯。
對於高頻查詢場景，建議做好日誌追蹤、逾時控制和冪等處理。
若結果用於風控或自動決策，建議結合業務規則進行二次判斷，而非直接單點依賴介面返回。

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

請求示例

{
  "fromCurrency": "USD",
  "toCurrency": "CNY",
  "amount": 100
}

響應示例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "rate": 7.15,
    "convertedAmount": 715,
    "updatedAt": "2024-01-01 10:00:00"
  }
}

請求欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
fromCurrency	string	USD
toCurrency	string	CNY
amount	number	100

響應欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
code	string	SUCCESS
message	string	success
data	object	{...}
data.rate	number	7.15
data.convertedAmount	number	715
data.updatedAt	string	2024-01-01 10:00:00

curl --request POST \ --url 'https://openapi.toolkk.com/v1/exchange-rate-convert' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "fromCurrency": "USD",\n "toCurrency": "CNY",\n "amount": 100\n}'

import os import requests url = "https://openapi.toolkk.com/v1/exchange-rate-convert" payload = { "fromCurrency": "USD", "toCurrency": "CNY", "amount": 100 } 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/exchange-rate-convert" payload := []byte("{\n \"fromCurrency\": \"USD\",\n \"toCurrency\": \"CNY\",\n \"amount\": 100\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 \"fromCurrency\": \"USD\",\n \"toCurrency\": \"CNY\",\n \"amount\": 100\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/exchange-rate-convert")) .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/exchange-rate-convert'; $payload = "{\n \"fromCurrency\": \"USD\",\n \"toCurrency\": \"CNY\",\n \"amount\": 100\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;

匯率查詢+匯率轉換

接入文件