Experimental - If you wish to use this API in a production environment, please contact: dexx@bitwatch.co

Currently v0.1.0-pre.

/listunspent/:address?verbose=0&minconf=1&maxconf=9999999&maxreqsigs=1


Description:

Returns an array of unspent transaction outputs with between minconf and maxconf (inclusive) confirmations, spendable by the provided address, whereby maximal maxreqsigs signatures are required to redeem the output.
 

Parameters:

  • address (string, required)
    The Bitcoin address
     
  • verbose (number, optional, default=0)
    If 0, exclude reqSigs, addresses, scriptPubKey (asm, hex), blockhash, blocktime, blockheight
     
  • minconf (number, optional, default=1)
    The minimum confirmations to filter
     
  • maxconf (number, optional, default=9999999)
    The maximum confirmations to filter
     
  • maxreqsigs (number, optional, default=1)
    The number of signatures required to spend the output
     

Example Request:

                GET http://api.bitwatch.co/listunspent/1BxtgEa8UcrMzVZaW32zVyJh4Sg4KGFzxA?minconf=11069&maxconf=12677&maxreqsigs=1
              
                {
  "status": 200,
  "method": "listunspent",
  "params": {
    "address": "1BxtgEa8UcrMzVZaW32zVyJh4Sg4KGFzxA",
    "verbose": 0,
    "minconf": 11069,
    "maxconf": 12677,
    "maxreqsigs": 1
  },
  "result": [{
    "txid": "bb9f953d74af38c27dda7895ad55660db05242a6e90d66767c1a8740c9e6a656",
    "vout": 1,
    "amount": 0.00000684,
    "type": "multisig",
    "confirmations": 12677
  }, {
    "txid": "3755648daa4d4b1cd1ec46349d4203356d31b1780360040dfee466769c839ebc",
    "vout": 1,
    "amount": 0.00000684,
    "type": "multisig",
    "confirmations": 11069
  }],
  "timestamp": 1410198190
}
              

Example Request 2:

                GET http://api.bitwatch.co/listunspent/1DrGnX4DxHdPhJekekVTazGc3zGdpPDKvb?verbose=1&minconf=0
              
                {
  "status": 200,
  "method": "listunspent",
  "params": {
    "address": "1DrGnX4DxHdPhJekekVTazGc3zGdpPDKvb",
    "verbose": 1,
    "minconf": 0,
    "maxconf": 9999999,
    "maxreqsigs": 1
  },
  "result": [{
    "txid": "6b315e8daf1e266c4929b76d4a2842d304cbaf67598d99153aec842004b8ec50",
    "vout": 0,
    "amount": 0.018,
    "type": "pubkeyhash",
    "reqSigs": 1,
    "addresses": ["1DrGnX4DxHdPhJekekVTazGc3zGdpPDKvb"],
    "scriptPubKey": {
      "asm": "OP_DUP OP_HASH160 8cf3116999ed48cc1d8736bacbd8e6401dc20a76 OP_EQUALVERIFY OP_CHECKSIG",
      "hex": "76a9148cf3116999ed48cc1d8736bacbd8e6401dc20a7688ac"
    },
    "blockhash": "0000000000000000a3a71706561928b370bcf4057ca79329400ca0a40b1477e4",
    "blocktime": 1396049970,
    "blockheight": 292985,
    "confirmations": 1980
  }, {
    "txid": "e46fe48acebf3c2540bb53049c4e0bf24317a46665e9b8e00936feae7383b619",
    "vout": 0,
    "amount": 0.0341,
    "type": "pubkeyhash",
    "reqSigs": 1,
    "addresses": ["1DrGnX4DxHdPhJekekVTazGc3zGdpPDKvb"],
    "scriptPubKey": {
      "asm": "OP_DUP OP_HASH160 8cf3116999ed48cc1d8736bacbd8e6401dc20a76 OP_EQUALVERIFY OP_CHECKSIG",
      "hex": "76a9148cf3116999ed48cc1d8736bacbd8e6401dc20a7688ac"
    },
    "confirmations": 0
  }],
  "timestamp": 1397059372
}
              

/listtransactions/:address?verbose=0&skip=0&count=100


Description:

Returns an array of all transactions associated with the given address.
 

Parameters:

  • address (string, required)
    The Bitcoin address
     
  • verbose (number, optional, default=0)
    If 0, return only transaction hex
     
  • skip (number, optional, default=0)
    The number of transactions to skip
     
  • count (number, optional, default=100)
    The number of transactions to return
     
  • includeorphans (number, optional, default=0)
    If 1, include orphaned transactions
     

Example Request:

                GET http://api.bitwatch.co/listtransactions/1BxtgEa8UcrMzVZaW32zVyJh4Sg4KGFzxA?skip=50&count=2
              
                {
  "status": 200,
  "method": "listtransactions",
  "params": {
      "address": "1BxtgEa8UcrMzVZaW32zVyJh4Sg4KGFzxA",
      "verbose": 0,
      "skip": 50,
      "count": 2,
      "includeorphans": 0
  },
  "result": [
    "01000000012c8905e0a5e64a5a5368cae138b61f281de7978e87d5c1efceed35f2f0eb06e9030000006b483045022100fc7022a2e5f40080ab
     95b185691f2a16cdfcb23dbb9ffc3fb031712f9ac0c39e02204e8064bdc4df36615568ba7ef5434b48cdc2d7f8a19c6e4135e7588c3283c33a
     012103c86e3c49a99dd688c6c6ad05d725b6a04ef19836b13d3e90ef282fc4f2f9ee71ffffffff0454150000000000001976a914de18f8c140
     416eb53d0717044aaae99d6191fa3e88ac54150000000000001976a914946cb2e08075bcbaf157e47bcb67eb2b2339d24288aca82a00000000
     000047512103c86e3c49a99dd688c6c6ad05d725b6a04ef19836b13d3e90ef282fc4f2f9ee712102c0189e96fbf6ff5953219b28399e22934e
     84d746f1ccbcb374186733e40624ae52aed7590400000000001976a914784345e76ea29fd7bfe31f6f34622e154d0bb8fc88ac00000000",
    "01000000013b3df72133fb33f6129c652ac72ee29605b4bf750e278c9bd007f44b6eda638a030000006a4730440220449a954f63356ce82ec8
    79ca29958f958e100e6c2a589fe61d771bc452df36e402200c53adb28417e83ccd81eb0bfc158d8ee0e97a4b30f8142ca5e02ed120e64b88012
    103c86e3c49a99dd688c6c6ad05d725b6a04ef19836b13d3e90ef282fc4f2f9ee71ffffffff0454150000000000001976a914216e03dda36b9f
    3883d2215d1a621a3dc81bb73b88ac54150000000000001976a914946cb2e08075bcbaf157e47bcb67eb2b2339d24288aca82a0000000000004
    7512103c86e3c49a99dd688c6c6ad05d725b6a04ef19836b13d3e90ef282fc4f2f9ee712102c0189e96fbf6ff5953219b28399f8b28ce84d746
    f1ccbcb374186733e406243d52ae77dd0300000000001976a914784345e76ea29fd7bfe31f6f34622e154d0bb8fc88ac00000000"
  ],
  "timestamp": 1410199282
}
              

Example Request 2:

                GET http://api.bitwatch.co/listtransactions/17cAYYAppEiKNtPVVW47W8oigZbPZXFarv?verbose=1&skip=23&count=1
              
                {
  "status": 200,
  "method": "listtransactions",
  "params": {
    "address": "17cAYYAppEiKNtPVVW47W8oigZbPZXFarv",
    "verbose": 1,
    "skip": 23,
    "count": 1,
    "includeorphans": 0
  },
  "result": [{
    "txid": "47651df35314e76e55ead31d5c048d233fd6899f4456590fa8b398e7cc7d7765",
    "version": 1,
    "locktime": 0,
    "vin": [{
      "txid": "e955c7d219125cd9c8a661ae13eb6420dbb544db238e2bf871ea51ff21830865",
      "vout": 0,
      "scriptSig": {
        "asm": "0 304402200f34b977331a877278a556ea8ac30f57d5011aa9487acdb6b28c554a49ff6f2d022000b37ee572e26aa38e5492dea
                120fb dea60a8fff6b3fa6ff0bbabbf05bdba39a01",
        "hex": "0047304402200f34b977331a877278a556ea8ac30f57d5011aa9487acdb6b28c554a49ff6f2d022000b37ee572e26aa38e5492d
                ea120fbdea60a8fff6b3fa6ff0bbabbf05bdba39a01"
      },
      "sequence": 4294967295
    }],
    "vout": [{
      "value": 0.0002,
      "n": 0,
      "scriptPubKey": {
        "asm": "1 0391b373843e77f5ac1f05db4afb5151190e67cfee5a48f7925d71da7c5e919422 0491b373843e77f5ac1f05db4afb5151
                190e67c fee5a48f7925d71da7c5e919422cdce2be353b26f36939a970b728909e863538297bb71b7b1721867fbf9f78f01 2
                OP_CHECKMULTISIG",
        "hex": "51210391b373843e77f5ac1f05db4afb5151190e67cfee5a48f7925d71da7c5e919422410491b373843e77f5ac1f05db4afb5
                151190e67cfee5a48f7925d71da7c5e919422cdce2be353b26f36939a970b728909e863538297bb71b7b1721867fbf9f78f01
                52ae",
        "reqSigs": 1,
        "type": "multisig",
        "addresses": ["17cAYYAppEiKNtPVVW47W8oigZbPZXFarv",
          "1EsYqQqPyRuTTH7tEAWDDsDyERYUCpyeKm"
        ]
      },
      "spendable": false
    }],
    "blockhash": "00000000000000004ab0c77b2282d8e17ab1118426b34936dd046813368bc502",
    "confirmations": 6399,
    "time": 1393753889,
    "blocktime": 1393753889,
    "hex": "010000000165088321ff51ea71f82b8e23db44b5db2064eb13ae61a6c8d95c1219d2c755e900000000490047304402200f34b977331
            a877278a556ea8ac30f57d5011aa9487acdb6b28c554a49ff6f2d022000b37ee572e26aa38e5492dea120fbdea60a8fff6b3fa6ff0b
            babbf05bdba39a01ffffffff01204e0000000000006751210391b373843e77f5ac1f05db4afb5151190e67cfee5a48f7925d71da7c5
            e919422410491b373843e77f5ac1f05db4afb5151190e67cfee5a48f7925d71da7c5e919422cdce2be353b26f36939a970b728909e8
            63538297bb71b7b1721867fbf9f78f0152ae00000000"
  }],
  "timestamp": 1397064849
}
              

/getbalance/:address?minconf=6&maxreqsigs=1


Description:

Returns the sum of spendable transaction outputs by address with at least minconf confirmations, whereby maximal maxreqsigs signatures are allowed to be required to redeem an output.
 

Parameters:

  • address (string, required)
    The Bitcoin address
     
  • minconf (number, optional, default=1)
    The minimum confirmations to filter
     
  • maxreqsigs (number, optional, default=1)
    The number of signatures required to spend the output
     

Example Request:

                GET http://api.bitwatch.co/getbalance/1Pa6zyqnhL6LDJtrkCMi9XmEDNHJ23ffEr?minconf=6&maxreqsigs=1
              
                {
  "status": 200,
  "method": "getbalance",
  "params": {
    "address": "1Pa6zyqnhL6LDJtrkCMi9XmEDNHJ23ffEr",
    "minconf": 6,
    "maxreqsigs": 1
  },
  "result": 0.00263591,
  "timestamp": 1410198872
}
              

/gettxposition/:txid


Description:

Returns information related to the position of transaction.
 

Parameters:

  • txid (string, required)
    The transaction id
     

Example Request:

                GET http://api.bitwatch.co/gettxposition/7f7b19224645cc2574ebff43b3737ee9c44c99b9e2098fd7cbc59ebfdd41c128
              
                {
  "status": 200,
  "method": "gettxposition",
  "params": {
    "txid": "7f7b19224645cc2574ebff43b3737ee9c44c99b9e2098fd7cbc59ebfdd41c128"
  },
  "result": {
    "txid": "7f7b19224645cc2574ebff43b3737ee9c44c99b9e2098fd7cbc59ebfdd41c128",
    "blockhash": "0000000000000000e0d04109a83c757985daec48b943251fd5122c60d13ca367",
    "blockheight": 291601,
    "position": 342
  },
  "timestamp": 1410199021
}
              

Experimental - If you wish to use this API in a production environment, please contact: dexx@bitwatch.co