Blockchain API

Watch a Bitcoin Address with Webhooks

POST /btc/webhooks

#Request

curl -X POST https://blockchainapi.qoest.com/btc/webhooks \
  -H "Authorization: Bearer your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Cold wallet",
    "address": "bc1qexampleaddress000000000000000000000000",
    "webhook_url": "https://example.com/hooks/btc"
  }'

#Parameters

Name Type Required Notes
name string yes Your label, up to 255 characters.
address string yes A Bitcoin mainnet address: legacy (1...), P2SH (3...) or bech32 (bc1...). Testnet is not supported.
webhook_url string yes The URL that receives the deliveries.

Sending the same address and webhook_url again updates that webhook instead of creating a second one.

#Response

201 when created, 200 when an existing webhook was updated.

{
  "id": 7,
  "name": "Cold wallet",
  "address": "bc1qexampleaddress000000000000000000000000",
  "webhook_url": "https://example.com/hooks/btc",
  "blockchain_type": 0,
  "created_at": "2026-01-01T12:00:00.000000Z",
  "updated_at": "2026-01-01T12:00:00.000000Z"
}

blockchain_type is 0 for Bitcoin and 1 for Ethereum.

#Get or Delete a Webhook

curl https://blockchainapi.qoest.com/btc/webhooks/7 \
  -H "Authorization: Bearer your-token"

curl -X DELETE https://blockchainapi.qoest.com/btc/webhooks/7 \
  -H "Authorization: Bearer your-token"

Both return 404 for an id that is not yours. Deleting stops the polling, and with it the credit use.

#What Gets Sent

One delivery per confirmed transaction:

  • Money received: the output paid to your address.
  • Money sent: the largest output that is not change back to you.
  • Coinbase (mining) transactions are skipped.

See Webhook Payloads for the body.

#Errors

Status Body
401 {"message": "Unauthenticated."}
404 Webhook not found
422 Invalid address or URL