v1

latestOpenAPI 3.0.12026-07-2699111970.1 KB

Approve Transaction

Submit approval signature for a pending transaction. Required for transactions using external signers.

API scope required: wallets:transactions.sign

post/2025-06-09/wallets/{walletLocator}/transactions/{transactionId}/approvals

Path parameters

walletLocatorstring required

A wallet locator can be of the format:

  • <walletAddress>
  • email:<email>:<chainType>[:<walletType>][:alias:<alias>] (walletType defaults to 'smart')
  • userId:<userId>:<chainType>[:<walletType>][:alias:<alias>] (white label user example)
  • phoneNumber:<phoneNumber>:<chainType>[:<walletType>][:alias:<alias>]
  • twitter:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • x:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • me:<chainType>[:<walletType>][:alias:<alias>] (Use when calling from the client side with a client API key)
  • chainType[:<walletType>]:alias:<alias>
transactionIdstring required

Headers

X-API-KEYstring required

API key required for authentication

Request body

Example request

{
  "approvals": [
    {
      "signature": {
        "r": "0x1234...",
        "s": "0x5678..."
      }
    }
  ]
}

Response

The approval has successfully been submitted to the transaction.

OR
OR
OR
OR

Example response

{
  "error": {
    "revert": {
      "type": "contract_call",
      "reason": "ERC20: transfer amount exceeds balance"
    }
  }
}