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;

汇率查询+汇率转换

接入文档