外汇汇率换算 · REST 接口

实时汇率换算。在任意两种支持的货币之间进行实时换算，给出最新买卖报价并按当前市场汇率计算折算金额，支持双向换算，例如 USD 换 CAD 或 CAD 换 USD。

GET /v1/conversion/{from}/{to}

上游时效说明

实时

上游历史范围

不适用

适用场景

跨境支付、货币对冲、差旅费用规划、动态定价。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`from`	string	Yes	货币对的「from」端代码。
`to`	string	Yes	货币对的「to」端代码。
`amount`	number	No	要转换的金额，可含小数。
`precision`	integer	No	转换结果的小数精度。默认 2，即精确到小数点后 2 位。

响应字段

字段	类型	说明
`converted`	number	转换结果。
`from`	string	源货币的符号。
`initialAmount`	number	要转换的金额。
`last`	object	包含指定外汇货币对所请求的报价数据。
`last.ask`	number	卖价（ask）。
`last.bid`	number	买价（bid）。
`last.exchange`	integer	交易所 ID，映射关系可查阅「交易所名录」。
`last.timestamp`	integer	Unix 毫秒时间戳。
`request_id`	string	服务器分配的请求 ID。
`status`	string	本次请求响应的状态。
`symbol`	string	本次请求实际评估的货币对。
`to`	string	目标货币的符号。

响应示例

{
  "converted": 73.14,
  "from": "AUD",
  "initialAmount": 100,
  "last": {
    "ask": 1.3673344,
    "bid": 1.3672596,
    "exchange": 48,
    "timestamp": 1605555313000
  },
  "request_id": "a73a29dbcab4613eeaf48583d3baacf0",
  "status": "success",
  "symbol": "AUD/USD",
  "to": "USD"
}

原文：Massive 文档 ↗

外汇 汇率换算 · REST 接口

适用场景

查询参数

响应字段

响应示例

外汇汇率换算 · REST 接口