Speed Up Transfer

Edit online

The Speed Up Transfer endpoint creates a replacement transaction with the same parameters as an existing transfer, but with higher gas fees. This increases the likelihood that the transaction will be confirmed more quickly.

This endpoint works only for:
  • EVM-compatible networks such as Ethereum, Polygon, and BSC.
  • Transfers that are in Broadcasted status, which means they have been submitted to the blockchain but not yet confirmed
How the cancellation works?
The speed-up process:
  1. Extracts the parameters from the original broadcasted transaction.
  2. Creates a new transaction with the same nonce, recipient, value, and data.
  3. Applies a higher gas fee. The gas fee is set to the higher value between a 10 percent increase or the network's current Fast fee rate.
  4. Submits the new transaction to replace the original entry in the mempool.
Note: A successful speed-up depends on network conditions. If the original transaction has already been mined, the replacement transaction will not take effect.
HTTP request
POST/wallets/{walletId}/transfers/{transferId}/speed-up
Authorization requirements
Header Type Required Description
Authorization string Yes Bearer token used to authenticate the request. See Authentication flows for instructions on generating this token.
X-DFNS-USERACTION string Yes User action signature used to authorize change-inducing requests. See User Action Signing flows for instructions on generating this signature.
Path parameter
Parameter Type Required Description
walletId string Yes ID of the wallet. Length: 1 to 64.
transferId string Yes ID of the transfer to cancel. Length: 1 to 64.
Request body
curl --request POST \
  --url https://api.digitalassets.ibm.com/wallets/{walletId}/transfers/{transferId}/speed-up \
  --header 'Authorization: Bearer <token>' \
  --header 'X-DFNS-USERACTION: <api-key>'
Response
200: Success

Example response:

{
  "id": "tx-583hu-sp2p7-slvb9nqpa3hd8bus",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "network": "Algorand",
  "requester": {
    "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
    "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
  },
  "requestBody": {
    "kind": "Transaction",
    "transaction": "<string>",
    "externalId": "<string>"
  },
  "status": "Pending",
  "dateRequested": "2023-04-14T20:41:28.715Z",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "approvalId": "ap-2a9in-tt2a1-983lho480p35ejd0",
  "datePolicyResolved": "2023-04-14T20:41:28.715Z",
  "dateBroadcasted": "2023-04-14T20:41:28.715Z",
  "dateConfirmed": "2023-04-14T20:41:28.715Z",
  "externalId": "<string>"
}