Ctrl+K

Get list of potentially stuck transactions across multiple wallets.

get/api/v2/wallet/{walletId}/potentialStuckTxs

This endpoint aggregates stuck transactions from a wallet and its EVM keyring derived wallets (if applicable).

Use cases:

  • EVM keyring parent wallet: Returns stuck txs from parent + all derived wallets (ETH, BSC, Polygon, etc.)
  • Non-keyring wallet: Returns stuck txs from that single wallet only

The response includes both successful results and any errors encountered while querying individual wallets, allowing clients to handle partial failures gracefully.

Path Parameters

  • walletIdstringRequired
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$
    Min length: >= 1 characters

Query Parameters

  • expandSendTransferMetadatabooleanDefault: false
    True, if expanding the send transfer for each stuck transaction if one is available.
  • txidstring
    The transaction ID of the stuck transaction.

200 Response

stuckTxsrequired
nonce number
The nonce value of the potentially stuck transaction
Example: 200000
txHex string
Serialized transaction hex
Example: 01000000000101d58f82d996dd872012675adadf4606734906b25a413f6e2ee535c0c10aef96020000000000ffffffff028de888000000000017a914c91aa24f65827eecec775037d886f2952b73cbe48740420f000000000017a9149304d18497b9bfe9532778a0f06d9fff3b3befaf870500473044022023d7210ba6d8bbd7a28b8af226f40f7235caab79156f93f9c9969fc459ea7f73022050fbdca788fba3de686b66b3501853695ff9d6f375867470207d233b099576e001000069522103d4788cda52f91c1f6c82eb91491ca76108c9c5f0839bc4f02eccc55fedb3311c210391bcef9dcc89570a79ba3c7514e65cd48e766a8868eca2769fa9242fdcc796662102ef3c5ebac4b54df70dea1bb2655126368be10ca0462382fcb730e55cddd2dd6a53aec8b11400
txId string
The on-chain transaction id
Example: b8a828b98dbf32d9fd1875cbace9640ceb8c82626716b4a64203fdc79bb46d26
txType string
The transaction type
Example: AddressInitialization
sendTransfer object
cause string required
The reason the transaction is potentially stuck
message string required
Possible steps to remediate the stuck transaction.
transferIds array[string]
gasAccelerationFee object
Fee required to remediate a stuck transaction when the cause is 'fee acceleration'.
userActionDisabled boolean
True, if manual user action is disabled on this stuck transaction
coin string
The coin name for the stuck transaction
Example: hteth
errors array[object] required
Array of errors encountered while querying individual wallets (if any)
walletId string required
The wallet ID that failed
Example: 59cd72485007a239fb00282ed480da1f
coin string required
The coin/chain of the wallet that failed
Example: tbsc
code string required
Error code
message string required
Human-readable error message

400 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

404 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id