Bitcoin Stack Exchange is a question and answer site for Bitcoin crypto-currency enthusiasts. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

How can I know if any given transaction has confirmations and has paid the miner's fee, using the DATA API?

share|improve this question
up vote 6 down vote accepted

If a transaction returned from the$tx_hash endpoint has a confirmation, it will have a block_height member. You can then calculate roughly its number of confirmations by subtracting that value from the latest height retrieved from the endpoint.

Code example, in Ruby:

#!/usr/bin/env ruby
require "open-uri"
require "json"
# call this script with `ruby block_height.rb <tx_hash>`
tx = ARGV.shift
puts "Getting info for #{tx}..."
j = JSON.parse open("{tx}").read
if j["block_height"]
  b = JSON.parse open("").read
  puts "%d confirmations" % (b["height"] - j["block_height"] + 1)
  time_since = - j["time"]
  puts "It's been #{time_since} seconds since the transaction was created."
  puts "It's not been ten minutes yet!" if time_since < 600
  puts "It's due any time now." if time_since >= 600

Calculating the transaction fee is best done by summing the inputs and outputs of a transaction, then subtracting the inputs from the outputs. Difference is the transaction fee.

share|improve this answer
Hi Colin! Thanks a lot! Could you expand a bit on the block_height part? – flaab Jan 28 '13 at 15:51
Added a code example for you. – Colin Dean Jan 29 '13 at 2:54
verifies but just out of curiosity, how do I explain the relations between the number of confirmations, the tx block height and the latest block height? – sysfault Nov 2 '15 at 6:37
number of confirmations = latest block height - tx block height – Colin Dean Nov 6 '15 at 19:35

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.