合约变更事件回调

POST

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

请求参数

Body 参数application/json

event_type

enum<string>

事件类型

必需

枚举值:

positionCreatepositionCancelpositionSettle

msg_id

string

消息id

必需

payload

object (合约变更事件回调VO)

可选

position_id

string

合约id

必需

parent_position_id

string

父合约id

可选

root_position_id

string

根合约id

必需

c_order_id

string

幂等订单id

可选

buy_currency

string

买入币种

必需

buy_amount

number

买入金额

必需

sell_currency

string

卖出币种

必需

sell_amount

number

卖出金额

必需

price

number | null

成交价

必需

base_currency

string

基础货币

必需

price2

number

成交价2

必需

base_currency2

string

基础货币2

必需

status

string

合约状态

必需

status_desc

string

状态描述

必需

value_date

string

交割日

必需

open_time

integer

开仓时间

必需

pay_way

enum<string> | enum<null>

支付方式

必需

枚举值:

creditbalance

violate_date

integer

违约日期

可选

violate_money

number

违约押金

可选

violate_currency

string

违约币种

可选

trade_channel

string

必需

下单渠道(web:页面下单，api:api下单)

source_type

string

必需

订单来源（spot:""实时换汇"",lock:锁汇换汇"",limit:""挂单换汇""）

cancel_way

string

可选

取消方式 customer("客户"),system("系统")

示例

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

string

可选

示例

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

修改于超过 1 年前

出入金记录查询

合约展期事件回调