Skip to main content

GetTotemTransfers

Retrieves historical totem transfers from the blockchain.

Endpoint: GET /nxt?requestType=GetTotemTransfers

Parameters:

  • totem (long, optional): Totem ID to filter by
  • account (long, optional): Account ID to filter by
  • firstIndex (int, optional, default: 0): Starting index for pagination
  • lastIndex (int, optional, default: 99): Ending index for pagination
  • timestamp (int, optional, default: 0): Minimum timestamp to include (epoch seconds)
  • includeTotemInfo (boolean, optional, default: false): Include totem information in results

Request Example: /nxt?requestType=GetTotemTransfers&totem=123456789&timestamp=123456000

Response:

{
"transfers": [
{
"totemTransferFullHash": "abc123...",
"chain": 1,
"totem": "123456789",
"sender": "111111111",
"recipient": "222222222",
"quantityQNT": "100000000",
"height": 123456,
"timestamp": 123456789
}
]
}

Response Fields:

  • transfers: array - Array of transfer objects
  • transfers[].totemTransferFullHash: string - Full hash of the transfer
  • transfers[].chain: number - Chain ID
  • transfers[].totem: string - Totem ID (unsigned string)
  • transfers[].sender: string - Sender account ID (unsigned string)
  • transfers[].recipient: string - Recipient account ID (unsigned string)
  • transfers[].quantityQNT: string - Quantity transferred in Quantum Units
  • transfers[].height: number - Block height of the transfer
  • transfers[].timestamp: number - Timestamp of the transfer
  • transfers[].totemInfo: object - Only if includeTotemInfo=true, contains totem details from putTotemInfo()

Source: GetTotemTransfers.java, JSONData.totemTransfer() Notes: Either totem or account must be provided. Entries filtered by timestamp. Starts DB transaction. Not chain-specific.