Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt

Use this file to discover all available pages before exploring further.

Transaction alert events notify you when Fireblocks detects conditions that may require intervention, such as transactions that have stalled due to fee-related issues. Use these events to build automated monitoring and remediation workflows.

​
transaction.alert.stuck_confirming

Triggered when one or more transactions from a vault account and base asset are stuck in the CONFIRMING status on EVM blockchains, indicating potential fee-related issues that may block subsequent transactions.
Beta This event is part of the Account Traffic Control (ATC) feature and is subject to change. To enable ATC, go to Fireblocks Labs.

​
Data fields

FieldTypeDescription
issueTypestringThe type of issue detected. Possible values: LOW_FEE_TRANSACTION_DETECTED
severitystringAlert severity level. Possible values: WARNING, CRITICAL
descriptionstringHuman-readable description of the issue.
vaultAccountIdstringThe ID of the affected vault account.
baseAssetstringThe base asset of the affected wallet (e.g., ETH).
recommendedActionobjectThe recommended action to resolve the issue. See Recommended action object.
stuckAccountDetailsobjectDetails about the stuck account state. See Stuck account details object.
FieldTypeDescription
actionstringThe action type. Possible values: BOOST_TRANSACTION
descriptionstringHuman-readable description of the recommended action.
stuckTxIdstringThe Fireblocks transaction ID of the oldest stuck transaction to boost.

​
Stuck account details object

FieldTypeDescription
blockedTransactionCountintegerNumber of transactions currently stuck or blocked by the stuck transaction.
lastCompletedNonceintegerThe last nonce that completed successfully for this account.
blocksElapsedintegerNumber of blocks elapsed since the transaction became stuck.
stuckDurationSecondsintegerNumber of seconds the transaction has been stuck.

​
Example payload

{
  "id": "39067fb9-5212-48e1-9e60-8ff1b326fdce",
  "resourceId": "9074940b-1ef7-4313-b8c0-cb8958ba945c",
  "webhookId": "072422fd-981f-496f-a926-7b506e4f0588",
  "workspaceId": "97535494-a9ff-564c-af19-6946c40ce39b",
  "eventType": "transaction.alert.stuck_confirming",
  "createdAt": 1777241007613,
  "data": {
    "issueType": "LOW_FEE_TRANSACTION_DETECTED",
    "severity": "WARNING",
    "description": "2 transactions stuck in CONFIRMING",
    "vaultAccountId": "0",
    "baseAsset": "ETH_TEST5",
    "recommendedAction": {
      "action": "BOOST_TRANSACTION",
      "description": "Speed up the oldest stuck transaction by replacing it with a higher fee.",
      "stuckTxId": "9074940b-1ef7-4313-b8c0-cb8958ba945c"
    },
    "stuckAccountDetails": {
      "blockedTransactionCount": 2,
      "lastCompletedNonce": 24,
      "blocksElapsed": 15,
      "stuckDurationSeconds": 175
    }
  }
}