Skip to main content

GetGuaranteedBalance

Returns the guaranteed balance of an account, which is the minimum balance that cannot be spent due to transaction leasing and other commitments.

Request

GET /nxt?requestType=getGuaranteedBalance

All endpoints use port 22024 by default.

Parameters

NameTypeDescriptionRequired
accountstringAccount ID or SHAMWARI addressYes
numberOfConfirmationsintNumber of confirmations for guarantee calculationOptional

Response

{
"balanceFQT": "1000000000",
"guaranteedBalanceFQT": "800000000",
"errorCode": 0,
"errorDescription": ""
}

Response Fields

FieldTypeDescription
balanceFQTstringConfirmed balance in NQT
guaranteedBalanceFQTstringMinimum guaranteed balance

Error Codes

CodeDescription
3Unknown account

Example

curl "http://localhost:22024/nxt?requestType=getGuaranteedBalance&account=SHAMWARI-ABCD-EFGH-IJKL-MNOPQ"