Blockchain API手册

支付处理API
支付处理API概述 receive - 生成收款地址 receive/balance_update - 监听指定地址的交易 receive/block_notification - 监听新区块通知 receive/checkgap - 检查地址间隔 receive/callback_log - 调试未完成支付
区块链钱包API
区块链钱包API概述 create - 创建钱包 merchant/*/payment - 向单一地址支付 merchant/*/sendmany - 向多个地址支付 merchant/*/balance - 读取钱包余额 merchant/*/list - 列出钱包中的活动地址 merchant/*/address_balance - 获取指定地址的余额 merchant/*/new_address - 生成一个新地址 merchant/*/archive_address - 归档指定的地址 merchant/*/unarchive_address - 解除指定地址的归档
区块链数据API
区块链数据API概述 rawblock - 获取指定区块的数据 rawtx - 获取指定交易的数据 charts - 获取指定图表的数据 block-height - 获取指定高度的区块数据 rawaddr - 获取指定地址的相关数据 multiaddr - 获取多个地址的相关信息 unspent - 获取指定地址的未消费输出 balance - 获取指定地址的比特币余额 latestblock - 获取最新区块信息 unconfirmed-transactions - 获取未确认的交易清单 blocks - 获取指定条件的区块清单
简明查询API
简明查询API概述 q/getdifficulty - 获取当前难度目标 q/getblockcount - 获取最长链当前区块高度 q/latesthash - 获取最新区块的哈希 q/bcperblock - 获取当前区块的奖励额度 q/totalbc - 获取流通中的比特币总量 q/probability - 获取单次哈希尝试成功出块的概率 q/hashestowin - 获取成功出块的平均哈希尝试次数 q/nextretarget - 下次重设难度目标的区块高度 q/avgtxsize - 获取平均交易大小 q/avgtxvalue - 获取平均交易金额 q/interval - 获取平均出块间隔 q/eta - 下次出块时间预估 q/avgtxnumber - 获取区块平均交易数量 q/getreceivedbyaddress - 获取指定地址收到的比特币数量 q/getsentbyaddress - 获取指定地址发送的比特币数量 q/addressbalance - 获取指定地址的比特币余额 q/addressfirstseen - 获取指定地址首次出现时间戳 q/txtotalbtcoutput - 获取指定交易的输出总金额 q/txtotalbtcinput - 获取指定交易的输入总金额 q/txfee - 获取指定交易的手续费 q/txresult - 计算指定地址的交易执行结果 q/addresstohash - 将比特币地址转换为160哈希 q/hashtoaddress - 将160哈希转换为比特币地址 q/hashpubkey - 将公钥转换为哈希160 q/addrpubkey - 将公钥转换为地址 q/pubkeyaddr - 将地址转换为公钥 q/unconfirmedcount - 获取待定交易数量 q/24hrprice - 获取比特币24小时加权价格 q/marketcap - 获取市场总规模 q/24hrtransactioncount - 获取过去24小时的交易总数 q/24hrbtcsent - 获取过去24小时发送的比特币总量 q/hashrate - 获取网络哈希速率估算值 q/rejected - 获取指定交易被拒的原因
WebSocket实时通知API
WebSocket实时通知API概述 ping - 连通测试 unconfirmed_sub - 订阅未确认交易通知 unconfirmed_unsub - 取消订阅未确认交易通知 addr_sub - 订阅指定地址的新交易通知 addr_unsub - 取消订阅指定地址的新交易通知 block_sub - 订阅新区块通知 block_unsub - 取消订阅新区块通知 ping_block - 附带区块信息的连通测试 ping_tx - 附带交易信息的连通测试
市场行情数据API
市场行情数据API概述 ticker - 获取币种代码表 tobtc - 汇率换算
统计图表API
统计图表API概述 charts - 获取图表数据 stats - 获取统计数据 pools - 获取矿池信息

ping_tx - 连通测试

使用ping_tx指令测试blockchain.info的websocket服务的连通性,附带反馈最新交易数据。

请求

{
  "op":"ping_tx"
}

响应

如果服务正常,将返回utx指令:

{
  "op":"utx"
  ....
}

示例代码

通过websocket连接发送ping_tx指令:

{
  "op":"ping_tx"
}

响应结果如下:

{ 
  "op" : "utx", 
  "x" : { 
    "lock_time" : 0, 
    "ver" : 1, 
    "size" : 256, 
    "inputs" : [ { 
      "sequence" : 4294967295, 
      "prev_out" : { 
        "spent" : true, 
        "tx_index" : 445123473, 
        "type" : 0, 
        "addr" : "1HckjUpRGcrrRAtFaaCAUaGjsPx9oYmLaZ", 
        "value" : 710733, 
        "n" : 0, 
        "script" : "76a914b64513c1f1b889a556463243cca9c26ee626b9a088ac" 
      }, 
      "script" : "47304402204c2ccb73d82d70b99d2acc0d8e097126e4055712a0df79cf45cf2ac02a569b79022064fd7af77aa5d6cd2ad4da0c3ed96d2a6306b48d894d988efcd97ddccc015d220121030651e1d15ae9a284ffd712885529d3344db3700be756e6c22c56a6c1b57d359d" 
    } ], 
    "time" : 1557717225, 
    "tx_index" : 446714790, 
    "vin_sz" : 1, 
    "hash" : "b0ff4863e6182bbeb8e9240a909f5814187c87bb18a30022f05e4249e8ed09d5", 
    "vout_sz" : 3, 
    "relayed_by" : "0.0.0.0", 
    "out" : [ { 
      "spent" : false, 
      "tx_index" : 446714790, 
      "type" : 0, 
      "addr" : "1HckjUpRGcrrRAtFaaCAUaGjsPx9oYmLaZ", 
      "value" : 693987, 
      "n" : 0, 
      "script" : "76a914b64513c1f1b889a556463243cca9c26ee626b9a088ac" 
    }, { 
      "spent" : false, 
      "tx_index" : 446714790, 
      "type" : 0, 
      "addr" : "1N6eMsUbYPgSwYsEosSeRCrr9rvfjtCtKU", 
      "value" : 546, 
      "n" : 1, 
      "script" : "76a914e76be85e177a3b85c2072d73f29a8824847925c288ac" 
    }, { 
      "spent" : false, 
      "tx_index" : 446714790, 
      "type" : 0, 
      "addr" : null, 
      "value" : 0, 
      "n" : 2, 
      "script" : "6a146f6d6e69000000000000001f00000017676cc770" 
    } ] 
  } 
}