POST
/
v1-alpha2
/
wallets
/
{walletLocator}
/
transactions

This is an alpha API and subject to change.

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>:<walletType>
  • userId:<userId>:<walletType>
  • phoneNumber:<phoneNumber>:<walletType>

Body

application/json

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

params
object
required

Wallet type specific transaction parameters

Response

201 - application/json

Complete transaction response including status, signing requirements, and wallet type specific data

id
string
required

Unique identifier for the transaction

walletType
enum<string>
required

The type of wallet that created this transaction

Available options:
evm-smart-wallet,
solana-custodial-wallet
status
enum<string>
required

Current status of the transaction

Available options:
awaiting-approval,
pending,
failed,
success
params
object
required

Parameters for a transaction from an EVM Smart Wallet

onChain
object
required

Type-specific transaction data including input parameters and chain specific details

createdAt
number
required

ISO timestamp when the transaction was created

approvals
object

Complete approval data including requirements, pending and submitted signatures

completedAt
number

ISO timestamp when the transaction reached finality

error
any

Error message if the transaction fails after submission