查询当前汇率 - 珊瑚跨境开放平台

请求参数

Query 参数

buyCurrency

string

买入货币

必需

示例值:

USD

sellCurrency

string

卖出货币

必需

示例值:

CNY

buyAmount

string

可选

客户以 buyCurrency 购买的金额（如果指定 sellAmount 则必须为空）

示例值:

1

sellAmount

string

可选

客户以 sellCurrency 出售的金额（如果指定 buyAmount 则必须为空）

Header 参数

X-Request-Id

string

请求标识

必需

默认值:

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://gateway-openapi.coralglobal.cn/v1/fx/rate/current?buyCurrency=USD&sellCurrency=CNY&buyAmount=1&sellAmount' \
--header 'X-Request-Id;'

返回响应

🟢200成功

application/json

Body

cn.coralglobal.partner.api.common.Result<cn.coralglobal.partner.api.model.dto.v2.CurrentRateDTO>

code

integer | null

必需

返回code 200:操作成功、400:参数错误、401:未授权、403:禁止访问、404:资源未找到、500:服务器内部异常

msg

string | null

返回消息提示

必需

data

object

返回数据

可选

buyCurrency

string | null

买入货币

可选

sellCurrency

string | null

卖出货币

可选

currencyPair

string | null

货币对

可选

exchangeRate

number

汇率

必需

buyAmount

number | null

买入金额

可选

sellAmount

number | null

卖出金额

可选

validFromAt

string | null

有效期开始已经

可选

validToAt

string | null

有效期结束时间

可选

validity

string | null

有效时间5分钟

可选

示例

{
  "code": 44,
  "msg": "reprehenderit fugiat ut commodo ea",
  "data": {
    "buyCurrency": "{{$finance.currencyCode}}",
    "sellCurrency": "{{$finance.currencyCode}}",
    "currencyPair": "{{$finance.currencyCode}}",
    "exchangeRate": 96,
    "buyAmount": 57,
    "sellAmount": 8,
    "validFromAt": "1995-05-17 19:29:44",
    "validToAt": "2023-08-03 12:48:35",
    "validity": "40"
  }
}