Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.useknot.xyz/llms.txt

Use this file to discover all available pages before exploring further.

You can swap any token pair through the Jupiter aggregator. Jupiter routes orders across Solana’s DEXes to find the best price, and includes MEV protection to prevent front-running.

​
Execute a swap

curl -X POST https://api.useknot.xyz/wallets/me/actions/trade \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "USDC",
    "to": "SOL",
    "amount": 50,
    "slippageBps": 50
  }'

​
Request parameters

​
from
string
required
The source token. Use a common symbol (e.g., USDC) or the token’s Solana mint address.
​
to
string
required
The destination token. Use a common symbol or mint address.
​
amount
number
required
The amount of the source token to swap.
​
slippageBps
number
default:"50"
Slippage tolerance in basis points. Defaults to 50 (0.5%). See slippage guidance below.

​
Response

{
  "status": true,
  "data": {
    "signature": "4kLmN9xR...",
    "explorerUrl": "https://solscan.io/tx/4kLmN9xR...",
    "inputAmount": "50 USDC",
    "outputAmount": "0.581 SOL",
    "priceImpact": "0.01%",
    "route": ["Raydium", "Orca"]
  }
}

​
Response fields

​
data
object

​
Slippage

Slippage tolerance protects you against price movement between the time the order is submitted and when it lands on-chain. If the final price moves beyond the tolerance, the transaction is rejected rather than executed at an unfavorable price.
Basis pointsPercentageRecommended use
100.1%Stable pairs (USDC/USDT)
500.5%Standard swaps
1001.0%Volatile tokens
3003.0%Low-liquidity tokens
Setting slippage too low may cause transactions to fail during volatile conditions. Setting it too high may result in poor execution prices.

​
Supported tokens

Jupiter supports thousands of tokens on Solana. You can identify tokens in two ways:

​
By symbol

Common symbols are recognized automatically: 
SOL, USDC, USDT, JUP, BONK, WIF, RAY, ORCA

​
By mint address

For any token not covered by a common symbol, use its Solana mint address: 
{
  "from": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "to": "So11111111111111111111111111111111111111112",
  "amount": 100,
  "slippageBps": 50
}

​
Jupiter integration and MEV protection

Knot routes all swaps through Jupiter, Solana’s leading DEX aggregator. Jupiter:
  • Splits orders across multiple liquidity pools (Raydium, Orca, and others) to minimize price impact
  • Uses smart routing to find the optimal path for any token pair
  • Includes MEV protection to prevent sandwich attacks on your transactions
The route field in the response shows which DEXes were used for a given swap.

​
Common trade scenarios

Use tight slippage for stablecoin-to-stablecoin swaps since price variation is minimal:
curl -X POST https://api.useknot.xyz/wallets/me/actions/trade \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "USDC",
    "to": "USDT",
    "amount": 500,
    "slippageBps": 10
  }'
Use higher slippage when trading low-liquidity or volatile tokens to avoid transaction failures:
curl -X POST https://api.useknot.xyz/wallets/me/actions/trade \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "SOL",
    "to": "BONK",
    "amount": 1,
    "slippageBps": 300
  }'
Specify tokens by their on-chain mint address when their symbol is not recognized:
curl -X POST https://api.useknot.xyz/wallets/me/actions/trade \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "to": "So11111111111111111111111111111111111111112",
    "amount": 100,
    "slippageBps": 50
  }'

​
Policy constraints

Trading must be enabled in your agent’s policy. If you receive a 403 error when attempting a swap, check that trading is allowed in your policy settings.