Transfer tokens

POST

wallets

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

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..."
  }
}

Overview

Authentication

Wallet

Policy

Utility

Request body

Response

Errors

​Request body

​Response

​Errors

Request body

Response

Errors