Skip to main content

GetAccountExchangeRequests

Retrieves exchange requests for a specific account, optionally filtered by currency or base currency.

Request

GET /nxt?requestType=get-account-exchange-requests

All endpoints use port 22024 by default.

Parameters

NameTypeDescriptionRequired
accountstringAccount ID or SHAMWARI addressYes
currencylongFilter by currency IDOptional
baseCurrencylongFilter by base currency IDOptional
includeCurrencyInfobooleanInclude currency metadataOptional
firstIndexintPagination start indexOptional
lastIndexintPagination end indexOptional

Response

{
"exchangeRequests": [
{
"exchangeRequest": {
"account": "1234567890",
"accountRS": "SHAMWARI-ABCD-EFGH-IJKL-MNOPQ",
"currency": "987654321",
"baseCurrency": "555555555",
"unitsQNT": "5000000000",
"rateQNTPerUnit": "500",
"height": 250
}
}
]
}

Response Fields

FieldTypeDescription
accountstringAccount ID
accountRSstringAccount Reed-Solomon address in SHAMWARI format
currencystringCurrency ID
baseCurrencystringBase currency ID
unitsQNTstringNumber of units
rateQNTPerUnitstringExchange rate
heightintBlock height

Error Codes

CodeDescription
3Unknown account

Example

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