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 |