获取报价

GET

/v2/fx/trade/market/price

1，获取报价以用户卖出1个单位sell_currency，所需多少buy_currency为标准报价。
例如：
sell_currency USD，buy_currency CNH 返回ref_price = 7.1，即用户卖出1单位USD可获得7.1CNH；
sell_currency CNH，buy_currency USD 返回ref_price = 0.139，即用户卖出1单位CNH可获得0.139USD。
2，【value_date】不传默认返回当日履约的报价。

请求参数

Query 参数

buy_currency

string

买入货币

必需

示例值:

CNH

sell_currency

string

卖出货币

必需

示例值:

USD

value_date

string

可选

履约日期(实时不传预约必传，yyyy-MM-dd)

示例值:

2023-05-16

Header 参数

access_token

string

token

必需

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://sandbox-gateway.pingpongx.com/v2/fx/trade/market/price?buy_currency=CNH&sell_currency=USD&value_date=2023-05-16' \
--header 'access_token;'

返回响应

🟢200成功

application/json

Body

code

integer

请求结果

必需

message

string

请求信息

必需

data

object

返回结果

可选

buy_currency

string

买入货币

必需

sell_currency

string

卖出货币

必需

value_date

string

可选

履约日期(yyyy-MM-dd)

ref_price

number

参考报价

必需

base_currency

string

必需

报价基础货币(卖出方向的货币)

ref_price2

number

参考报价2

必需

base_currency2

string

必需

报价基础货币2(买入方向的货币)

示例

成功示例参数缺失异常示例

{
  "code": 0,
  "data": {
    "base_currency": "USD",
    "base_currency2": "CNH",
    "buy_currency": "CNH",
    "sell_currency": "USD",
    "ref_price2": 0.139046,
    "ref_price": 7.19185
  },
  "message": "ok"
}

修改于 2025-01-16 08:18:35

合约变更日历

获取报价(bid\offer pingpong视角)