[Trade] Query match result

method url:/api/third/order/selectContractMatchPairList

request type:POST

content type:application/x-www-form-urlencoded

need sign:true

detail:

request param:

param_name

param note

type

required

data type

schema

pairName

query

true

string

pageNo

query

false

integer(int64)

pageSize

query

false

integer(int64)

timestamp

query

true

string

matchId

Transaction ID (only orders prior to this matchId are returned, the most recent order is returned by default)

query

false

Long

response param:(list)

param_name

param note

type

schema

  amount

number

  averagePrice

number

  contractPairId

integer(int64)

  contractPositionId

integer(int64)

  createTime

yyyy-MM-dd HH:mm:ss

string

  createTimeStamp

integer(int64)

  entrustId

integer(int64)

  id

integer(int64)

  isClose

true/false

boolean

  isLong

true/false

boolean

  isMarket

true/false

boolean

  isTaker

true _taker; false _maker;

boolean

  lever

integer(int32)

  positionFee

number

  profitLoss

number

  quantity

number

  symbol

string

  tradeFee

number

  accountCoinSymbol

string

accountSettleDecimal

integer(int32)

  isDelivery

boolean

  deliveryTime

string(date-time)

    deliveryTimeStamp

integer(int64)

  address

string

  openingPrice

number

example:

1 Set request parameters, query params:

matchId:19864367
pageNo:1
pageSize:2
pairName:ETH-USD
timestamp:1725868174532

2 Build the Parameters

matchId=19864367&pageNo=1&pageSize=2&pairName=ETH-USD&timestamp=1725868174532

3 Sign the parameter string format, result:

0x438e6ca43d3dd371f5c7dde98d967bb9d7949f82d19496513e085d7e3b55d26f75d7269ae7ece951fd9672b2a8b70ec298ab155f63e364c951d2c6a58bd5be7f1b

4 Assemble the complete request

curl --location --request POST 'https://zk-test.satori.finance/api/third/order/selectContractMatchPairList?matchId=19864367&pageNo=1&pageSize=2&pairName=ETH-USD&timestamp=1725868174532' \
--header 'APIKEY: st_fq6cvRF4fr5tnKiZfrIntRnLfrwxcXjcfr1y8FR7' \
--header 'X-SAPI-SIGN-TYPE: 2' \
--header 'signature: 0x438e6ca43d3dd371f5c7dde98d967bb9d7949f82d19496513e085d7e3b55d26f75d7269ae7ece951fd9672b2a8b70ec298ab155f63e364c951d2c6a58bd5be7f1b' \
--header 'Content-Type: text/plain' \
--data ''

5 Return results

{
    "error": false,
    "code": 200,
    "msg": "SUCCESS",
    "data": [
        {
            "id": 19862817,
            "entrustId": 180577696,
            "contractPositionId": 0,
            "contractPairId": 1,
            "createTime": "2024-09-09 07:08:26",
            "createTimeStamp": 1725865706000,
            "symbol": "ETH-USD",
            "accountCoinSymbol": null,
            "accountSettleDecimal": null,
            "lever": null,
            "isMarket": true,
            "isClose": false,
            "isLong": true,
            "isTaker": true,
            "averagePrice": "2315.09",
            "quantity": "0.02",
            "amount": "46.3018",
            "tradeFee": "0.027781",
            "positionFee": null,
            "profitLoss": "0",
            "isDelivery": null,
            "deliveryTime": null,
            "deliveryTimeStamp": null,
            "address": null,
            "openingPrice": null,
            "type": null,
            "restrictPrice": null
        },
        {
            "id": 19696541,
            "entrustId": 178785303,
            "contractPositionId": 0,
            "contractPairId": 1,
            "createTime": "2024-09-07 08:06:34",
            "createTimeStamp": 1725696394000,
            "symbol": "ETH-USD",
            "accountCoinSymbol": null,
            "accountSettleDecimal": null,
            "lever": null,
            "isMarket": true,
            "isClose": false,
            "isLong": true,
            "isTaker": true,
            "averagePrice": "2296.13",
            "quantity": "0.02",
            "amount": "45.9226",
            "tradeFee": "0.027553",
            "positionFee": null,
            "profitLoss": "0",
            "isDelivery": null,
            "deliveryTime": null,
            "deliveryTimeStamp": null,
            "address": null,
            "openingPrice": null,
            "type": null,
            "restrictPrice": null
        }
    ],
    "sid": "1809703947882209281"
}

Error Code:

code

msg

2001

Illegal parameter:{param0}

Last updated