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

合约变更事件回调

POST
事件类型:
positionCreate,合约创建事件
positionCancel,合约撤销事件
positionSettle,合约履约事件

请求参数

Body 参数application/json

示例
{
    "event_type": "positionExtend",
    "msg_id": "P24010816531715000058",
    "payload": {
        "base_currency": "CNH",
        "base_currency2": "MXN",
        "buy_amount": 3645.95,
        "buy_currency": "CNH",
        "open_time": 1704440609000,
        "pay_way": "balance",
        "position_id": "240105SP051608727",
        "price": 2.37729,
        "price2": 0.420647,
        "sell_amount": 8667.49,
        "sell_currency": "MXN",
        "source_type": "spot",
        "status": "settle",
        "status_desc": "已履约",
        "trade_channel": "api",
        "value_date": "2024-01-05"
    }
}

请求示例代码

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' \
--header 'Content-Type: application/json' \
--data-raw '{
    "event_type": "positionExtend",
    "msg_id": "P24010816531715000058",
    "payload": {
        "base_currency": "CNH",
        "base_currency2": "MXN",
        "buy_amount": 3645.95,
        "buy_currency": "CNH",
        "open_time": 1704440609000,
        "pay_way": "balance",
        "position_id": "240105SP051608727",
        "price": 2.37729,
        "price2": 0.420647,
        "sell_amount": 8667.49,
        "sell_currency": "MXN",
        "source_type": "spot",
        "status": "settle",
        "status_desc": "已履约",
        "trade_channel": "api",
        "value_date": "2024-01-05"
    }
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "event_type": "positionExtend",
    "msg_id": "P24010816531715000058",
    "payload": {
        "base_currency": "CNH",
        "base_currency2": "MXN",
        "buy_amount": 3645.95,
        "buy_currency": "CNH",
        "open_time": 1704440609000,
        "pay_way": "balance",
        "position_id": "240105SP051608727",
        "price": 2.37729,
        "price2": 0.420647,
        "sell_amount": 8667.49,
        "sell_currency": "MXN",
        "source_type": "spot",
        "status": "settle",
        "status_desc": "已履约",
        "trade_channel": "api",
        "value_date": "2024-01-05"
    }
}
修改于 2024-03-20 02:11:38
上一页
出入金记录查询
下一页
合约展期事件回调
Built with