GetAccountCurrencies
Returns currency holdings for a specific account, optionally filtered by currency ID.
Request
GET /nxt?requestType=get-account-currencies
All endpoints use port 22024 by default.
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
account | string | Account ID or SHAMWARI address | Yes |
currency | long | Filter by currency ID | Optional |
height | int | Block height for historical query | Optional |
includeCurrencyInfo | boolean | Include currency metadata in response | Optional |
Response
{
"accountCurrencies": [
{
"account": "1234567890",
"accountRS": "SHAMWARI-ABCD-EFGH-IJKL-MNOPQ",
"currency": "987654321",
"unitsQNT": "5000000000",
"unconfirmedUnitsQNT": "1000000000",
"height": 250
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
account | string | Account ID |
accountRS | string | Account Reed-Solomon address in SHAMWARI format |
currency | string | Currency ID |
unitsQNT | string | Number of currency units held |
unconfirmedUnitsQNT | string | Unconfirmed currency units |
height | int | Block height |
Error Codes
| Code | Description |
|---|---|
| 3 | Unknown account |
Example
curl "http://localhost:22024/nxt?requestType=get-account-currencies&account=SHAMWARI-ABCD-EFGH-IJKL-MNOPQ"