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】

[Account] Query account balance

method url:/api/third/hot/order/balance

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

symbol

query

true

string

timestamp

query

true

string

response param:

param_name

param note

data type

schema

  availableAmount

number

  coinId

integer(int64)

  frozenAmount

number

  symbol

string

  userId

integer(int64)

example:

1 Set request parameters, query params:

symbol:USD
timestamp:1725867599415

2 Build the Parameters

symbol=USD&timestamp=1725867599415

3 Sign the parameter string format, result:

0xb89ebe4ad4aabdb7a01e5ad190b341ebc42a011dd416cfc7b4b8ee381eb124ce0147e01a0944afa44e99afd9636b857f30f595478bb665b3a2982b9d94bcc3ef1b

4 Assemble the complete request

curl --location --request POST 'https://zk-test.satori.finance/api/third/hot/order/balance?symbol=USD&timestamp=1725867599415' \
--header 'APIKEY: st_fq6cvRF4fr5tnKiZfrIntRnLfrwxcXjcfr1y8FR7' \
--header 'X-SAPI-SIGN-TYPE: 2' \
--header 'signature: 0xb89ebe4ad4aabdb7a01e5ad190b341ebc42a011dd416cfc7b4b8ee381eb124ce0147e01a0944afa44e99afd9636b857f30f595478bb665b3a2982b9d94bcc3ef1b' \
--header 'Content-Type: text/plain' \
--data ''

5 Return results

{
    "error": false,
    "code": 200,
    "msg": "SUCCESS",
    "data": {
        "userId": 42471,
        "coinId": 4,
        "availableAmount": "999951.980199",
        "frozenAmount": "47.390168",
        "symbol": "USD"
    },
    "sid": "1809703344791625729"
}

Error Code:

code

msg

2001

Illegal parameter:{param0}

2002

Required parameter:{param0}

2122

No hot assets have been frozen

4001

Invalid address

Previous【Private Query】Next[Order] Query current order list

Last updated 7 months ago

👨‍💻