GetCurrencyPayments

Retrieves currency payment records, filterable by currency, account, or both.

Request

GET /nxt?requestType=get-currencyPayments

Parameters

Name	Type	Description	Required
currency	long	Currency ID	Optional
account	string	Account ID or NXT address	Optional
firstIndex	int	Pagination start index (default: 0)	Optional
lastIndex	int	Pagination end index (default: MAX)	Optional
timestamp	int	Only return payments at or after this timestamp	Optional
includeCurrencyInfo	boolean	Include currency metadata in each payment	Optional

Notes

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

Response

{
  "payments": [
    {
      "paymentFullHash": "abc123def456...",
      "chain": 1,
      "currency": "987654321",
      "sender": "1234567890",
      "senderRS": "NXT-abcd-efgh-ijkl",
      "recipient": "0987654321",
      "recipientRS": "NXT-zyxw-vuts-rqpo",
      "unitsQNT": "1000000000",
      "taxUnitsQNT": "5000000",
      "height": 250,
      "timestamp": 123456789
    }
  ]
}

Example

# Get all payments for a specific currency
curl "http://localhost:22024/nxt?requestType=get-currencyPayments&currency=987654321&includeCurrencyInfo=true"

# Get payments for an account
curl "http://localhost:22024/nxt?requestType=get-currencyPayments&account=1234567890"

# Get payments for a specific currency and account
curl "http://localhost:22024/nxt?requestType=get-currencyPayments&currency=987654321&account=1234567890&firstIndex=0&lastIndex=50"

Related

• CurrencyPayment
• GetExpectedCurrencyPayments
• GetCurrency