Check account balance
Balance
Query Account Balance
Retrieve the payment account balance for the merchant.
GET
Check account balance
Overview
This page documents thePOST /payment/open/institution/v1/balance endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.
Notes
- Authentication uses the standard GatePay signed headers.
- This is the institution sub-account balance query API.
- The request body is a JSON array of currencies to query, for example
["USDT", "BTC"]. - The correct path is the legacy production path confirmed by backend, not
/payment/open/institution/v1/pay/balance/query. - For shared signing rules, see /api-reference/version/100/en/common/securityAndSignature.
Institution Notes
- Institutional requests must include
X-GatePay-On-Behalf-Ofto specify the institutional sub-account to operate on.
Headers
Merchant client ID
Example:
"4186d0c6-6a35-55a9-8dc6-5312769dbff8"
Signature
Example:
"672d5650dcc9bb22ebf25fa16c28d03c0e159d742a9176d4340a5da326d75dc8"
Timestamp (milliseconds)
Example:
"1672905655498"
Nonce
Example:
"9578"

