更改履约日期 - 福鑫-OpenAPI v2

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

请求参数

Header 参数

access_token

string

token

必需

Body 参数application/json

position_id

string

必需

合约id(平台优先使用合约id，原幂等订单id或合约id必传一个)

target_c_order_id

string

必需

原幂等订单id(原幂等订单id或合约id必传一个)

new_value_date

string

必需

新履约日(yyyy-MM-dd)

sell_amount

number

可选

期望更改履约日期的卖出金额(默认全额)

c_order_id

string

新幂等订单id

必需

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

请求结果

必需

message

string

请求信息

必需

data

object

返回结果

可选

value_date

string

必需

新履约日(yyyy-MM-dd)

buy_currency

string

买入币种

必需

sell_currency

string

卖出币种

必需

buy_amount

number

买入金额

必需

sell_amount

number

卖出金额

必需

price

number

成交价

必需

base_currency

string

基础货币

必需

price2

number

成交价2

必需

base_currency2

string

基础货币2

必需

示例

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

{
    "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"
}