Send webhook requests

The structure of a Send webhook request contains several fields that provide information about the transaction.

Identification

You can identify a webhook request using the parameters–type, coin/token. These parameters are described as follows:

  • type: This is the name of the event. For example, "Send".
  • coin: This is the type of native coin transaction. This field isn’t populated if this event is of a token transaction, such as ERC20 assets like USDT. An example of coin is "eth".
  • token: This is the name of the token involved in the transaction. If coins are involved in the transaction, then this field isn’t populated. This field isn’t populated if the event is of a native coin transaction, such as "eth". An example of token is "UNI".

Note: In a webhook response, when tokens are transmitted, the parameter tokenContractAddress is populated.

The following is a sample payload of the "Send" webhook request.

{
  "id": 1917889,
  "txid": "936ad03ff2229b16f6689dfdcdd9e6327f9a8ea7be0bfb95cce51ff13e486584",
  "raw": null,
  "walletid": 2570,
  "type": "send",
  "fee": "0.00000000",
  "effectivechange": "7.00000000",
  "runningbalance": null,
  "timestamp": "2023-09-12T13:47:04.000Z",
  "externaladdress": "TKsWjWy7bsaZhsqMcLKY3N3hP1koBmgsGd",
  "coin": "TRX",
  "effectivechangeusd": "0.55391",
  "wallet": {
    "id": 2570,
    "name": "Sample deposit",
    "type": "pipeline",
    "config": "2of2",
    "balance": "27.00000000",
    "address": "TYDmpfsPdtEwdsMgnqRiy36WTDovZfcJjx",
    "coin": "TRX",
    "chain": "TRON",
    "parentchain": "TRON",
    "subtype": "deposit",
    "isArchived": 0,
    "orgid": 854,
    "balanceUSD": "2.13649785",
    "orgWebhook": "https://api-qa.bitdelta.com/api/v1/hooks/lml-hook"
  },
  "tokenContractAddress": "",
  "sequenceId": "",
  "explorerLink": "https://tronscan.org/#/transaction/936ad03ff2229b16f6689dfdcdd9e6327f9a8ea7be0bfb95cce51ff13e486584",
  "inputs": [
    {
      "address": "TKsWjWy7bsaZhsqMcLKY3N3hP1koBmgsGd",
      "amount": "0.00000000",
      "isMine": false
    }
  ],
  "outputs": [
    {
      "address": "TBfsbAHE9CVL8XiNwL9w2R14RjivoFudGo",
      "amount": "7.00000000",
      "isMine": true,
      "wallet": {
        "id": 2570,
        "name": "Bitdelta Deposit TRON",
        "type": "pipeline",
        "config": "2of2",
        "status": 1,
        "balance": "27.00000000",
        "balanceusd": "2.13649785",
        "raw": null,
        "issynced": true,
        "walletpath": null,
        "walletidentifier": "TYDmpfsPdtEwdsMgnqRiy36WTDovZfcJjx",
        "coin": "TRX",
        "chain": "TRON",
        "parentchain": "TRON",
        "subtype": "deposit",
        "isArchived": false,
        "teamId": null,
        "version": 1,
        "orgid": 854
      }
    }
  ]
}

ObjectParameterData typeDescriptionExample value
idIntegerUnique identifier of the event1965382
txidStringUnique identifier of the transaction0x62eaf9706dac678d8daf672259c44a22e13c7f73b62c6240bd8b5719764d9ae8
rawStringStores memo for the supported chains, else nullnull
walletIdint32Unique identifier of the wallet2876
typeStringThis is a type of send or receive transaction. If its value is “internal”, you can ignore it, as it is an internally occurring webhook.send, receive, internal
feeStringFee associated with the transaction0.00824932
effectivechangedecimal(28,8)Number of coins or tokens4.00000000
timestampStringDate and time when the transaction was initiated2023-10-05T07:20:29.000Z
externaladdressStringIn case of a receive transaction, this represents the source address.
In case of a send transaction, this represents the target address.
0x505e71695e9bc45943c58adec1650577bca68fd9
coinStringType of cryptocurrency involved in the transactionUSDT
effectivechangeusddecimal(18,5)Amount in the USD4.00000
walletidint32Unique identifier of the wallet2876
walletnameStringName of the walletLightning Nodes Deposit POLYGON
wallettypeStringType of walletpipeline
walletconfigStringConfiguration of the wallet2of2
walletbalancedecimal(28,8)Total balance of the wallet0.00000000
walletaddressStringUnique address of the wallet0x6d3E8E04f8F178eF755627546aA84Fca4397B20b
walletcoinStringNative coin of the wallet chainMATIC
walletchainStringBlockchain network of the walletPOLYGON
walletparentchainStringParent blockchain network of the chain where the wallet operatesEVM
walletsubtypeStringSubtype of the wallet from where the transaction is initiateddeposit
walletisArchivedBooleanThis indicates whether the wallet is archived or not. "1" refers to true, whereas, "0" refers to false.0
walletorgidIntegerUnique identifier of the exchange organization that was created in Admin Panel864
walletbalanceUSDdecimal(18,8)Total balance of the wallet in USD0.00000000
walletorgWebhookStringWebhook URL setup on client sidehttps://testnet-api.pi42.exchange/v1/liminal/webhook
tokenContractAddressStringThe contract address of the token for which the transaction takes place.0xc2132D05D31c914a87C6611C10748AEb04B58e8F
sequenceIdStringThis is the unique identifier of the transaction sequence. Sequence ID is associated with a send transaction.93544241-c00e-c754-3bd0-494567a67ee8
explorerLinkStringThis is a URL of a web-based tool that allows users to view and search blockchain transactions, blocks, addresses, and other relevant information.https://polygonscan.com/tx/0x62eaf9706dac678d8daf672259c44a22e13c7f73b62c6240bd8b5719764d9ae8
inputsaddressStringWallet address from where the transaction is initiated0x505e71695e9bc45943c58adec1650577bca68fd9
inputsamountIntegerTotal amount of the transaction0.00000000
inputsisMineBooleanIndicates whether the source address belongs to the transaction initiator or nottrue
outputsaddressStringWallet address where the transaction is received0x1963159d1f64538b5dc105d4498d248d615ae57c
outputsamountIntegeramount of cryptocurrency received at the output address4.00000000
outputsisMineBooleanIndicates whether the destination address belongs to the user or nottrue
outputs > walletsidint32Unique identifier of the destination wallet2876
outputs > walletsnameStringName of the destination walletLightning Nodes Deposit POLYGON
outputs > walletstypeStringType of the destination walletpipeline
outputs > walletsconfigStringConfiguration of the destination wallet2of2
outputs > walletsbalancedecimal(28,8)Total balance of the destination wallet0.00000000
outputs > walletsaddressStringBlockchain address to which the transaction is sent0x6d3E8E04f8F178eF755627546aA84Fca4397B20b
outputs > walletscoinStringType of cryptocurrency held in the destination walletMATIC
outputs > walletschainStringType of blockchain network associated with the walletPOLYGON
outputs > walletsparentchainStringParent blockchain of the chain where the destination wallet operatesEVM
outputs > walletssubtypeStringSubtype of the destination walletdeposit
outputs > walletsisArchivedBooleanIndicates whether the destination wallet is archived or not0
outputs > walletsorgidIntegerUnique identifier of the exchange organization which is created in Admin Panel864
outputs > walletsbalanceUSDdecimal(18,8)Total balance of the destination wallet in USD0.00000000
outputs > walletsorgwebhookStringWebhook URL setup on client sidehttps://testnet-api.pi42.exchange/v1/liminal/webhook

You can view webhook status code, request and response body, and other details in the webhook dashboard within Vaults, as shown below. To learn more about webhook dashboard, see View and manage your webhooks.