GetBalance
Returns the confirmed and unconfirmed balance for an account.
Request
GET /nxt?requestType=getBalance
All endpoints use port 22024 by default.
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
account | string | Account ID or SHAMWARI address | Yes |
height | int | Block height for historical balance | Optional |
Response
{
"balanceFQT": "1000000000",
"unconfirmedBalanceFQT": "1000000000",
"guaranteedBalanceFQT": "800000000",
"forgedBalanceFQT": "500000000",
"errorCode": 0,
"errorDescription": ""
}
Response Fields
| Field | Type | Description |
|---|---|---|
balanceFQT | string | Confirmed balance in NQT |
unconfirmedBalanceFQT | string | Balance including unconfirmed transactions |
guaranteedBalanceFQT | string | Minimum guaranteed balance |
forgedBalanceFQT | string | Total forged (earned) balance |
Error Codes
| Code | Description |
|---|---|
| 3 | Unknown account |
Example
curl "http://localhost:22024/nxt?requestType=getBalance&account=SHAMWARI-ABCD-EFGH-IJKL-MNOPQ"