Submit the supertransaction for execution

curl --request POST \
  --url https://api.biconomy.io/v1/execute \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "ownerAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "fee": {
    "amount": "10000000000000000",
    "token": "0x0000000000000000000000000000000000000000",
    "chainId": 8453
  },
  "quoteType": "permit",
  "quote": {
    "hash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
    "node": "0x9876543210abcdef9876543210abcdef98765432",
    "commitment": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
    "paymentInfo": {
      "sender": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
      "initCode": "0x1234abcd",
      "nonce": "0",
      "token": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
      "chainId": 1,
      "shortEncoding": false,
      "tokenValue": "1000 (for 1000 USDC), 250000 (for 1 WBTC very soon)",
      "tokenWeiAmount": "1000000000000000000000 (1000 ether), 250000 (0.25 USDC)",
      "verificationGasLimit": "21000",
      "eoa": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
      "eip7702Auth": {
        "address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
        "chainId": 8453,
        "nonce": 38,
        "r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
        "s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
        "yParity": 1,
        "v": "28"
      },
      "callGasLimit": "50000",
      "sponsored": true,
      "sponsorshipUrl": "https://sponsorship.abc.org",
      "tokenAmount": "1000 (1000 USDC), 1 (1 ether)",
      "gasFee": "21000000000000000",
      "orchestrationFee": "1000000000000000"
    },
    "userOps": [
      {
        "userOp": {
          "sender": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
          "nonce": "0",
          "callData": "0x1234abcd",
          "callGasLimit": "21000",
          "verificationGasLimit": "100000",
          "preVerificationGas": "21000",
          "maxFeePerGas": "1000000000",
          "maxPriorityFeePerGas": "100000000",
          "initCode": "0x1234abcd",
          "paymasterAndData": "0x",
          "signature": "0xabcdef123456"
        },
        "userOpHash": "0x1234abcd5678ef90",
        "meeUserOpHash": "0xabcdef1234567890",
        "lowerBoundTimestamp": 1710000000,
        "upperBoundTimestamp": 1710003600,
        "maxGasLimit": "1000000",
        "maxFeePerGas": "1000000000",
        "chainId": 8453,
        "eip7702Auth": {
          "address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
          "chainId": 8453,
          "nonce": 38,
          "r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
          "s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
          "yParity": 1,
          "v": "28"
        },
        "isCleanUpUserOp": false,
        "shortEncoding": true
      }
    ],
    "fundingTokens": [
      {
        "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "chainId": 1,
        "amount": "1000000000"
      }
    ]
  },
  "payloadToSign": [
    {
      "signablePayload": {
        "types": {},
        "message": {
          "owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
          "spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
          "value": "1000000000000000000000",
          "nonce": "0",
          "deadline": "1647857449"
        },
        "primaryType": "Permit",
        "domain": {
          "name": "USD Coin",
          "version": "2",
          "chainId": 1,
          "verifyingContract": "0xA0b86a33E6441c1a7C4FB1e50Fc5F5ED69DC3D2B",
          "salt": "0x0000000000000000000000000000000000000000000000000000000000000000"
        }
      },
      "metadata": {
        "nonce": "0",
        "name": "USD Coin",
        "version": "2",
        "domainSeparator": "0x06c37168a7db5138defc7866392bb87a741f9b3d104deb5094588ce041cae335",
        "owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
        "spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
        "amount": "1000000000000000000000"
      },
      "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1b"
    }
  ]
}
'

{
  "success": true,
  "supertxHash": "0x9a72f87a93c55d8f88e3f8c2a7b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
  "error": null
}

POST

execute

curl --request POST \
  --url https://api.biconomy.io/v1/execute \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "ownerAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "fee": {
    "amount": "10000000000000000",
    "token": "0x0000000000000000000000000000000000000000",
    "chainId": 8453
  },
  "quoteType": "permit",
  "quote": {
    "hash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
    "node": "0x9876543210abcdef9876543210abcdef98765432",
    "commitment": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
    "paymentInfo": {
      "sender": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
      "initCode": "0x1234abcd",
      "nonce": "0",
      "token": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
      "chainId": 1,
      "shortEncoding": false,
      "tokenValue": "1000 (for 1000 USDC), 250000 (for 1 WBTC very soon)",
      "tokenWeiAmount": "1000000000000000000000 (1000 ether), 250000 (0.25 USDC)",
      "verificationGasLimit": "21000",
      "eoa": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
      "eip7702Auth": {
        "address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
        "chainId": 8453,
        "nonce": 38,
        "r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
        "s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
        "yParity": 1,
        "v": "28"
      },
      "callGasLimit": "50000",
      "sponsored": true,
      "sponsorshipUrl": "https://sponsorship.abc.org",
      "tokenAmount": "1000 (1000 USDC), 1 (1 ether)",
      "gasFee": "21000000000000000",
      "orchestrationFee": "1000000000000000"
    },
    "userOps": [
      {
        "userOp": {
          "sender": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
          "nonce": "0",
          "callData": "0x1234abcd",
          "callGasLimit": "21000",
          "verificationGasLimit": "100000",
          "preVerificationGas": "21000",
          "maxFeePerGas": "1000000000",
          "maxPriorityFeePerGas": "100000000",
          "initCode": "0x1234abcd",
          "paymasterAndData": "0x",
          "signature": "0xabcdef123456"
        },
        "userOpHash": "0x1234abcd5678ef90",
        "meeUserOpHash": "0xabcdef1234567890",
        "lowerBoundTimestamp": 1710000000,
        "upperBoundTimestamp": 1710003600,
        "maxGasLimit": "1000000",
        "maxFeePerGas": "1000000000",
        "chainId": 8453,
        "eip7702Auth": {
          "address": "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
          "chainId": 8453,
          "nonce": 38,
          "r": "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
          "s": "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
          "yParity": 1,
          "v": "28"
        },
        "isCleanUpUserOp": false,
        "shortEncoding": true
      }
    ],
    "fundingTokens": [
      {
        "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "chainId": 1,
        "amount": "1000000000"
      }
    ]
  },
  "payloadToSign": [
    {
      "signablePayload": {
        "types": {},
        "message": {
          "owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
          "spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
          "value": "1000000000000000000000",
          "nonce": "0",
          "deadline": "1647857449"
        },
        "primaryType": "Permit",
        "domain": {
          "name": "USD Coin",
          "version": "2",
          "chainId": 1,
          "verifyingContract": "0xA0b86a33E6441c1a7C4FB1e50Fc5F5ED69DC3D2B",
          "salt": "0x0000000000000000000000000000000000000000000000000000000000000000"
        }
      },
      "metadata": {
        "nonce": "0",
        "name": "USD Coin",
        "version": "2",
        "domainSeparator": "0x06c37168a7db5138defc7866392bb87a741f9b3d104deb5094588ce041cae335",
        "owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
        "spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
        "amount": "1000000000000000000000"
      },
      "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1b"
    }
  ]
}
'

{
  "success": true,
  "supertxHash": "0x9a72f87a93c55d8f88e3f8c2a7b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
  "error": null
}

Authorizations

X-API-Key

string

header

required

API Key required to access Supertransaction API. Example: mee_2w3mXCuyt4xVXDRCZ5k5Lhgs

Body

application/json

Body

MEE execution request with signed quote payloads

ownerAddress

string

required

Owner wallet address which will be used as a owner of orchestrator account

Example:

"0x1234567890abcdef1234567890abcdef12345678"

fee

object

required

Fee details: amount, token address, and chain ID.

Show child attributes

fee.amount

string

required

Fee amount for the quote in wei.

Example:

"10000000000000000"

fee.token

string

required

EVM address of the fee token (zero address for native ETH).

Example:

"0x0000000000000000000000000000000000000000"

fee.chainId

number

required

Chain ID where the fee token resides.

Example:

8453

quoteType

enum<string>

required

Type of MEE signature: permit, onchain, simple, permit-sca, or mm-dtk.

Available options:

permit,

onchain,

simple,

permit-sca,

mm-dtk

Example:

"permit"

quote

object

required

MEE network compatible quote information

Show child attributes

quote.hash

string

required

Supertransaction hash of the quote.

Example:

"0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef"

quote.node

string

required

EVM address of the node providing the quote.

Example:

"0x9876543210abcdef9876543210abcdef98765432"

quote.commitment

string

required

Node's commitment hash for the supertransaction quote (hex string, 0x-prefixed).

Example:

"0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"

quote.paymentInfo

object

required

Show child attributes

quote.paymentInfo.sender

string

required

Sender EVM address (optional)

Example:

"0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4"

quote.paymentInfo.initCode

string

default:0x

required

Init code as hex string (optional)

Example:

"0x1234abcd"

quote.paymentInfo.nonce

string

required

Nonce as string (optional)

Example:

"0"

quote.paymentInfo.token

string

required

Payment token address

Example:

"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"

quote.paymentInfo.chainId

number

required

Chain ID of the payment token

Example:

1

quote.paymentInfo.shortEncoding

boolean

default:false

required

Short encoding flag (default: false)

Example:

false

quote.paymentInfo.tokenValue

string

required

Token value as string in USD

Example:

"1000 (for 1000 USDC), 250000 (for 1 WBTC very soon)"

quote.paymentInfo.tokenWeiAmount

string

required

Token wei amount as string (optional)

Example:

"1000000000000000000000 (1000 ether), 250000 (0.25 USDC)"

quote.paymentInfo.verificationGasLimit

string

Verification gas limit as string (optional)

Example:

"21000"

quote.paymentInfo.eoa

string

EOA address (optional)

Example:

"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"

quote.paymentInfo.eip7702Auth

object

Object containing the EIP-7702 authorization signature fields for delegation, including the signer address, chain ID, nonce, and ECDSA signature components (r, s, v/yParity). Used to prove delegation intent and validity.

Show child attributes

quote.paymentInfo.eip7702Auth.address

string

required

The EVM address of the delegation contract to which your EOA (Externally Owned Account) is being upgraded. Must be a valid checksummed Ethereum address.

Example:

"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"

quote.paymentInfo.eip7702Auth.chainId

number

required

The chain ID for which this authorization is valid. Use 0 for multichain or specify a supported chain ID.

Example:

8453

quote.paymentInfo.eip7702Auth.nonce

number

required

Signature nonce

Example:

38

quote.paymentInfo.eip7702Auth.r

string

required

The "r" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.

Example:

"0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded"

quote.paymentInfo.eip7702Auth.s

string

required

The "s" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.

Example:

"0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1"

quote.paymentInfo.eip7702Auth.yParity

number

required

The y-parity value (EIP-2098) for the signature. Should be 0 or 1.

Example:

1

quote.paymentInfo.eip7702Auth.v

string

The "v" value of the ECDSA signature (recovery id), as a string. Optional for EIP-2098 signatures.

Example:

"28"

quote.paymentInfo.callGasLimit

string

Call gas limit as string (optional)

Example:

"50000"

quote.paymentInfo.sponsored

boolean

Sponsored ulr (optional)

Example:

"https://sponsorship.abc.org"

quote.paymentInfo.tokenAmount

string

Token amount as string (optional)

Example:

"1000 (1000 USDC), 1 (1 ether)"

quote.paymentInfo.gasFee

string

Gas fee as string (optional)

Example:

"21000000000000000"

quote.paymentInfo.orchestrationFee

string

Orchestration fee as string (optional)

Example:

"1000000000000000"

quote.userOps

object[]

required

Array of MEE UserOperation objects for the quote.

Show child attributes

quote.userOps.userOp

object

required

Object containing the fields of a UserOperation, including sender, nonce, calldata, gas limits, and signature.

Show child attributes

quote.userOps.userOp.sender

string

required

The address of the account initiating the user operation.

Example:

"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"

quote.userOps.userOp.nonce

string

required

The nonce of the sender account, as a bigint.

Example:

"0"

quote.userOps.userOp.callData

string

required

The calldata for the user operation, as a hex string.

Example:

"0x1234abcd"

quote.userOps.userOp.callGasLimit

string

required

The gas limit for the call, as a bigint.

Example:

"21000"

quote.userOps.userOp.verificationGasLimit

string

required

The gas limit for verification, as a bigint.

Example:

"100000"

quote.userOps.userOp.preVerificationGas

string

required

The gas used before verification, as a bigint.

Example:

"21000"

quote.userOps.userOp.maxFeePerGas

string

required

The maximum fee per gas, as a bigint.

Example:

"1000000000"

quote.userOps.userOp.maxPriorityFeePerGas

string

required

The maximum priority fee per gas, as a bigint.

Example:

"100000000"

quote.userOps.userOp.initCode

string

The initCode for contract creation, as a hex string. Optional.

Example:

"0x1234abcd"

quote.userOps.userOp.paymasterAndData

string

The paymaster and data field, as a hex string. Optional.

Example:

"0x"

quote.userOps.userOp.signature

string

The signature for the user operation, as a hex string. Optional.

Example:

"0xabcdef123456"

quote.userOps.userOpHash

string

required

The hash of the user operation.

Example:

"0x1234abcd5678ef90"

quote.userOps.meeUserOpHash

string

required

The MEE-specific hash of the user operation.

Example:

"0xabcdef1234567890"

quote.userOps.lowerBoundTimestamp

number

required

The lower bound timestamp for the user operation.

Example:

1710000000

quote.userOps.upperBoundTimestamp

number

required

The upper bound timestamp for the user operation.

Example:

1710003600

quote.userOps.maxGasLimit

string

required

The maximum gas limit for the user operation.

Example:

"1000000"

quote.userOps.maxFeePerGas

string

required

The maximum fee per gas for the user operation.

Example:

"1000000000"

quote.userOps.chainId

number

required

The chain ID for the user operation.

Example:

8453

quote.userOps.eip7702Auth

object

Show child attributes

quote.userOps.eip7702Auth.address

string

required

The EVM address of the delegation contract to which your EOA (Externally Owned Account) is being upgraded. Must be a valid checksummed Ethereum address.

Example:

"0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a"

quote.userOps.eip7702Auth.chainId

number

required

The chain ID for which this authorization is valid. Use 0 for multichain or specify a supported chain ID.

Example:

8453

quote.userOps.eip7702Auth.nonce

number

required

Signature nonce

Example:

38

quote.userOps.eip7702Auth.r

string

required

The "r" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.

Example:

"0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded"

quote.userOps.eip7702Auth.s

string

required

The "s" value of the ECDSA signature, as a 32-byte hex string prefixed with 0x.

Example:

"0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1"

quote.userOps.eip7702Auth.yParity

number

required

The y-parity value (EIP-2098) for the signature. Should be 0 or 1.

Example:

1

quote.userOps.eip7702Auth.v

string

The "v" value of the ECDSA signature (recovery id), as a string. Optional for EIP-2098 signatures.

Example:

"28"

quote.userOps.isCleanUpUserOp

boolean

Whether this is a clean-up user operation.

Example:

false

quote.userOps.shortEncoding

boolean

Whether the user operation uses short encoding.

Example:

true

quote.fundingTokens

object[]

Optional array of funding tokens for token pull execution.

Show child attributes

quote.fundingTokens.tokenAddress

string

required

Contract address of the token that will be deposited into the Nexus smart account.

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

quote.fundingTokens.chainId

number

required

Chain ID where the funding token resides. Use a supported chain ID.

Example:

1

quote.fundingTokens.amount

string

required

Amount of funding token in wei/smallest unit to deposit.

Example:

"1000000000"

payloadToSign

object[]

required

Array of payloads with signatures for execution.

Minimum array length: 1

Option 1
Option 2
Option 3

Show child attributes

payloadToSign.signablePayload

object

required

Payload to be signed for EIP-712 permit

Show child attributes

payloadToSign.signablePayload.types

object

required

Show child attributes

payloadToSign.signablePayload.types.{key}

object[]

List of fields for this struct

Show child attributes

payloadToSign.signablePayload.types.{key}.name

string

required

A string value.

Example:

"owner"

payloadToSign.signablePayload.types.{key}.type

string

required

A string value.

Example:

"address"

Example:

[
  { "name": "owner", "type": "address" },
  { "name": "spender", "type": "address" },
  { "name": "value", "type": "uint256" },
  { "name": "nonce", "type": "uint256" },
  { "name": "deadline", "type": "uint256" }
]

payloadToSign.signablePayload.message

object

required

Key-value pairs for the EIP-712 message

Show child attributes

payloadToSign.signablePayload.message.{key}

any

Example:

{
  "owner": "0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4",
  "spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
  "value": "1000000000000000000000",
  "nonce": "0",
  "deadline": "1647857449"
}

payloadToSign.signablePayload.primaryType

string

required

Name of the main EIP-712 struct to sign (e.g. 'Permit')

Example:

"Permit"

payloadToSign.signablePayload.domain

object

EIP-712 domain object

Show child attributes

payloadToSign.signablePayload.domain.name

string

Token or contract name (e.g. 'USD Coin')

Example:

"USD Coin"

payloadToSign.signablePayload.domain.version

string

Contract version (e.g. '1')

Example:

"2"

payloadToSign.signablePayload.domain.chainId

number

EVM chain ID (e.g. 1 for Ethereum mainnet)

Example:

1

payloadToSign.signablePayload.domain.verifyingContract

string

Address of the contract being verified

Example:

"0xA0b86a33E6441c1a7C4FB1e50Fc5F5ED69DC3D2B"

payloadToSign.signablePayload.domain.salt

string

Optional domain salt (hex string)

Example:

"0x0000000000000000000000000000000000000000000000000000000000000000"

payloadToSign.metadata

object

required

Extra metadata for the permit signature

Show child attributes

payloadToSign.metadata.nonce

string

required

Permit nonce (as string)

Example:

"0"

payloadToSign.metadata.name

string

required

Token or contract name

Example:

"USD Coin"

payloadToSign.metadata.version

string

required

Contract version

Example:

"2"

payloadToSign.metadata.domainSeparator

string

required

EIP-712 domain separator (hex string)

Example:

"0x06c37168a7db5138defc7866392bb87a741f9b3d104deb5094588ce041cae335"

payloadToSign.metadata.owner

string

required

Address of the permit owner

Example:

"0x742d35C9a91B1D5b5D24Dc30e8F0dF8E84b5d1c4"

payloadToSign.metadata.spender

string

required

Address of the spender

Example:

"0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45"

payloadToSign.metadata.amount

string

required

Permit amount in wei (as string)

Example:

"1000000000000000000000"

payloadToSign.signature

string

required

Hex-encoded signature of the quote payload, produced by the user's private key. Must be a valid ECDSA signature in hexadecimal format.

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1b"

Response

MEE execution response

success

boolean

required

Indicates if the supertransaction execution was successful.

Example:

true

supertxHash

string | null

required

The transaction hash of the executed supertransaction, or null if not available.

Example:

"0x9a72f87a93c55d8f88e3f8c2a7b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"

error

string | null

required

Error message if the execution failed, or null if successful.

Example:

null

Compose instructions and generate a quote Get orchestrator addresses

⌘I

About Supertransaction API

Building Workflow Instructions

Executing Workflows

API Reference

Submit the supertransaction for execution

Authorizations

Body

Response