12

What is exactly the difference between

time, blocktime and timereceived

in transaction information returned by Bitcoind JSON RPC API? For example:

{
    "amount": 0.02,
    "blockindex": 45,
    "time": 1306179671,
    "category": "receive",
    "confirmations": 109244,
    "timereceived": 1306179671,
    "address": "1P5xanGEdgPKYNt4BnATambHpbZ2h89bYv",
    "txid": "91eb6cb34b9253cce0ab5da171a0f5aae9d3d36208e23062ba61cd9e21c09a3d",
    "blockhash": "0000000000002e65f5cc554e99c352af958a63f4be663627f2c569e5a996a03a",
    "account": "",
    "blocktime": 1306173564
}
kramer65
  • 315
  • 2
  • 10
Alexey Kalmykov
  • 754
  • 6
  • 18

1 Answers1

9

timereceived is when your client first learned of the transaction. If you sent the transaction, it's the time when you sent the transaction. If you received the transaction, it's when your client first saw the transaction on the network.

time can be different from timereceived if you first learned about the transaction by seeing it in a block. This usually happens when your client was offline for a while and you're getting caught up with the block chain. In this case, time will use the block's timestamp if it seems reasonable. Specifically:

  • If the block timestamp is in the future, time will be the same as timereceived.
  • If the block timestamp is before the latest transaction in the wallet, time will be equal to the time of the latest transaction in the wallet.
  • Otherwise, the block timestamp will be used.

Transaction times don't change, even after a reorg, and new transactions will never have a time earlier than an existing transaction. This was not always the case (old versions preferred to use the block timestamp, which is usually more accurate), but the current method makes it easier to deal with transaction timestamps safely.

theymos
  • 8,904
  • 40
  • 37