GetCurrencyTransfers

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

Request

GET /nxt?requestType=get-currencyTransfers

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 transfers at or after this timestamp	Optional
includeCurrencyInfo	boolean	Include currency metadata in each transfer	Optional

Notes

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

Response

{
  "transfers": [
    {
      "transferFullHash": "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,
      "currencyInfo": {
        "name": "MyCoin",
        "code": "MYC",
        "decimals": 8
      }
    }
  ]
}

Example

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

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

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

Related

• TransferCurrency
• GetExpectedCurrencyTransfers
• GetCurrency