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

更改履约日期

POST
/v2/fx/trade/extend/forward/contract
支持全额更改履约日期和部分更改履约日期:
当sell_amount等于原合约卖出金额时为全额更改履约日期,会根据c_order_id和new_value_date重新生成一份新的合约(成交价会变化);
当sell_amount小于原合约卖出金额时为部分更改履约日期,会根据c_order_id和new_value_date生成一份新的合约(成交价会变化),剩余的卖出金额创建新的合约绑定到origin_c_order_id上(成交价不变)。
注:合约卖出金额大于等于200才能发起部分更改履约日期。否则只能全额更改履约日期。

请求参数

Header 参数

Body 参数application/json

示例
{
    "new_value_date": "2023-08-09",
    "target_c_order_id": "202308091541FW00002",
    "c_order_id": "202308091541FW00003"
}

请求示例代码

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/extend/forward/contract' \
--header 'access_token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "new_value_date": "2023-08-09",
    "target_c_order_id": "202308091541FW00002",
    "c_order_id": "202308091541FW00003"
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 0,
    "data": {
        "base_currency": "USD",
        "base_currency2": "CNH",
        "buy_amount": 7.09,
        "buy_currency": "CNH",
        "value_date": "2023-07-27",
        "price": 7.09178,
        "price2": 0.141008,
        "sell_amount": 1,
        "sell_currency": "USD",
        "transaction_id": "230714FW383893963"
    },
    "message": "ok"
}
修改于 2023-08-09 09:42:50
上一页
取消挂单
下一页
撤销
Built with