Wallet
Transfer tokens
Transfer SOL or SPL tokens to another Solana address
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
}'
curl -X POST https://api.useknot.xyz/wallets/me/actions/transfer \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"to": "RecipientSolanaAddress...",
"amount": 100,
"mint": "USDC"
}'
{
"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
string
required
Recipient’s Solana wallet address.
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).string
Token symbol (e.g.,
USDC, BONK) or mint address. Omit this field to transfer native SOL.Response
boolean
true when the transfer succeeds.object
Show properties
Show properties
string
On-chain transaction signature.
string
Solscan link to inspect the transaction.
string
Formatted transfer amount with token symbol (e.g.,
100 USDC).number
Actual amount received by the recipient after fees.
number
Fee charged for the transfer.
string
How the fee was applied.
added means the fee was charged on top of the amount; deducted means it was taken from the amount.string
Recipient wallet address.
Errors
| Status | Description |
|---|---|
400 | Invalid address, amount, or token symbol |
401 | Missing or invalid Bearer token |
403 | Transfer blocked by agent policy |
429 | Rate 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
}'
curl -X POST https://api.useknot.xyz/wallets/me/actions/transfer \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"to": "RecipientSolanaAddress...",
"amount": 100,
"mint": "USDC"
}'
{
"status": true,
"data": {
"signature": "5UfgJ3vN...",
"explorerUrl": "https://solscan.io/tx/5UfgJ3vN...",
"amount": "100 USDC",
"amountSent": 98.9,
"fee": 1.1,
"feeMode": "deducted",
"recipient": "RecipientSolanaAddress..."
}
}
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
}'
curl -X POST https://api.useknot.xyz/wallets/me/actions/transfer \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"to": "RecipientSolanaAddress...",
"amount": 100,
"mint": "USDC"
}'
{
"status": true,
"data": {
"signature": "5UfgJ3vN...",
"explorerUrl": "https://solscan.io/tx/5UfgJ3vN...",
"amount": "100 USDC",
"amountSent": 98.9,
"fee": 1.1,
"feeMode": "deducted",
"recipient": "RecipientSolanaAddress..."
}
}