查看外汇汇率

外汇 (FX) 汇率是将一种货币兑换成另一种货币的比率。例如，日元兑美元的汇率为 114，意味着 1 美元可以购买 114 日元，或者 114 日元可以购买 1 美元。

简要说明

Currencycloud 的 API 提供了两个端点来查看外汇汇率：

1. Get Basic Rates: 在单个请求中提供一个或多个货币对的指示性外汇汇率信息。
2. Get Detailed Rates: 提供详细的、可交易的汇率报价，用于将资金从一种货币兑换为另一种货币。该报价汇率基于已验证用户的点差表。您还可以选择提供一个特定日期以进行货币兑换。

集成指南

第 1 步：登录

请参阅验证指南，获取开始新 API 会话的说明。

第 2 步：获取基本汇率信息

Currencycloud 的 Get Basic Rates /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": []
}
    

• 响应中的两个汇率分别是“买入价”和“卖出价”。
• 买入价：当您出售基础货币时适用。
• 卖出价：当您购买基础货币时适用。

示例使用：

• 出售 EUR €1,000.00 可购买 GBP £805.30。
• 而要购买 EUR €1,000.00，则需要出售 GBP £805.90。

当您从 Get Basic Rates 端点获取汇率信息时，返回的货币对字符串将与 currency_pair 输入参数的值相匹配。

第 3 步：获取详细报价

要获取从一种货币兑换到另一种货币的精确报价，可使用 Currencycloud 的 Get Detailed Rates /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