These webhooks are triggered when funds are received in any of the addresses belonging to a Liminal Wallet.

The structure of the receive webhook contains several fields that provide information about the transaction.

Identifying webhooks that belong to incoming (Receive) 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, "receive".

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.

Differentiating between a completed webhook and periodic webhook

The transactionStatus and blockConfirmationData objects have been newly added to the webhook response.

For periodic webhooks, the periodicity field in the blockConfirmationData will not be null. For detailed information on Periodic Webhooks read the complete guide.

"transactionStatus": {
    "legacyStatus": 4,
    "primaryStatus": "success",
    "secondaryStatus": "completed"
  },
"blockConfirmationData": {
    "periodicity": null,
    "block": 8863651,
    "numberOfConfirmations": 24
  },

📘
Note

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

Sample Payload

The following is a sample payload of the Receive webhook.

{
  "decimals": 6,
  "id": 159656417,
  "txid": "3A9n5NjL9cjfqxoTzmPQEnj4bT9hbyGvBurp6wdQcTCLwFWe19LoehjvzPSbLwqY4xLCEjVMAEk8Azn6Qespihqs",
  "raw": "",
  "walletid": 40727,
  "type": "receive",
  "fee": "0.00001397",
  "effectivechange": "20.00000000",
  "effectiveChangeBaseUnit": "20000000",
  "feeBaseUnit": "13970",
  "runningbalance": null,
  "timestamp": "2026-02-27T08:52:17.000Z",
  "externaladdress": "H3sjyipQtXAJkvWNkXhDgped7k323kAba8QMwCLcV79w",
  "block": 444988027,
  "coin": "USDC",
  "effectivechangeusd": "19.99720",
  "createdAt": "2026-02-27T09:00:00.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": "520.74224960",
    "orgWebhook": "https://c70a5e1afdb0a586c53ae351815c8f6b.m.pipedream.net/"
  },
  "tokenContractAddress": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
  "sequenceId": "",
  "explorerLink": "https://explorer.solana.com/tx/3A9n5NjL9cjfqxoTzmPQEnj4bT9hbyGvBurp6wdQcTCLwFWe19LoehjvzPSbLwqY4xLCEjVMAEk8Azn6Qespihqs?cluster=devnet",
  "inputs": [
    {
      "address": "H3sjyipQtXAJkvWNkXhDgped7k323kAba8QMwCLcV79w",
      "amount": "0.00000000",
      "amountBaseUnit": "0",
      "isMine": false
    }
  ],
  "outputs": [
    {
      "address": "8oqALrZMK28qYAqHdAiDcUDTEw2ELCtNpns8QPfMQk9u",
      "amount": "20.00000000",
      "amountBaseUnit": "20000000",
      "isMine": true,
      "wallet": {
        "id": 40727,
        "name": "Solana Mobile",
        "type": "mpc",
        "config": "2of2",
        "status": 1,
        "balance": "5.94998000",
        "balanceusd": "520.74224960",
        "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-27T08:59:05.000Z",
        "account": null
      }
    }
  ],
  "blockConfirmation": 785,
  "transactionStatus": {
    "legacyStatus": 4,
    "primaryStatus": "success",
    "secondaryStatus": "completed"
  },
  "blockConfirmationData": {
    "periodicity": null,
    "block": 444988027,
    "numberOfConfirmations": 785
  },
  "txStatus": 1
}

Webhook Payload Parameters (Receive transactions)

Refer to the table below for the webhook payload parameters:

📘
Note

Before receiving batch token transactions from smart contracts into your deposit hot wallets, ensure to whitelist smart contract addresses. To learn more, see Whitelist smart contract addresses for deposit wallets.

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.

Failed on-chain transactions for Solana and Tron chains do not support a webhook response.

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 or the transaction hash.	0x62eaf9706dac678d8daf672259c44a22e13c7f73b62c6240bd8b5719764d9ae8
	`raw`	String	The 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.	receive
	`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 a "receive" transaction, this represents the source address. For a "send" transaction, this represents the target address.	0x505e71695e9bc45943c58adec1650577bca68fd9
	`block`	integer	This is the block number/ height at which the transaction was included	765544
	`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.07000000
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 setup on the client side.	https://testnet-api.pi42.exchange/v1/liminal/webhook
	`tokenContractAddress`	String	The contract address of the token for which the transaction has taken place.	0xc2132D05D31c914a87C6611C10748AEb04B58e8F
	`sequenceId`	String	The unique identifier (ID) of the transaction sequence. A sequence ID is generated only for a "send" transaction.	93544241-c00e-c754-3bd0-494567a67ee8
	`explorerLink`	String	The URL of a web-based tool that allows 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
`outputs[]`	`address`	String	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	`balance`	decimal(28,8)	The total balance of the destination wallet.	0.00000000
outputs > wallet	`address`	String	The blockchain address to which the transaction is sent.	0x6d3E8E04f8F178eF755627546aA84Fca4397B20b
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 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	`orgid`	Integer	The unique identifier of the exchange organisation.	864
outputs > wallet	`balanceUSD`	decimal(18,8)	Total balance of the destination wallet in USD.	0.00000000
outputs > wallet	`orgwebhook`	String	The webhook URL setup on the client side.	https://testnet-api.pi42.exchange/v1/liminal/webhook
	`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`	number	Can be 0 or 1. 0- Transaction is not fully confirmed/ finalised 1 - Transaction is finalised	1

📘
Note

Before receiving batch token transactions from smart contracts into your deposit hot wallets, ensure to whitelist smart contract addresses. To learn more, see Whitelist smart contract addresses for deposit wallets.

We standardize the decimal precision for specific fields in the webhook payload to ensure all systems reliably interpret transaction amounts. 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.

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

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.