Create Transaction

Creates a new transaction for the specified wallet. Transaction will be automatically broadcast once it has all necessary approvals.

API scope required: wallets:transactions.create

POST /2025-06-09/wallets/{walletLocator}/transactions

Create Transaction

cURL

curl --request POST \
  --url https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/transactions \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "params": {
    "transaction": "<string>",
    "requiredSigners": [
      "external-wallet:0x1234567890123456789012345678901234567890"
    ],
    "signer": "external-wallet:0x1234567890123456789012345678901234567890"
  }
}
'

201

{
  "params": {
    "calls": [
      {
        "address": "<string>",
        "functionName": "<string>",
        "abi": [
          "<unknown>"
        ],
        "args": [
          "<unknown>"
        ],
        "value": "0"
      }
    ],
    "chain": "<unknown>",
    "signer": {
      "type": "external-wallet",
      "address": "<string>",
      "locator": "<string>"
    }
  },
  "onChain": {
    "userOperation": {
      "sender": "<string>",
      "nonce": "<string>",
      "callData": "<string>",
      "callGasLimit": "<string>",
      "verificationGasLimit": "<string>",
      "preVerificationGas": "<string>",
      "maxFeePerGas": "<string>",
      "maxPriorityFeePerGas": "<string>",
      "signature": "<string>",
      "paymaster": "<string>",
      "paymasterVerificationGasLimit": "<string>",
      "paymasterData": "<string>",
      "paymasterPostOpGasLimit": "<string>",
      "factory": "<string>",
      "factoryData": "<string>"
    },
    "userOperationHash": "<string>",
    "txId": "<string>",
    "proxiedTxId": "<string>",
    "explorerLink": "<string>"
  },
  "id": "<string>",
  "createdAt": 123,
  "approvals": {
    "pending": [
      {
        "signer": {
          "type": "external-wallet",
          "address": "<string>",
          "locator": "<string>"
        },
        "message": "<string>"
      }
    ],
    "submitted": [
      {
        "signature": "<string>",
        "submittedAt": 123,
        "signer": {
          "type": "external-wallet",
          "address": "<string>",
          "locator": "<string>"
        },
        "message": "<string>",
        "metadata": {
          "deviceInfo": "<string>",
          "ipAddress": "<string>",
          "userAgent": "<string>"
        }
      }
    ],
    "required": 123
  },
  "completedAt": 123,
  "error": {
    "reason": "build_failed",
    "message": "<string>",
    "revertData": {}
  },
  "sendParams": {
    "token": "<string>",
    "params": {
      "recipient": "<string>",
      "recipientAddress": "<string>",
      "amount": "<string>"
    }
  },
  "fees": {
    "estimate": "<unknown>",
    "actual": "<unknown>",
    "billed": {
      "usd": 123
    },
    "billing": {}
  }
}

Headers

X-API-KEY · string · required

API key required for authentication

x-idempotency-key · string

Unique key to prevent duplicate transaction creation

Path Parameters

walletLocator · string · 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>

Body

application/json

Solana Smart Wallet

Solana MPC Wallet

EVM Smart Wallet

EVM MPC Wallet

Stellar Smart Wallet

Input schema for creating a new transaction. The parameters vary based on the wallet type (EVM vs Solana vs Stellar).

params · object · required

Show child attributes

fees · object

Optional per-transaction fee configuration override. When omitted, the project default is used.

Show child attributes

Response

201

application/json

The transaction has been successfully created.

EVM Smart Wallet

EVM MPC Wallet

Solana Smart Wallet

Solana MPC Wallet

Stellar Smart Wallet

The signer registration transaction the wallet admin must sign and submit to add (on create) or revoke (on delete) the card's delegated signer on-chain.

chainType · enum<string> · required

The blockchain type of the wallet

Available options: evm, solana, aptos, sui, stellar

walletType · enum<string> · required

The wallet type (smart or mpc)

Available options: smart, mpc

params · object · required

Show child attributes

onChain · object · required

EVM smart wallet transaction data including input parameters and chain specific details

Show child attributes

id · string · required

Unique identifier for the transaction

status · enum<string> · required

Current status of the transaction

Available options: awaiting-approval, pending, failed, success

createdAt · number string · required

ISO timestamp when the signature was created

approvals · object

Complete approval data including requirements, pending and submitted signatures

Show child attributes

completedAt · number string

ISO timestamp when the transaction reached finality

error · object

Error message if the transaction fails after submission

Option 1

Option 2

Option 3

Show child attributes

sendParams · object

Show child attributes

fees · object

Transaction fee information including actual transaction fees, billed amounts, and billing status

Show child attributes