匯率查詢

此端點提供查詢指定時間範圍内的每日匯率。

---

HTTP 请求

GET /market/v1/exchange-rates?base_currency={base_currency}&target_currency={target_currency}

---

查詢參數

名稱	類型	是否必填	描述
base_currency	string	是	原始幣種，如 USDT
target_currency	string	是	目標幣種，如 USD
page	int	否	當前頁，默認 1
page_size	int	否	每頁行數，默認 20，最大 100
start_date	string	否	開始時間，若未傳入則預設為當天匯率
end_date	string	否	結束時間，若未傳入則預設為當天匯率

---

cURL 範例

curl --location --request GET '{$base_url}/market/v1/exchange-rates?base_currency=USDT&target_currency=USD&start_date=2025-06-20&end_date=2025-06-31' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142003'

---

成功回應格式

请求响应的数据字段描述。

名稱	類型	描述
base_currency	string	原始幣種
target_currency	string	目標幣種
rate	decimal	汇率
update_time	string	更新时间，UTC 時間

---

成功回應範例

{
  "code": 0,
  "data": {
    "total_records": 1,
    "page": 1,
    "page_size": 20,
    "exchange_rates": [
      {
        "base_currency": "USDT",
        "target_currency": "USD",
        "rate": 0.995592025,
        "update_time": "2025-06-26T01:41:32.1490152Z"
      }
    ]
  }
}

---

錯誤回應範例

{
  "code": 500,
  "message": "Internal Service Error",
  "details": ""
}