Skip to main content
POST
/
your-callback-endpoint
cURL
curl --request POST \
  --url https://dash.betteruseblockchain.com/your-callback-endpoint \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "address": "FykfMwA9WNShzPJbbb9DNXsfgDgS3XZzWiFgrVXfWoPJ",
  "txId": "2rdy3YCZHSwvpWtuDom1d4Jjy5UU9STLxF3ffXau6GToReDkfw8wEgX541fvzvh6btVC5D8iNapcKTXfPsoDBk7A",
  "blockNumber": 110827114,
  "asset": "3gUeeR3BfVhukYJMwtHownRtRkGcf1bvwiV8TbKMZBVz",
  "amount": "1",
  "tokenId": "1",
  "type": "token",
  "mempool": true,
  "counterAddress": "vTEfAhXTmvgFmepgfhzBbRrJ4EtUP9adbMJjpzLsDMk",
  "addressesRiskRatio": [
    {
      "vTEfAhXTmvgFmepgfhzBbRrJ4EtUP9adbMJjpzLsDMk": 0
    },
    {
      "zBbRrJ4EtUP9adbMJjpzLsDMkvTEfAhXTmvgFmepgfh": 100
    }
  ]
}'
{
  "status": "success"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

The payload of the webhook notification sent to your callback endpoint.

​
address
string
required

The address on which the transaction occurs; for EVM-based chains, this is the sender's address.

​
txId
string
required

The transaction ID.

​
type
string
required

The type of the transaction; can be either 'native' or 'token'.

​
blockNumber
integer

The block number; does not appear if the transaction is in the mempool (for EVM-based blockchains).

​
asset
string

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).

​
amount
string

The amount of the asset that was credited to (+) or debited from (-) the address.

​
tokenId
string

(ERC-721 / ERC-1155 only) The ID of the transferred token.

​
mempool
boolean

(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.

​
counterAddress
string

An optional counterparty address of the transaction; for EVM-based blockchains, this is the recipient's address.

​
addressesRiskRatio
object[]

(Optional, subject to change; for Solana mainnet only) Risk levels assigned to the addresses.

Response

The callback was received and processed successfully.

​
status
string

Indicates that the callback was processed successfully.

Example:

"success"

⌘I