sol-trade-sdk/docs/TRADING_PARAMETERS.md

📋 Trading Parameters Reference

This document provides a comprehensive reference for all trading parameters used in the Sol Trade SDK.

📋 Table of Contents

• TradeSwapParams
• TradeBuyParams
• TradeSellParams
• Parameter Categories
• Important Notes

TradeSwapParams

The TradeSwapParams struct contains all parameters required for executing swap orders across different DEX protocols. This is the most flexible trading method that supports swapping between any supported tokens.

Basic Trading Parameters

Parameter	Type	Required	Description
dex_type	DexType	✅	The trading protocol to use (PumpFun, PumpSwap, Bonk, RaydiumCpmm, RaydiumAmmV4)
trade_type	TradeType	✅	The type of trade to execute (Buy, Sell)
input_mint	Pubkey	✅	The public key of the token to spend (input token)
output_mint	Pubkey	✅	The public key of the token to receive (output token)
input_token_program	Pubkey	✅	The token program ID for the input token
output_token_program	Pubkey	✅	The token program ID for the output token
input_amount	u64	✅	Amount of input token to spend (in smallest token units)
slippage_basis_points	Option<u64>	❌	Slippage tolerance in basis points (e.g., 100 = 1%, 500 = 5%)
recent_blockhash	Option<Hash>	❌	Recent blockhash for transaction validity
extension_params	Box<dyn ProtocolParams>	✅	Protocol-specific parameters (PumpFunParams, PumpSwapParams, etc.)

Advanced Configuration Parameters

Parameter	Type	Required	Description
lookup_table_key	Option<Pubkey>	❌	Address lookup table key for transaction optimization
wait_transaction_confirmed	bool	✅	Whether to wait for transaction confirmation
create_input_mint_ata	bool	✅	Whether to create input token Associated Token Account
close_input_mint_ata	bool	✅	Whether to close input token ATA after transaction
create_output_mint_ata	bool	✅	Whether to create output token ATA
close_output_mint_ata	bool	✅	Whether to close output token ATA after transaction
open_seed_optimize	bool	✅	Whether to use seed optimization for reduced CU consumption
durable_nonce	Option<DurableNonceInfo>	❌	Durable nonce information containing nonce account and current nonce value
with_tip	bool	✅	Whether to include tip for transaction priority

Supported Token Pairs

The SDK currently supports swap trading between the following base tokens and other tokens:

• SOL (Native Solana token)
• WSOL (Wrapped SOL)
• USD1 (USD1 stablecoin - currently only supported on Bonk protocol)

Important: At least one token in the swap pair must be a supported base token (SOL, WSOL, or USD1).

USD1 Token Support

USD1 token support has the following limitations:

• Protocol Restriction: USD1 trading is currently only supported on the Bonk protocol
• Pair Requirements: USD1 can be swapped with other tokens, but the swap must occur on Bonk DEX
• Token Address: USD1ttGY1N17NEEHLmELoaybftRBUSErhqYiQzvEmuB

TradeBuyParams

The TradeBuyParams struct contains all parameters required for executing buy orders across different DEX protocols.

Basic Trading Parameters

Parameter	Type	Required	Description
dex_type	DexType	✅	The trading protocol to use (PumpFun, PumpSwap, Bonk, RaydiumCpmm, RaydiumAmmV4)
mint	Pubkey	✅	The public key of the token mint to purchase
sol_amount	u64	✅	Amount of SOL to spend (in lamports)
slippage_basis_points	Option<u64>	❌	Slippage tolerance in basis points (e.g., 100 = 1%, 500 = 5%)
recent_blockhash	Option<Hash>	❌	Recent blockhash for transaction validity
extension_params	Box<dyn ProtocolParams>	✅	Protocol-specific parameters (PumpFunParams, PumpSwapParams, etc.)

Advanced Configuration Parameters

Parameter	Type	Required	Description
lookup_table_key	Option<Pubkey>	❌	Address lookup table key for transaction optimization
wait_transaction_confirmed	bool	✅	Whether to wait for transaction confirmation
create_wsol_ata	bool	✅	Whether to create wSOL Associated Token Account
close_wsol_ata	bool	✅	Whether to close wSOL ATA after transaction
create_mint_ata	bool	✅	Whether to create token mint ATA
open_seed_optimize	bool	✅	Whether to use seed optimization for reduced CU consumption
durable_nonce	Option<DurableNonceInfo>	❌	Durable nonce information containing nonce account and current nonce value

TradeSellParams

The TradeSellParams struct contains all parameters required for executing sell orders across different DEX protocols.

Basic Trading Parameters

Parameter	Type	Required	Description
dex_type	DexType	✅	The trading protocol to use (PumpFun, PumpSwap, Bonk, RaydiumCpmm, RaydiumAmmV4)
mint	Pubkey	✅	The public key of the token mint to sell
token_amount	u64	✅	Amount of tokens to sell (in smallest token units)
slippage_basis_points	Option<u64>	❌	Slippage tolerance in basis points (e.g., 100 = 1%, 500 = 5%)
recent_blockhash	Option<Hash>	❌	Recent blockhash for transaction validity
with_tip	bool	✅	Whether to include tip in the transaction
extension_params	Box<dyn ProtocolParams>	✅	Protocol-specific parameters (PumpFunParams, PumpSwapParams, etc.)

Advanced Configuration Parameters

Parameter	Type	Required	Description
lookup_table_key	Option<Pubkey>	❌	Address lookup table key for transaction optimization
wait_transaction_confirmed	bool	✅	Whether to wait for transaction confirmation
create_wsol_ata	bool	✅	Whether to create wSOL Associated Token Account
close_wsol_ata	bool	✅	Whether to close wSOL ATA after transaction
open_seed_optimize	bool	✅	Whether to use seed optimization for reduced CU consumption
durable_nonce	Option<DurableNonceInfo>	❌	Durable nonce information containing nonce account and current nonce value

Parameter Categories

🎯 Core Trading Parameters

These parameters are essential for defining the basic trading operation:

• dex_type: Determines which protocol to use for trading
• mint: Specifies the token to trade
• sol_amount (buy) / token_amount (sell): Defines the trade size
• recent_blockhash: Ensures transaction validity

⚙️ Transaction Control Parameters

These parameters control how the transaction is processed:

• slippage_basis_points: Controls acceptable price slippage
• wait_transaction_confirmed: Controls whether to wait for confirmation

🔧 Account Management Parameters

These parameters control automatic account creation and management:

• create_wsol_ata: Automatically wrap SOL to wSOL when needed
• close_wsol_ata: Automatically unwrap wSOL to SOL after trading
• create_mint_ata: Automatically create token accounts

🚀 Optimization Parameters

These parameters enable advanced optimizations:

• lookup_table_key: Use address lookup tables for reduced transaction size
• open_seed_optimize: Use seed-based account creation for lower CU consumption

🔄 Optional Parameters

When you need to use durable nonce, you need to fill in this parameter:

• durable_nonce: Durable nonce information containing nonce account and current nonce value

Important Notes

🌱 Seed Optimization

When open_seed_optimize: true:

• ⚠️ Warning: Tokens purchased with seed optimization must be sold through this SDK
• ⚠️ Warning: Official platform selling methods may fail
• 📝 Note: Use get_associated_token_address_with_program_id_fast_use_seed to get ATA addresses

💰 wSOL Account Management

The create_wsol_ata and close_wsol_ata parameters provide granular control:

• Independent Control: Create and close operations can be controlled separately
• Batch Operations: Create once, trade multiple times, then close
• Rent Optimization: Automatic rent reclamation when closing accounts

🔍 Address Lookup Tables

Before using lookup_table_key:

• Initialize AddressLookupTableCache to manage cached lookup tables
• Lookup tables reduce transaction size and improve success rates
• Particularly beneficial for complex transactions with many account references

📊 Slippage Configuration

Recommended slippage settings:

• Conservative: 100-300 basis points (1-3%)
• Moderate: 300-500 basis points (3-5%)
• Aggressive: 500-1000 basis points (5-10%)

🎯 Protocol-Specific Parameters

Each DEX protocol requires specific extension_params:

• PumpFun: PumpFunParams
• PumpSwap: PumpSwapParams
• Bonk: BonkParams
• Raydium CPMM: RaydiumCpmmParams
• Raydium AMM V4: RaydiumAmmV4Params

Refer to the respective protocol documentation for detailed parameter specifications.