此汇率查询接口是按照固定币种对方向返回汇率,币种对方向一致时返回卖出价,币种对方向相反则返回买入价。
示例:如币种对 USD/CNH
- 卖出USD->买入CNH,则返回7.231900,表示:卖出1 USD可以换7.231900 CNH
- 卖出CNH->买入USD,则返回7.260700,表示:买入1 USD需要7.260700 CNH
请求URL
POST {域名}/api/agent/rate/query-rate
请求参数
👉说明:
- 请求参数详见:请求报文
加密数据dataContent
序号 | 域名 | 变量名 | 必填 | 长度 | 备注 |
---|---|---|---|---|---|
01. | 买入币种 | originalCcy | M | String(3) | 买入币种 |
02. | 卖出币种 | targetCcy | M | String(3) | 卖出币种 |
03. | 业务类型 | bizType | M | Number | 业务类型暂支持取值: 6:B2B结汇付款汇率, 7:B2B国际分发汇率 8:B2B兑换汇率 |
04. | 交割期限 | closingType | O | String | 交割期限: TOD:当日 TOM:T+1日 SPOT:T+2日 |
dataContent示例
{
"bizType":"6",
"closingType":"TOD",
"originalCcy":"CNH",
"targetCcy":"USD"
}
响应参数
👉说明:
- 响应参数详见:响应报文
结果信息result
序号 | 域名 | 变量名 | 必填 | 长度 | 备注 |
---|---|---|---|---|---|
01. | 用户号 | userNo | M | String(19) | 商户的账户币种 |
02. | 买入币种 | originalCcy | M | String(3) | 买入币种 |
03. | 卖出币种 | targetCcy | M | String(3) | 卖出币种 |
04. | 交割日期 | closingDate | M | String(10) | 时间时间为:YYYY-MM-DD |
05. | 交割类型 | closingType | M | 交割期限: TOD:当日 TOM:T+1日 SPOT:T+2日 |
|
06. | 汇率 | exchangeRate | M | Number(19,6) | 汇率 |
result示例
{
"closingDate": "2024-09-23",
"closingType": "TOD",
"exchangeRate": 7.037200,
"originalCcy": "CNH",
"targetCcy": "USD",
"userNo": 5181240322000274308
}