查看外匯匯率

外匯 (FX) 匯率是一種貨幣兌換成另一種貨幣的比率。例如，114 日圓兌 1 美元匯率意味著可以用 1 美元購買 114 日圓，或者可以用 114 日圓購買 1 美元。

扼要概述

Currencycloud 的 API 提供了兩個用於查看外匯匯率的端點：

1. 獲取基準匯率：透過單次請求獲取一個或多個貨幣對的指示性外匯匯率資訊。
2. 獲取詳細匯率：獲取將資金從一種貨幣兌換為另一種貨幣的詳細、可交易的匯率報價。報價基於認證用戶的點差表。還可以選擇提供兌換的具體日期。

集成指南

第 1 步：登入

請參閱身份驗證指南，以獲取有關啟動新 API 會話的說明。

第 2 步：獲取基準匯率資訊

Currencycloud 的獲取基準匯率 /v2/rates/find 端點提供實時匯率資料。

報價以貨幣對形式提供。貨幣對是兩個標準貨幣代碼結合在一起：「EURUSD」、「GBPUSD」、「GBPJPY」等。貨幣對中的第一種貨幣為基準貨幣，第二種貨幣為報價貨幣。結果表示購買一單位基準貨幣需要多少報價貨幣。

請求示例：

GET /v2/rates/find?currency_pair=EURGBP
X-Auth-Token: ea6d13c7bc50feb46cf978d137bc01a2
    

回應示例：

HTTP/1.1 200 OK
Content-Type: application/json

{
  "rates": {
    "EURGBP": [
      "0.805300",
      "0.805900"
    ]
  },
  "unavailable": []
}
    

• 回應中的兩種匯率分別是「買入」價和「賣出」價。
• 買入價：適用於您賣出基準貨幣的情況。
• 賣出價：適用於您買入基準貨幣的情況。

使用示例：

• 賣出 1,000.00 歐元可以買入 805.30 英鎊。
• 買入 1,000.00 歐元需要賣出 805.90 英鎊。

當您從獲取基準匯率端點獲取匯率資訊時，傳回的貨幣對字串將與輸入的 currency_pair 參數值匹配。

第 3 步：獲取詳細報價

要獲取從一種貨幣兌換為另一種貨幣交易資金的精確報價，請使用 Currencycloud 的獲取詳細匯率 /v2/rates/detailed 端點。

請求示例：

GET /v2/rates/detailed
X-Auth-Token: ea6d13c7bc50feb46cf978d137bc01a2
    

查詢參數：

回應示例：

HTTP/1.1 200 OK
Content-Type: application/json

{
  "settlement_cut_off_time":"2021-06-05T13:00:00Z",
  "currency_pair":"EURGBP",
  "client_buy_currency":"EUR",
  "client_sell_currency":"GBP",
  "client_buy_amount":"10000.00",
  "client_sell_amount":"8059.00",
  "fixed_side": "buy",
  "client_rate":"0.8059",
  "partner_rate": null,
  "core_rate":"0.8059",
  "deposit_required": false,
  "deposit_amount":"0.0",
  "deposit_currency":"GBP",
  "mid_market_rate":"0.8056"
}
    

註釋：

• 回應中的 currency_pair 屬性依市場慣例進行標準化。
• 歐元兌英鎊的貨幣對始終表示為「EURGBP」，而非「GBPEUR」。

按照慣例，歐元兌英鎊的貨幣對表示為「EURGBP」，無論您是買入還是賣出哪種貨幣。預設情況下，價值較低的貨幣是貨幣對中的第二個單位。但也有一些例外情況。如果以下任何一種貨幣相互報價，則列表中最先出現的貨幣將作為貨幣對中的第一個單位：

• EUR
• GBP
• AUD
• NZD
• USD