Skip to main content

GetAccountCurrencyVaults

Retrieves time-locked currency vaults for a specific account.

Request

GET /nxt?requestType=getAccountCurrencyVaults

Parameters

NameTypeDescriptionRequired
accountstringAccount ID or NXT addressYes
currencylongFilter by currencyOptional
heightintBlockchain height for historical queryOptional
includeCurrencyInfobooleanInclude currency metadataOptional

Response

{
"accountCurrencyVaults": [
{
"account": "1234567890",
"accountRS": "NXT-abcd-efgh-ijkl",
"currency": "987654321",
"unitsQNT": "5000000000",
"lockHeight": 100000,
"releaseHeight": 101000
}
]
}

Response Fields Description

FieldTypeDescription
accountstringAccount ID
accountRSstringAccount in NXT format
currencystringCurrency ID
unitsQNTstringLocked units
lockHeightintBlock height when vault was created
releaseHeightintBlock height when units are released

Example

# Get all vaults for an account
curl "http://localhost:22024/nxt?requestType=getAccountCurrencyVaults&account=1234567890"

# Get vaults for a specific currency
curl "http://localhost:22024/nxt?requestType=getAccountCurrencyVaults&account=1234567890&currency=987654321"