创建换汇合约

POST

/v2/fx/trade/create/contract

1，参数【slip】说明：【ref_price】为6.7，用户容忍的【slip】为 0.01。表示用户可以接受成交的价格是6.7上下浮动0.01%，也就是如果当前价格在[6.69933 - 6.70067] 之间可以成交（不传【ref_price】会以市价直接成交，不再校验滑点）；
2，买卖金额精确度说明：JPY只支持到整数，其他币种支持小数点后2位。

请求参数

Header 参数

Body 参数application/json

示例

{
    "sell_currency": "USD",
    "buy_currency": "CNH",
    "base_currency": "USD",
    "sell_amount": 100.00,
    "ref_price": 7.19113,
    "pay_way": "balance",
    "c_order_id": "202308091621FW00008",
    "value_date": "2023-08-10",
    "conversion_type": "lock"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sandbox-gateway.pingpongx.com/v2/fx/trade/create/contract' \
--header 'access_token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sell_currency": "USD",
    "buy_currency": "CNH",
    "base_currency": "USD",
    "sell_amount": 100.00,
    "ref_price": 7.19113,
    "pay_way": "balance",
    "c_order_id": "202308091621FW00008",
    "value_date": "2023-08-10",
    "conversion_type": "lock"
}'

返回响应

🟢200成功

application/json

Body

示例

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

{
    "code": 0,
    "data": {
        "base_currency": "USD",
        "base_currency2": "CNH",
        "buy_currency": "CNH",
        "sell_currency": "USD",
        "status_desc": "待履约",
        "c_order_id": "202308091541FW00002",
        "price": 7.18825,
        "sell_amount": 500,
        "buy_amount": 3594.13,
        "price2": 0.139116,
        "status": "waitSettle"
    },
    "message": "ok"
}

修改于 2024-02-26 05:28:13

获取合约变更报价

创建挂单换汇订单