receive/balance_update - 监听指定地址的交易

使用receive/balance_update调用监听指定地址发生的比特币收支交易。

API调用

POST v2/receive/balance_update

表单参数：

• address：要监听的地址
• callback：发生交易时的回调URL，注意要先将该URL进行url编码处理
• key：blockchain.info的v2支付api密钥，点击这里申请密钥：https://api.blockchain.info/v2/apikey/request/
• onNotification：请求通知行为，KEEP或DELETE
• confs：发送通知前交易需要的最小确认数，可选，默认值：3
• op：希望接收的操作类型，SPEND、RECEIVE、ALL，可选，默认值：ALL

API返回值

返回新创建的监听请求，主要字段如下：

• id：监听请求id
• addr：要监听的地址
• op：要监听的交易类型
• confs：最小确认数
• callback：回调URL
• onNotification：通知处理行为

示例代码

使用curl调用receive/balance_update的示例代码如下：

curl -H "Content-Type: text/plain" --data '{"key":"[your-key-here]","addr":"183qrMGHzMstARRh2rVoRepAd919sGgMHb","callback":"https://mystore.com?invoice_id=123","onNotification":"KEEP", "op":"RECEIVE", "confs": 5}' https://api.blockchain.info/v2/receive/balance_update

返回值：

{
  "id" : 70,
  "addr" : "183qrMGHzMstARRh2rVoRepAd919sGgMHb",
  "op" : "RECEIVE",
  "confs" : 5,
  "callback" : "https://mystore.com?invoice_id=123",
  "onNotification" : "KEEP"
}

响应中的id可用来删除请求，例如：

curl -X DELETE "https://api.blockchain.info/v2/receive/balance_update/70?key=[your-key-here]"

将得到如下响应：

{ "deleted": true }