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

创建换汇合约

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 参数
access_token
string 
token
必需
Body 参数application/json
conversion_type
enum<string> 
必需
换汇类型(spot:"实时换汇",lock:"预约换汇")
枚举值:
spotlock
buy_currency
string 
买入币种
必需
sell_currency
string 
卖出币种
必需
buy_amount
number 
必需
买入金额(最多两位小数,买入卖出金额只需传一个)
sell_amount
number 
必需
卖出金额(最多两位小数,买入卖出金额只需传一个)
slip
number 
可选
滑点(小数,默认:0.01,单位:%)
ref_price
number 
可选
参考价(获取报价返回的ref_price/ref_price2/bid/offer)
base_currency
string 
可选
报价基础货币(与ref_price配对使用)
pay_way
string 
必需
支付方式(balance:余额,credit:额度)
c_order_id
string 
幂等订单id
必需
>= 8 字符<= 64 字符
value_date
string 
可选
履约日(实时不传预约必传,yyyy-MM-dd)
示例
{
    "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
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/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
integer 
请求结果
必需
message
string 
请求信息
必需
data
object 
返回结果
可选
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 
必需
状态:reject("已拒绝") , waitSettle("待履约")
status_desc
string 
状态描述
必需
示例
{
    "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"
}
上一页
获取合约变更报价
下一页
创建挂单换汇订单
Built with