创建挂单换汇订单

POST

/v2/fx/trade/create/limit/order

买卖金额精确度说明：JPY只支持到整数，其他币种支持小数点后2位。

请求参数

Header 参数

access_token

string

token

必需

Body 参数application/json

buy_currency

string

买入币种

必需

sell_currency

string

卖出币种

必需

buy_amount

number

必需

买入金额(最多两位小数，买入卖出金额只需传一个)

sell_amount

number

必需

卖出金额(最多两位小数，买入卖出金额只需传一个)

ref_price

number

挂单参考价

必需

base_currency

string

必需

报价基础货币(与ref_price配对使用)

pay_way

string

必需

支付方式(balance:余额，credit:额度)

c_order_id

string

幂等订单id

必需

>= 8 字符<= 64 字符

valid_date

string

必需

有效日期(UTC/GMT+08:00，yyyy-MM-dd)

示例

{
  "sell_currency": "CNH",
  "buy_currency": "USD",
  "base_currency": "USD",
  "sell_amount": 3.22,
  "ref_price": 8.81223,
  "pay_way": "credit",
  "c_order_id": "202308091142500000LI00006",
  "valid_date": "2023-09-01"
}

示例代码

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/limit/order' \
--header 'access_token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sell_currency": "CNH",
    "buy_currency": "USD",
    "base_currency": "USD",
    "sell_amount": 3.22,
    "ref_price": 8.81223,
    "pay_way": "credit",
    "c_order_id": "202308091142500000LI00006",
    "valid_date": "2023-09-01"
}'

返回响应

🟢200成功

application/json

Body

code

integer

请求结果

必需

message

string

请求信息

必需

data

object

返回结果

可选

order_id

string

订单id

必需

buy_currency

string

买入币种

必需

buy_amount

number

买入金额

可选

sell_currency

string

卖出币种

必需

sell_amount

number

卖出金额

可选

c_order_id

string

幂等订单id

必需

price

number

成交价

可选

base_currency

string

基础货币

可选

price2

number

成交价2

可选

base_currency2

string

基础货币2

可选

status

string

必需

状态(accept:"生效中",cancel:"已取消",reject:"已拒绝")

status_desc

string

状态描述

必需

示例

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

{
  "code": 0,
  "data": {
    "buy_currency": "USD",
    "sell_currency": "CNH",
    "status_desc": "生效中",
    "c_order_id": "202308091142500000LI00002",
    "buy_amount": 1.23,
    "order_id": "230809LE012135967",
    "status": "accept"
  },
  "message": "ok"
}

修改于 2023-08-09 09:39:36

创建换汇合约

分页查询换汇记录