Skip to main content

GetCurrencyTaxRecords

Retrieves tax records for currency transfers and payments, filterable by currency, account, and timestamp.

Request

GET /nxt?requestType=getCurrencyTaxRecords

Parameters

NameTypeDescriptionRequired
currencylongCurrency IDOptional
accountstringFilter by accountOptional
includeCurrencyInfobooleanInclude currency metadataOptional
firstIndexintPagination start indexOptional
lastIndexintPagination end indexOptional
timestampintOnly return records at or after this timestampOptional

Notes

  • At least one of currency or account must be provided
  • Returns MISSING_CURRENCY_ACCOUNT if both are missing

Response

{
"taxRecords": [
{
"currency": "987654321",
"taxRecordFullHash": "abc123def456...",
"payer": "1234567890",
"payerRS": "NXT-abcd-efgh-ijkl",
"taxCollector": "0987654321",
"taxCollectorRS": "NXT-zyxw-vuts-rqpo",
"unitsQNT": "5000000",
"height": 250,
"timestamp": 123456789,
"currencyInfo": {
"name": "MyCoin",
"code": "MYC",
"decimals": 8
}
}
]
}

Example

# Get tax records for a currency
curl "http://localhost:22024/nxt?requestType=getCurrencyTaxRecords&currency=987654321&includeCurrencyInfo=true"

# Get tax records for an account
curl "http://localhost:22024/nxt?requestType=getCurrencyTaxRecords&account=1234567890"