福鑫-OpenAPI v2
  1. 创建换汇
福鑫-OpenAPI v2
  • 福鑫OpenApi v2版本介绍
  • 接入说明
    • 【公共模块】接入说明
    • 【实时换汇】接入说明
    • 【挂单换汇】接入说明
    • 【预约换汇】接入说明
    • 【webhook回调】接入说明
  • 接口文档
    • 登录
      • 获取token
    • 获取可履约日历
      • 预约换汇日历
      • 合约变更日历
    • 获取参考报价
      • 获取报价
      • 获取报价(bid\offer pingpong视角)
      • 获取合约变更报价
    • 创建换汇
      • 创建换汇合约
        POST
      • 创建挂单换汇订单
        POST
    • 查询合约
      • 分页查询换汇记录
      • 根据幂等单号查询换汇记录
      • 分页查询挂单记录
    • 修改合约
      • 取消挂单
      • 更改履约日期
      • 撤销
    • 履约
      • 手动发起履约
    • 账户
      • 账户余额查询
      • 实时换汇额度查询
      • 预约换汇额度查询
      • 查询银行卡接口
      • 账户出金
      • 出入金记录查询
    • 回调通知
      • 合约变更事件回调
      • 合约展期事件回调
  1. 创建换汇

创建挂单换汇订单

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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"
}
上一页
创建换汇合约
下一页
分页查询换汇记录
Built with