Satori Finance Docs
  • ✨About Satori Finance
  • 👉Beginner's Guide
    • Deposit & Withdrawal
    • Trading
  • 💸Perpetual Trading
    • Matchmaking
    • Margin
    • Isolated/Cross Margin
    • Funding Costs
    • Trading fees
    • Index Price
    • Mark Price
    • Liquidations
    • Insurance Funds
    • Automatic Deleveraging
  • 🌽Vaults
  • 📲Telegram Mini APP
  • 🚀Liquid Restaked Tokens (LRT)
  • 🔥Points
  • 🎉Trading Competition
    • Satori Season2 Trading Competition Backed by Hemi
  • 🎭Referrals
  • 🦄Ecosystem Partner Incentives
  • API DOCS
    • 👨‍💻OpenAPI
      • Introduce
      • Auth
      • URL
      • Response Code
      • Rest API
        • A complete example
        • Order Operation 【Private Operation】
          • Create order
          • Batch create orders
          • Cancel order
          • Batch Cancel orders
        • Position Operation 【private operation】
          • Add/reduce margin
        • 【Private Query】
          • [Account] Query account balance
          • [Order] Query current order list
          • [Trade] Query match result
          • [Position] Query position list
        • 【Public Query】
          • System time
          • Index price
          • Mark price
          • Last trade
          • Pair list
      • WebSocket
        • Events
        • Subscription
          • Basic parameters
          • Example
          • Account
          • Orders
          • Positions
          • Trades
Powered by GitBook
On this page
  1. API DOCS
  2. OpenAPI
  3. Rest API
  4. 【Private Query】

[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}

Previous[Order] Query current order listNext[Position] Query position list

Last updated 7 months ago

👨‍💻