Example callback
This is an example callback endpoint that receives webhook notifications for address transactions.
To enable webhook notifications for your transactions, you must configure your callback URL in the Better Use Blockchain dashboard.
Navigate to the Send Callbacks section in the sidebar menu, as shown in the image above. Enter your callback URL in the designated field under ‘Update API callback registration URL’, then click the ‘Update’ button to save the changes.
Make sure the provided URL is accessible and properly configured to handle incoming POST requests from the Better Use Blockchain system. This URL will be used to receive real-time notifications for events such as transaction updates.
The image above illustrates the process.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The address on which the transaction occurs; for EVM-based chains, this is the sender's address.
The transaction ID.
The type of the transaction; can be either 'native' or 'token'.
(Optional, subject to change; for Solana mainnet only) Risk levels assigned to the addresses.
The amount of the asset that was credited to (+) or debited from (-) the address.
The asset of the transaction: for token assets, this is the token address; for native blockchain assets, this is the name of the asset (e.g., SOL).
The block number; does not appear if the transaction is in the mempool (for EVM-based blockchains).
An optional counterparty address of the transaction; for EVM-based blockchains, this is the recipient's address.
(EVM-based blockchains only) If true, the transaction is in the mempool; if false or does not appear, the transaction has been added to a block.
(ERC-721 / ERC-1155 only) The ID of the transferred token.
Response
Indicates that the callback was processed successfully.