Drop transaction

import requests

url = "https://api.example.com/api/v1/wallets/{wallet_uuid}/transactions/{transaction_uuid}/drop"

payload = {
    "request_id": "<string>",
    "fee": {
        "max_fee_per_gas": "<string>",
        "max_priority_fee_per_gas": "<string>",
        "token_id": "<string>",
        "fee_type": "EVM_EIP_1559",
        "gas_limit": "<string>"
    },
    "cobo_transaction_id": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.example.com/api/v1/wallets/{wallet_uuid}/transactions/{transaction_uuid}/drop \
  --header 'Content-Type: application/json' \
  --data '
{
  "request_id": "<string>",
  "fee": {
    "max_fee_per_gas": "<string>",
    "max_priority_fee_per_gas": "<string>",
    "token_id": "<string>",
    "fee_type": "EVM_EIP_1559",
    "gas_limit": "<string>"
  },
  "cobo_transaction_id": "<string>"
}
'

{
  "result": {
    "transaction_id": "<string>",
    "status": "<string>"
  },
  "success": true,
  "suggestion": "",
  "message": "",
  "meta": {
    "total": 123,
    "offset": 123,
    "limit": 123,
    "has_more": true,
    "after": "<string>",
    "before": "<string>"
  }
}

{
  "success": false,
  "error": {
    "detail": [
      {
        "loc": [
          "<string>"
        ],
        "msg": "<string>",
        "type": "<string>",
        "input": "<unknown>",
        "ctx": {}
      }
    ]
  }
}

Transactions

Drop transaction

This operation cancels or drops a pending transaction.

The behavior depends on the current transaction status:

submitted, pending_screening, pending_authorization, pending_signature: the transaction is cancelled directly (no fee required).
broadcasting: the transaction is replaced via RBF (Replace-By-Fee). You must supply the fee field in the request body.

Provide cobo_transaction_id in the request body to identify the transaction by its provider-assigned ID instead of the local UUID in the path.

A transaction can only be dropped before it reaches success or failed status. RBF drop is not supported on VET, TRON, TVET, SOL, TON chains or gasless (paymaster) transactions.

POST

api

wallets

{wallet_uuid}

transactions

{transaction_uuid}

drop

Drop transaction

import requests

url = "https://api.example.com/api/v1/wallets/{wallet_uuid}/transactions/{transaction_uuid}/drop"

payload = {
    "request_id": "<string>",
    "fee": {
        "max_fee_per_gas": "<string>",
        "max_priority_fee_per_gas": "<string>",
        "token_id": "<string>",
        "fee_type": "EVM_EIP_1559",
        "gas_limit": "<string>"
    },
    "cobo_transaction_id": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.example.com/api/v1/wallets/{wallet_uuid}/transactions/{transaction_uuid}/drop \
  --header 'Content-Type: application/json' \
  --data '
{
  "request_id": "<string>",
  "fee": {
    "max_fee_per_gas": "<string>",
    "max_priority_fee_per_gas": "<string>",
    "token_id": "<string>",
    "fee_type": "EVM_EIP_1559",
    "gas_limit": "<string>"
  },
  "cobo_transaction_id": "<string>"
}
'

{
  "result": {
    "transaction_id": "<string>",
    "status": "<string>"
  },
  "success": true,
  "suggestion": "",
  "message": "",
  "meta": {
    "total": 123,
    "offset": 123,
    "limit": 123,
    "has_more": true,
    "after": "<string>",
    "before": "<string>"
  }
}

{
  "success": false,
  "error": {
    "detail": [
      {
        "loc": [
          "<string>"
        ],
        "msg": "<string>",
        "type": "<string>",
        "input": "<unknown>",
        "ctx": {}
      }
    ]
  }
}

Headers

X-API-Key

string | null

Path Parameters

wallet_uuid

string<uuid>

required

The UUID of the wallet that owns the transaction. Retrieve this value from the id field returned when the wallet was created.

transaction_uuid

string<uuid>

required

The UUID of the user transaction to drop, returned as id by the transfer or contract-call endpoints.

Body

application/json

Request payload for cancelling a transaction.

fee is required for Broadcasting (RBF drop); omit for pre-broadcast cancel.

request_id

string | null

A client-supplied identifier for the replacement transaction.

Maximum string length: 255

fee

EIP1559FeeRequest · object

Custom fee parameters for the replacement transaction. Required when the transaction is broadcasting (RBF drop).

EIP1559FeeRequest
EVMLegacyFeeRequest
SOLFeeRequest

Show child attributes

cobo_transaction_id

string | null

The provider-side transaction ID to cancel. The transaction ID can be retrieved from the transfer or contract call response.

Maximum string length: 255

Response

Successful Response

result

TransactionRbfResult · object

required

Shared response payload for drop/speedup/resend operations.

Show child attributes

success

boolean

default:true

suggestion

string

default:""

message

string

default:""

General

CLI

API reference

Drop transaction

Headers

Path Parameters

Body

Response