Skip to main content
POST
/
wallets
/
me
/
actions
/
transfer
curl -X POST https://api.useknot.xyz/wallets/me/actions/transfer \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "RecipientSolanaAddress...",
    "amount": 0.5
  }'
{
  "status": true,
  "data": {
    "signature": "5UfgJ3vN...",
    "explorerUrl": "https://solscan.io/tx/5UfgJ3vN...",
    "amount": "100 USDC",
    "amountSent": 98.9,
    "fee": 1.1,
    "feeMode": "deducted",
    "recipient": "RecipientSolanaAddress..."
  }
}
Sends SOL or any SPL token from the agent’s wallet to a recipient address. Omit the mint field to send native SOL.
Requires authentication via Bearer token.
Transfers are subject to your agent’s policy limits. If the transfer exceeds maxSingleTransactionInUsd or the daily limit, the request is rejected. Configure limits via Update policy.

Request body

to
string
required
Recipient’s Solana wallet address.
amount
number
required
Amount to transfer, denominated in the token’s standard unit (e.g., 1.5 for 1.5 SOL or 100 for 100 USDC).
mint
string
Token symbol (e.g., USDC, BONK) or mint address. Omit this field to transfer native SOL.

Response

status
boolean
true when the transfer succeeds.
data
object

Errors

StatusDescription
400Invalid address, amount, or token symbol
401Missing or invalid Bearer token
403Transfer blocked by agent policy
429Rate limit exceeded
curl -X POST https://api.useknot.xyz/wallets/me/actions/transfer \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "RecipientSolanaAddress...",
    "amount": 0.5
  }'
{
  "status": true,
  "data": {
    "signature": "5UfgJ3vN...",
    "explorerUrl": "https://solscan.io/tx/5UfgJ3vN...",
    "amount": "100 USDC",
    "amountSent": 98.9,
    "fee": 1.1,
    "feeMode": "deducted",
    "recipient": "RecipientSolanaAddress..."
  }
}