Trading

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

string

required

The source token. Use a common symbol (e.g., USDC) or the token’s Solana mint address.

string

required

The destination token. Use a common symbol or mint address.

number

required

The amount of the source token to swap.

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

object

Hide properties

string

The on-chain transaction signature.

string

Link to view the transaction on Solscan.

string

The amount spent, formatted with the source token symbol (e.g., 50 USDC).

string

The amount received, formatted with the destination token symbol (e.g., 0.581 SOL).

string

The estimated price impact of the swap as a percentage.

array

The list of DEXes used to execute the swap. Jupiter may split orders across multiple venues for better pricing.

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 points	Percentage	Recommended use
10	0.1%	Stable pairs (USDC/USDT)
50	0.5%	Standard swaps
100	1.0%	Volatile tokens
300	3.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

Swap stablecoins

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
  }'

Buy a volatile token

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
  }'

Trade using mint addresses

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.

Getting Started

Core Features

Security & Policies

Advanced

Execute a swap

Request parameters

Response

Response fields

Slippage

Supported tokens

By symbol

By mint address

Jupiter integration and MEV protection

Common trade scenarios

Policy constraints

​Execute a swap

​Request parameters

​Response

​Response fields

​Slippage

​Supported tokens

​By symbol

​By mint address

​Jupiter integration and MEV protection

​Common trade scenarios

​Policy constraints

Execute a swap

Request parameters

Response

Response fields

Slippage

Supported tokens

By symbol

By mint address

Jupiter integration and MEV protection

Common trade scenarios

Policy constraints