历史汇率查询 API：获取指定时间段外汇数据

請求示例

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "货币编号，货币编号或货币名称必须输入其中一个"
    },
    "name": {
      "type": "string",
      "description": "货币名称，货币编号或货币名称必须输入其中一个"
    },
    "month": {
      "type": "string",
      "description": "查询年月（yyyyMM），month和startDate、endDate不能同时为空"
    },
    "startDate": {
      "type": "string",
      "description": "查询起始时间yyyyMMdd，month和startDate、endDate不能同时为空"
    },
    "endDate": {
      "type": "string",
      "description": "查询结束时间yyyyMMdd，month和startDate、endDate不能同时为空"
    }
  }
}

響應示例

{
  "type": "object",
  "properties": {
    "msg": {
      "type": "string",
      "example": "成功",
      "description": "code对应的描述"
    },
    "code": {
      "type": "number",
      "example": 200,
      "description": "返回码，详见code返回码说明"
    },
    "taskNo": {
      "type": "string",
      "example": "687882815162227863699691",
      "description": "本次唯一请求号"
    },
    "data": {
      "type": "object",
      "properties": {
        "currencyCode": {
          "type": "string",
          "example": "USD",
          "description": "货币编号"
        },
        "currencyName": {
          "type": "string",
          "example": "美元",
          "description": "货币名称"
        },
        "startDate": {
          "type": "string",
          "example": "20191001",
          "description": "开始日期"
        },
        "endDate": {
          "type": "string",
          "example": "20191101",
          "description": "结束日期"
        },
        "month": {
          "type": "string",
          "example": "201910",
          "description": "结束日期"
        },
        "list": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "middle_rate": {
                "type": "string",
                "example": "705.33",
                "description": "中行折算价"
              },
              "selling_rate": {
                "type": "string",
                "example": "705.55",
                "description": "现汇卖出价"
              },
              "cash_buying_rate": {
                "type": "string",
                "example": "696.86",
                "description": "现钞买入价"
              },
              "buying_rate": {
                "type": "string",
                "example": "702.58",
                "description": "现汇买入价"
              },
              "cash_selling_rate": {
                "type": "string",
                "example": "705.55",
                "description": "现钞卖出价"
              },
              "publish_time": {
                "type": "string",
                "example": "2019-10-31",
                "description": "发布日期"
              }
            }
          },
          "example": [
            {
              "middle_rate": "705.33",
              "selling_rate": "705.55",
              "cash_buying_rate": "696.86",
              "buying_rate": "702.58",
              "cash_selling_rate": "705.55",
              "publish_time": "2019-10-31"
            },
            {
              "middle_rate": "705.82",
              "selling_rate": "707.26",
              "cash_buying_rate": "698.54",
              "buying_rate": "704.27",
              "cash_selling_rate": "707.26",
              "publish_time": "2019-10-30"
            }
          ]
        }
      }
    }
  }
}

請求欄位

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

欄位路徑	型別	示例值
type	string	object
properties	object	{...}
properties.code	object	{...}
properties.code.type	string	string
properties.code.description	string	货币编号，货币编号或货币名称必须输入其中一个
properties.name	object	{...}
properties.name.type	string	string

響應欄位

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

欄位路徑	型別	示例值
type	string	object
properties	object	{...}
properties.msg	object	{...}
properties.msg.type	string	string
properties.msg.example	string	成功
properties.msg.description	string	code对应的描述
properties.code	object	{...}

Shell 示例

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/aliyunmarket-cmapi00064402-exchange-rate-history' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "type": "object",\n  "properties": {\n    "code": {\n      "type": "string",\n      "description": "货币编号，货币编号或货币名称必须输入其中一个"\n    },\n    "name": {\n      "type": "string",\n      "description": "货币名称，货币编号或货币名称必须输入其中一个"\n    },\n    "month": {\n      "type": "string",\n      "description": "查询年月（yyyyMM），month和startDate、endDate不能同时为空"\n    },\n    "startDate": {\n      "type": "string",\n      "description": "查询起始时间yyyyMMdd，month和startDate、endDate不能同时为空"\n    },\n    "endDate": {\n      "type": "string",\n      "description": "查询结束时间yyyyMMdd，month和startDate、endDate不能同时为空"\n    }\n  }\n}'

Python 示例

import os
import requests

url = "https://openapi.toolkk.com/v1/aliyunmarket-cmapi00064402-exchange-rate-history"
payload = {
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "货币编号，货币编号或货币名称必须输入其中一个"
    },
    "name": {
      "type": "string",
      "description": "货币名称，货币编号或货币名称必须输入其中一个"
    },
    "month": {
      "type": "string",
      "description": "查询年月（yyyyMM），month和startDate、endDate不能同时为空"
    },
    "startDate": {
      "type": "string",
      "description": "查询起始时间yyyyMMdd，month和startDate、endDate不能同时为空"
    },
    "endDate": {
      "type": "string",
      "description": "查询结束时间yyyyMMdd，month和startDate、endDate不能同时为空"
    }
  }
}

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/aliyunmarket-cmapi00064402-exchange-rate-history"
    payload := []byte("{\n  \"type\": \"object\",\n  \"properties\": {\n    \"code\": {\n      \"type\": \"string\",\n      \"description\": \"货币编号，货币编号或货币名称必须输入其中一个\"\n    },\n    \"name\": {\n      \"type\": \"string\",\n      \"description\": \"货币名称，货币编号或货币名称必须输入其中一个\"\n    },\n    \"month\": {\n      \"type\": \"string\",\n      \"description\": \"查询年月（yyyyMM），month和startDate、endDate不能同时为空\"\n    },\n    \"startDate\": {\n      \"type\": \"string\",\n      \"description\": \"查询起始时间yyyyMMdd，month和startDate、endDate不能同时为空\"\n    },\n    \"endDate\": {\n      \"type\": \"string\",\n      \"description\": \"查询结束时间yyyyMMdd，month和startDate、endDate不能同时为空\"\n    }\n  }\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  \"type\": \"object\",\n  \"properties\": {\n    \"code\": {\n      \"type\": \"string\",\n      \"description\": \"货币编号，货币编号或货币名称必须输入其中一个\"\n    },\n    \"name\": {\n      \"type\": \"string\",\n      \"description\": \"货币名称，货币编号或货币名称必须输入其中一个\"\n    },\n    \"month\": {\n      \"type\": \"string\",\n      \"description\": \"查询年月（yyyyMM），month和startDate、endDate不能同时为空\"\n    },\n    \"startDate\": {\n      \"type\": \"string\",\n      \"description\": \"查询起始时间yyyyMMdd，month和startDate、endDate不能同时为空\"\n    },\n    \"endDate\": {\n      \"type\": \"string\",\n      \"description\": \"查询结束时间yyyyMMdd，month和startDate、endDate不能同时为空\"\n    }\n  }\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/aliyunmarket-cmapi00064402-exchange-rate-history"))
            .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/aliyunmarket-cmapi00064402-exchange-rate-history';
$payload = "{\n  \"type\": \"object\",\n  \"properties\": {\n    \"code\": {\n      \"type\": \"string\",\n      \"description\": \"货币编号，货币编号或货币名称必须输入其中一个\"\n    },\n    \"name\": {\n      \"type\": \"string\",\n      \"description\": \"货币名称，货币编号或货币名称必须输入其中一个\"\n    },\n    \"month\": {\n      \"type\": \"string\",\n      \"description\": \"查询年月（yyyyMM），month和startDate、endDate不能同时为空\"\n    },\n    \"startDate\": {\n      \"type\": \"string\",\n      \"description\": \"查询起始时间yyyyMMdd，month和startDate、endDate不能同时为空\"\n    },\n    \"endDate\": {\n      \"type\": \"string\",\n      \"description\": \"查询结束时间yyyyMMdd，month和startDate、endDate不能同时为空\"\n    }\n  }\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;

历史汇率查询 API：获取指定时间段外汇数据 - 工具匠

历史汇率查询

接入文件

接口简介

适用场景

请求与返回说明

接入建议

接入示例程式碼

請求示例

響應示例

請求欄位

響應欄位

Shell 示例

Python 示例

Go 示例

Java 示例

PHP 示例