POST
/
unstable
/
wallets
/
{walletLocator}
/
send

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>
  • userId:<userId>:<walletType> (white label user example)
  • phoneNumber:<phoneNumber>:<walletType>
  • twitter:<handle>:<walletType>
  • x:<handle>:<walletType>

Query Parameters

sendEmail
boolean

Whether to send email notification for MPC wallets (defaults to true)

Body

application/json

Input schema for sending different types of tokens

recipient
required

Recipient address, email or twitter handle

token
string
required

A token locator that supports native tokens, fungible tokens, and NFTs across different chains. It can be of the format:

  • chain:address[:tokenId]
  • chain:currency
  • chain:address
amount
string

Amount of tokens to transfer

signer
string

Optional signer locator. Defaults to admin signer

Response

201 - application/json

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

createdAt
number
required

ISO timestamp when the transaction was created

id
string
required

Unique identifier for the transaction

onChain
object
required

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

params
object
required

EVM smart wallet transaction parameters

status
enum<string>
required

Current status of the transaction

Available options:
awaiting-approval,
pending,
failed,
success
walletType
enum<string>
required

The type of wallet that created this transaction

Available options:
evm-smart-wallet
approvals
object

Complete approval data including requirements, pending and submitted signatures

completedAt
number

ISO timestamp when the transaction reached finality

error
object

Error message if the transaction fails after submission