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_id to tell your webhooks apart, and transaction_hash to de-duplicate on your side.
  • amount_usd and amount_usdt are "0.00" when no price is available for a token.
  • Deliveries are not signed. Put a hard-to-guess secret in your webhook_url path and check it, and confirm large amounts against a block explorer before acting on them.