A complete example

1 Get the API endpoint path:

Order placement url in testing environment: https://zk-test.satori.finance/api/third/hot/order/create

2 Get api keys

3.1,Set request parameters

clientOrderId: "{{satTimestamp}}"
isLong: "True"
isMarket: "True"
lever: "20"
matchType: "2"
pairName: "ETH-USD"
positionType: "3"
price: "3100"
quantity: "0.02"
timestamp: "{{satTimestamp}}"

3.2 build request string

request string = "clientOrderId=1725693490018&isLong=True&isMarket=True&lever=20&matchType=2&pairName=ETH-USD&positionType=3&price=3100&quantity=0.02&timestamp=1725693490018"

3.3 Sign the parameter string format

sign result = "0x7c8e2c2e5bfdd29f217e9bf1de4270c4c4aebe85ab09864cf3bef3bcf6f520d70b9e5c251280a2defe77cd5f3d6b64d938906317303a96955d8e3830af9ea03c1c"

3.4 Assemble the complete request

curl --location --request POST 'https://zk-test.satori.finance/api/third/hot/order/create?clientOrderId=1725693490018&isLong=True&isMarket=True&lever=20&matchType=2&pairName=ETH-USD&positionType=3&price=3100&quantity=0.02&timestamp=1725693490018' \
--header 'APIKEY: st_fq6cvRF4fr5tnKiZfrIntRnLfrwxcXjcfr1y8FR7' \
--header 'X-SAPI-SIGN-TYPE: 2' \
--header 'signature: 0x7c8e2c2e5bfdd29f217e9bf1de4270c4c4aebe85ab09864cf3bef3bcf6f520d70b9e5c251280a2defe77cd5f3d6b64d938906317303a96955d8e3830af9ea03c1c' \
--header 'Content-Type: text/plain' \
--data ''

4 Return results

{
  "error": false,
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "pairName": "ETH-USD",
    "orderId": 178754443,
    "corderId": "1725693490018"
  },
  "sid": "1809520778222411777"
}

Last updated