These webhooks are triggered when funds are sent from any of the addresses belonging to a Liminal Wallet. The structure of the send webhook contains several fields that provide information about the transaction.

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 the webhook dashboard, see View and manage your webhooks.

📘
Note

Currently, webhooks contain only the x-platform-signature header. Liminal has deprecated the x-liminal-signatureheader.

All outgoing webhooks are sent from the following officially listed static IP addresses, routed via our NAT Gateway. You can safely whitelist these in your firewall or allowlist configuration.

Environment IP Address AWS Region
Sandbox (Dev) 43.204.125.242 ap-south-1 (Mumbai)
Production 35.81.214.139 us-west-2 (Oregon)

Identifying webhooks that belong to outgoing (send) transactions

You can differentiate a send and receive webhook using the parameters–type. The parameter is described as follows:

type: This is the name of the event. For example, "send".

Differentiating between a native coin (eg. ETH, POL) transaction and a token transaction (eg. USDC,USDT)

You can differentiate a native coin webhook from token transaction webhook using the parameter–tokenContractAddress. This parameter will be an empty string "" in case of a native coin transaction and will contain the token contract address of the token in case of a token transaction.

Webhook Sample Payload

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

{
  "decimals": 9,
  "id": 159653923,
  "txid": "5vQvkDxaUQLqQRDw5YasbFGKMTp91YFz9eyCoJaMzk8bK6qi72mbJu9kqq5vzB1Hdvhva8aFLMJTUgrx6HEgYJD4",
  "raw": "",
  "walletid": 40727,
  "type": "send",
  "fee": "0.00000500",
  "effectivechange": "-0.05000000",
  "effectiveChangeBaseUnit": "-50000000",
  "feeBaseUnit": "5000",
  "runningbalance": null,
  "timestamp": "2026-02-23T11:02:59.000Z",
  "externaladdress": "3mfrivAcmPmRvoa4o6ihFMtp5YpK2EvzqTZEhyi8U8MY",
  "block": 444108039,
  "coin": "SOL",
  "effectivechangeusd": "-4.01300",
  "createdAt": "2026-02-23T11:08:37.000Z",
  "wallet": {
    "id": 40727,
    "name": "Solana Mobile",
    "type": "mpc",
    "config": "2of2",
    "balance": "5.94998000",
    "address": "8oqALrZMK28qYAqHdAiDcUDTEw2ELCtNpns8QPfMQk9u",
    "chain": "SOL",
    "subtype": "holding",
    "coin": "SOL",
    "orgid": 2188,
    "parentchain": "SOL",
    "isArchived": false,
    "balanceUSD": "477.54539480",
    "orgWebhook": "https://c70a5e1afdb0a586c53ae351815c8f6b.m.pipedream.net/"
  },
  "tokenContractAddress": "",
  "sequenceId": "dfecb960-66a9-af40-f1af-ce25b76f2673",
  "explorerLink": "https://explorer.solana.com/tx/5vQvkDxaUQLqQRDw5YasbFGKMTp91YFz9eyCoJaMzk8bK6qi72mbJu9kqq5vzB1Hdvhva8aFLMJTUgrx6HEgYJD4?cluster=devnet",
  "inputs": [
    {
      "address": "8oqALrZMK28qYAqHdAiDcUDTEw2ELCtNpns8QPfMQk9u",
      "amount": "0.00000000",
      "amountBaseUnit": "0",
      "isMine": true,
      "wallet": {
        "id": 40727,
        "name": "Solana Mobile",
        "type": "mpc",
        "config": "2of2",
        "status": 1,
        "balance": "5.94998000",
        "balanceusd": "477.54539480",
        "raw": null,
        "issynced": false,
        "walletpath": "m/44/501/2/40727",
        "walletidentifier": "8oqALrZMK28qYAqHdAiDcUDTEw2ELCtNpns8QPfMQk9u",
        "chain": "SOL",
        "subtype": "holding",
        "coin": "SOL",
        "orgid": 2188,
        "parentchain": "SOL",
        "canInitiatorSign": 0,
        "suspendedStatus": 0,
        "suspendedRemark": null,
        "isArchived": false,
        "teamId": null,
        "version": 2,
        "updatedAt": "2026-02-23T11:08:37.000Z",
        "account": null
      }
    }
  ],
  "outputs": [
    {
      "address": "3mfrivAcmPmRvoa4o6ihFMtp5YpK2EvzqTZEhyi8U8MY",
      "amount": "0.05000000",
      "amountBaseUnit": "50000000",
      "isMine": false
    }
  ],
  "blockConfirmation": 618,
  "transactionStatus": {
    "legacyStatus": 4,
    "primaryStatus": "success",
    "secondaryStatus": "completed"
  },
  "blockConfirmationData": {
    "periodicity": null,
    "block": 444108039,
    "numberOfConfirmations": 618
  },
  "txStatus": 1
}

Webhook Payload Parameters (Send transaction)

Refer to the table below for the webhook payload parameters:

📘
Note

We have sliced the decimal precision for specific fields in the webhook payload to ensure transaction amounts are interpreted reliably. This prevents precision errors and ensures consistent data processing. The following fields in the payload are sliced as follows:

effectivechange up to 8 decimals.

effectivechangeusd to 5 decimals.

fee to 8 decimals.

inputs[].amount and outputs[].amount up to 8 decimals.

Support for parameters in base units are applicable to EVM and UTXO chains only. Upcoming support includes Solana, Tron and Cardano chains.

The inputs[].walletidentifier parameter is supported in checksum format.

Support for parameters in base units are applicable to EVM and UTXO chains only. Upcoming support includes Solana, Tron and Cardano chains.

Object	Parameter	Data Type	Description	Example Value
	decimals	Integer	The number of decimal precision the asset/token supports.	9
	id	Integer	The unique identifier of the event.	1965382
	txid	String	The unique identifier of the transaction.	0x62eaf9706dac678d8daf672259c44a22e13c7f73b62c6240bd8b5719764d9ae8
	raw	String	Stores memo for the supported chains, else null	null
	walletId	int32	The unique identifier of the wallet.	2876
	type	String	The type of "send" or "receive" transaction. If its value is “internal”, ignore it, as it is an internally occurring webhook.	send
	`fee`	String (decimal, 8 places)	Transaction network fee, sliced to 8 decimals.	"0.00012432"
	`effectivechange`	String (decimal, 8 places)	Net transaction amount of coins or tokens received or sent, sliced to 8 decimals.	"10.00000000"
	`effectivechangeBaseUnit`	String	Effective change of the transaction in base units.	"50000000"
	`feeBaseUnit`	String	Fees of the transaction in base units.	"5000"
	`runningbalance`	String	The real-time updated total funds change after each transaction.	null
	`timestamp`	String	The date and time when the transaction was initiated.	2023-10-05T07:20:29.000Z
	`externaladdress`	String	For "receive" transaction, this represents the source address. For "send" transaction, this represents the target address.	0x505e71695e9bc45943c58adec1650577bca68fd9
	`block`	Integer	This is the block number/ height at which the transaction was included	56781943
	`coin`	String	The symbol of the asset "received" or "sent" in the transaction. It can be a coin or a token.	USDT
	`effectivechangeusd`	String (decimal, 5 places)	Net transaction amount (USD)of coins/ tokens received/ sent, sliced to 5 decimals	"10.00000"
wallet	`id`	int32	The unique identifier of the wallet.	2876
wallet	`name`	String	The name of the wallet.	Lightning Nodes Deposit POLYGON
wallet	`type`	String	The type of wallet.	pipeline
wallet	`config`	String	The minimum required signer configuration of the wallet.	2of2
wallet	`balance`	decimal(28,8)	The total balance of the wallet.	0.00000000
wallet	`address`	String	The unique address of the wallet.	0x6d3E8E04f8F178eF755627546aA84Fca4397B20b
wallet	`coin`	String	The native coin of the wallet chain.	MATIC
wallet	`chain`	String	The blockchain network of the wallet.	POLYGON
wallet	`parentchain`	String	The parent blockchain network of the chain where the wallet operates.	EVM
wallet	`subtype`	String	The sub type of the wallet from where the transaction is initiated.	deposit
wallet	`isArchived`	Boolean	This indicates whether the wallet is archived or not. "1" refers to true, whereas, "0" refers to false.	0
wallet	`orgid`	Integer	The unique identifier of the organisation.	864
wallet	`balanceUSD`	decimal(18,8)	The total balance of the wallet in USD.	0.00000000
wallet	`orgWebhook`	String	The webhook URL set up on the client side.	https://testnet-api.pi42.exchange/v1/liminal/webhook
	`tokenContractAddress`	String	The contract address of the token for which the transaction takes place.	0xc2132D05D31c914a87C6611C10748AEb04B58e8F
	`sequenceId`	String	The unique identifier of the transaction sequence. Sequence ID is associated with a send transaction.	93544241-c00e-c754-3bd0-494567a67ee8
	`explorerLink`	String	The 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
inputs[]	`address`	String	The wallet address from where the transaction is initiated.	0x505e71695e9bc45943c58adec1650577bca68fd9
inputs[]	`amount`	String (decimal, 8 places)	Amount from each input in the transaction, sliced to 8 decimals.	"10.00000000"
	`amountBaseUnit`	String	Amount of the asset transferred in base units,	"0"
inputs[]	`isMine`	Boolean	This indicates whether the source address belongs to the transaction initiator or not.	true
inputs > wallet	`walletidentifier`	String	The unique identifier of the wallet in blockchain.	TYDmpfsPdtEwdsMgnqRiy36WTDovZfcJjx
outputs[]	`address`	String	The wallet address where the transaction is received.	0x1963159d1f64538b5dc105d4498d248d615ae57c
outputs[]	`amount`	String (decimal, 8 places)	Amount from each output in the transaction, sliced to 8 decimals.	"10.00000000"
	`amountBaseUnit`	String	Amount of the asset transferred in base units.	“50000000”
outputs[]	`isMine`	Boolean	This indicates whether the destination address belongs to the transaction initiator or not.	true
outputs > wallet	`id`	int32	The unique identifier of the destination wallet.	2876
outputs > wallet	`name`	String	The name of the destination wallet.	Lightning Nodes Deposit POLYGON
outputs > wallet	`type`	String	The type of the destination wallet.	pipeline
outputs > wallet	`config`	String	The minimum required signer configuration of the destination wallet.	2of2
outputs > wallet	`status`	String	The current status of the wallet. The value "1" represents active, "0" represents inactive, and "-1" represents the pending status.	1
outputs > wallet	`balance`	decimal(28,8)	The total balance of the destination wallet.	0.00000000
outputs > wallet	`balanceusd`	String	The total balance of the wallet in USD.	2.13649785
outputs > wallet	`raw`	String	The memo for the supported chains, else null.	null
outputs > wallet	`issynced`	Boolean		true
outputs > wallet	`walletpath`	String	The path number of the wallet.	null
outputs > wallet	`coin`	String	The type of cryptocurrency held in the destination wallet.	MATIC
outputs > wallet	`chain`	String	The type of blockchain network associated with the destination wallet.	POLYGON
outputs > wallet	`parentchain`	String	The parent blockchain of the chain where the destination wallet operates.	EVM
outputs > wallet	`subtype`	String	The sub type of the destination wallet.	deposit
outputs > wallet	`isArchived`	Boolean	This indicates whether the destination wallet is archived or not.	0
outputs > wallet	`teamId`	String	The unique identifier of the team associated with the wallet.	null
outputs > wallet	`version`	Integer	The version of the wallet.	1
outputs > wallet	`orgid`	Integer	The unique identifier of the organisation.	864
	`blockConfirmation`	Number	The difference between the latest block (at the time of processing the transaction) and the block number in which the transaction was included.	5
transactionStatus	`legacyStatus`	Number	The legacy status of the transaction in number that is retrieved via old transaction status API	1
transactionStatus	`primaryStatus`	String	This is the broader stage of the transaction.	pending
transactionStatus	`secondaryStatus`	String	The specific stage of the transaction	awaiting_finalisation
blockConfirmationData	`periodicity`	number \| null	number of block confirmations at which the periodic webhook was triggered. This value is null when the transaction is finalised on-chain and completed.	1 \| null
blockConfirmationData	`numberOfConfirmations`	number	The number of confirmations on the blockchain that have passed since this transaction was first confirmed	1
blockConfirmationData	`block`	number	This is the block number/ height at which the transaction was included	844391
txStatus	`txStatus`	number	Can be 0 or 1 0 - Transaction is unfinalised 1- Transaction is fully confirmed/finalised	1

Failed Webhook Behavior

Transactions that fail on-chain for Send transactions have the following behavior for Solana and Tron chains:

Failed Solana Transactions

Failed Solana Transactions

When a Solana send transaction fails on-chain: It has the following transactionStatus object in the webhook payload response:
```
"transactionStatus": {
    "legacyStatus": 5,
    "primaryStatus": "failed",
    "secondaryStatus": "failed_on_chain"
  },
```
The following parameters have an updated value as below:

“effectivechange”: “0.00000000”,
“effectivechangeusd”: “0.00000”,
"inputs[].amount”: “0.00000000”, and
“outputs[].amount”: “0.00000000”.

Failed Tron Transactions

Tron transactions that fail on-chain have the following transactionStatus object in the webhook payload:

"transactionStatus": {
    "legacyStatus": 5,
    "primaryStatus": "failed",
    "secondaryStatus": "failed_on_chain"
  },

You can verify the failed Tron transaction in History.