Watch a Bitcoin Address with Webhook Callback

2026-03-15 permalink SUBTC

#address #bitcoin #callback #watch #webhook

SUBTC can monitor a wallet address and trigger a webhook when a payment arrives.
This allows servers to receive real-time payment notifications.

Start watching an address:

curl -sS -X POST "https://api.subtc.net/v1/btc?mode=wallet_wait_event" \
  -H "X-SUBTC-KEY: $KEY" \
  -H "Content-Type: application/json" \
  -d "{\"wallet_id\":\"$WID\",\"address\":\"$ADDR\",\"expected_sat\":20000,\"timeout_sec\":600,\"callback_url\":\"https://yourserver.com/webhook\"}"

Example response:

{
 "ok": true,
 "request_id": "41530f6bbb90466c",
 "result": {
  "address": "tb1qj3xzdyr6fdhzh37w4avm4l5dnm53cmvf6p27rf",
  "callback_url": "https://yourserver.com/webhook",
  "expected_sat": 20000,
  "status": "watching",
  "wallet_id": "w_cf21a601a3f461a92699e5b5dac80ad6d9d66de4592d"
 }
}

What happened:

The gateway started monitoring the address.
Once the address receives at least **20,000 SAT**, SUBTC will send a POST request to the webhook URL.

This pattern enables automated payment processing for services, games, or marketplaces.

API Base:
https://subtc.net/api

Watch a Bitcoin Address with Webhook Callback

Related Articles