Blockchain API
Blockchain Webhook Payloads
Each delivery is an HTTP POST to your webhook_url with a JSON body. Answer with any 2xx within 30 seconds to mark it delivered.
#Bitcoin
{
"webhook_id": 7,
"from": "bc1qsenderexample00000000000000000000000000",
"to": "bc1qexampleaddress000000000000000000000000",
"amount_btc": "0.0125",
"amount_usd": "1,187.50",
"amount_usdt": "1,186.90",
"fees_btc": "0.00001234",
"fees_usd": "1.17",
"fees_usdt": "1.17",
"transaction_hash": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"
}
#Ethereum and EVM chain transaction
The same body is sent for every EVM chain, with chain set to eth, polygon, bnb, arbitrum, base or optimism.
{
"webhook_id": 8,
"chain": "eth",
"type": "transaction",
"from": "0x1111111111111111111111111111111111111111",
"to": "0x2222222222222222222222222222222222222222",
"amount": "0.5",
"amount_usd": "1,650.00",
"amount_usdt": "1,649.10",
"fees": "0.000441",
"fees_usd": "1.46",
"fees_usdt": "1.45",
"transaction_hash": "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",
"block_height": "21000000"
}
For native coin transactions, fees is the gas price multiplied by the gas limit. amount and fees are in the chain's native coin: ETH, or POL on Polygon and BNB on BNB Smart Chain.
#ERC-20 transfer
{
"webhook_id": 8,
"chain": "eth",
"type": "transfer",
"from": "0x1111111111111111111111111111111111111111",
"to": "0x2222222222222222222222222222222222222222",
"amount": "250.00",
"amount_usd": "250.00",
"amount_usdt": "250.00",
"fees": "0.000312",
"fees_usd": "1.03",
"fees_usdt": "1.03",
"transaction_hash": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060",
"block_height": "21000001",
"token_name": "Tether USD",
"token_symbol": "USDT",
"token_decimals": "6"
}
#Field Notes
- All amounts are strings. USD and USDT values use a comma as the thousands separator, so strip commas before parsing.
- Use
webhook_idto tell your webhooks apart, andtransaction_hashto de-duplicate on your side. amount_usdandamount_usdtare"0.00"when no price is available for a token.- Deliveries are not signed. Put a hard-to-guess secret in your
webhook_urlpath and check it, and confirm large amounts against a block explorer before acting on them.