Ctrl+K

Get list of potentially stuck transactions and their nonces for eth-like coins

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

Gets a list of potentially problematic transactions, their nonces, the reason they are stuck, and possible solutions for a given wallet.

Path Parameters

  • walletIdstringRequired
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$
    Min length: >= 1 characters
  • coinstringRequired
    A cryptocurrency symbol or token ticker symbol
    Example: btc
    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

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
abandonedTime string <date-time>
The time this transfer was abandoned
approvedTime string <date-time>
The time this transfer was approved
baseValue number
The value (in base units) sent by this transfer, excluding network fees. BitGo is deprecating this field in the future.
baseValueString string
The value (in base units) sent by this transfer, excluding network fees represented as a string. BitGo is deprecating this field in the future.
Example: 2000000
Match pattern: ^-?\d+$
baseValueWithoutFees number
The value (in base units) sent by this transfer excluding network fees.
baseValueWithoutFeesString string
The value (in base units) sent by this transfer, excluding network fees, represented as a string
bitgoOrg string
Allowed values: BitGo Trust BitGo New York BitGo Germany BitGo Switzerland BitGo Europe ApS Frankfurt DE Trust BitGo Singapore BitGo Korea BitGo Custody MENA FZE BitGo India BitGo Sister Trust 1 BitGo Inc
buildParams dictionary<string, any>
Parameters used to build the transaction
coin string required
A cryptocurrency symbol or token ticker symbol
Example: btc
coinSpecific
comment
string or null
A comment from the user
commentedTime string <date-time>
The time this transfer was commented on
confirmations number
The number of blocks that have been confirmed since this Transfer's block was confirmed
confirmedTime string <date-time>
The time this transfer was confirmed
consolidateId string
Consolidation ID if this transfer is part of a consolidation
createdTime string <date-time>
The time this transfer was created
customerApprovedTime string <date-time>
The time this transfer was approved by the customer (trust transfers)
date string <date-time>required
The date this Transfer was last updated
elliptic string
Elliptic risk score information (trust transfers)
enterprise string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
enterpriseName string
Name of the enterprise associated with this transfer
entries array[object] required
An array of objects describing the change in address balances made as a result of this Transfer
failedTime string <date-time>
The time this transfer failed
feeCoin string
The coin used to pay the fee (for cross-chain transactions)
feeString string
The Transfer's fee (in base units) represented as a String
feeUsd number
The fee USD value for token transfers
feeUsdRate number
The fee coin USD rate for token transfers
goStakingRequestId string
Associated GO staking request ID
height number
The height of the block this Transfer was confirmed in (999999999 if unconfirmed)
heightId string
The unique height id of the block
history array[object] required
An audit log of events that have happened to the Transfer during its lifecycle
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
idVerificationTime string <date-time>
The time identity verification was completed (trust transfers)
inputs array[object]
instant boolean
Whether this is an instant transaction
instantId string
The instant transaction ID if applicable
intendedValueString string
A string representation (in base units) of the initial value for the transfer. This is present because when a transaction fails on chain, its value is mutated to be zero. This string is immutable and will always be the intended value of the initial transfer regardless of the final state of the transaction.
isFee boolean
Whether this transfer represents a fee
isReward boolean
Whether this transfer represents a staking reward
isUnlock boolean
Whether this transfer represents an unlock operation
label string
Address labels (if any) from entries concatenated.
medianUsdRate number
The median USD rate at the time this Transfer was created
medianUsdValue number
The median USD value of this Transfer
metadata array[object]
Additional metadata associated with the transfer
nSegwitInputs number
DEPRECATED. Number of segwit inputs on the transfer.
organization string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
outputs array[object]
payGoFee number
The Transfer's BitGo fee (in base units)
payGoFeeString string
The Transfer's BitGo fee (in base units) represented as a String
pendingApproval string
regeneratedTime string <date-time>
The time this transfer was regenerated
rejectedTime string <date-time>
The time this transfer was rejected
removedTime string <date-time>
The time this transfer was removed
replacedBy array[string]
Transaction IDs that replace this transfer.
replacedTime string <date-time>
The time this transfer was replaced
replaces array[string]
Transaction IDs that this transfer replaces.
replacingTime string <date-time>
The time this transfer started replacing another
sendAccounting array[object]
Accounting breakdown for send transactions
senderInformationVerified boolean
Whether sender information has been verified (trust transfers)
sequenceId string
Unique wallet identifier for preventing double-spends
signedDate string <date-time>
The date this transfer was signed (legacy field)
signedTime string <date-time>
The time this transfer was signed
stakingParams object
state string required
The state of the transfer. Includes the following: - `confirmed`: The transfer is confirmed on chain. - `failed`: BitGo failed to confirm the transfer on chain. You must retry the transaction. - `initialized`: The initial state when creating a transfer. - `pendingApproval`: The transfer requires admin approval to proceed. - `rejected`: The transfer was rejected by an admin. - `removed`: A network re-org occurred, causing the confirmed transfer to be removed from the blockchain. - `replaced`: The transfer was stuck due to having a low fee and was replaced by a new transfer with a higher fee. - `signed`: The transfer was approved by an admin (if required) and then signed by BitGo. - `unconfirmed`: The signed transaction was sent to the network, and is pending on-chain validation.
Allowed values: initialized pendingApproval rejected signed unconfirmed confirmed removed failed replaced deleted
subType string
Transfer subtype
Allowed values: ofc_deposit ofc_withdrawal ofc_book_transfer ofc_exchange ofc_bn_settlement_transfer ofc_bn_allocation ofc_trading_order ofc_trading_settlement ofc_margin_collateral ofc_margin_position ofc_direct_trade ofc_routed ofc_fee ofc_other ofc_unstake receive_from_gastank reserved_amount utxo_message_signing pending_deposit staking_eth_withdrawal staking_eth_partial_withdrawal staking_eth_full_withdrawal staking_eth_mev_reward staking_eth_block_reward staking_bera_withdrawal staking_bera_block_reward
tags array[string]
The tags to be used on this Transfer (used in Policies)
trustFinalApprovalTime string <date-time>
The time this transfer received final trust approval (trust transfers)
trustSignedTime string <date-time>
The time this transfer was signed by trust (trust transfers)
txid string
The on-chain transaction id
Example: b8a828b98dbf32d9fd1875cbace9640ceb8c82626716b4a64203fdc79bb46d26
txidType string
The type of the transaction id
txRequestId string
Associated transaction request ID
type string required
Defines whether or not this Transfer was sent or received by the user
Allowed values: send receive
unconfirmedTime string <date-time>
The time this transfer became unconfirmed
usd number
The amount of USD of this Transfer (will be negative if it's a send)
usdRate number
The USD rate at the time this Transfer was created
usersNotified boolean
Whether BitGo already sent notifications to the users of the transfer wallet
value number
The total value (in base units) sent by this Transfer (may be approximate for ETH and other coins where amounts in base units can exceed 2^53 - 1)
valueString string required
The total value (in base units) sent by this Transfer represented as a String
Example: 2000000
Match pattern: ^-?\d+$
vSize number
The size of the transaction
wallet string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
walletLabel string
Label of the wallet associated with this transfer
walletType string
Wallet type
Allowed values: backing cold custodial custodialPaired hot advanced trading
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'.
gasPrice string
Example: 200000
Match pattern: ^-?\d+$
maxFeePerGas string
Example: 200000
Match pattern: ^-?\d+$
maxPriorityFeePerGas string
Example: 200000
Match pattern: ^-?\d+$
userActionDisabled boolean
True, if manual user action is disabled on this stuck transaction
coin string
The coin name for the stuck transaction
Example: hteth

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