On-chain error codes

Program error codes returned when a submitted transaction fails on-chain.

When a built transaction fails on-chain, your RPC returns the program log with one of the codes below (mainnet program FLASH6Lo6h3iasJKWDs2F8TkW2UKf3s15C8PMGuVfgBn). The full list is derived from the program IDL.

Trading (most common)

Code	Name	Solution
6020	MaxPriceSlippage	Price moved beyond tolerance. Widen slippagePercentage or rebuild with a fresh quote
6021	MaxLeverage	Post-modification leverage exceeds the market max. Reduce size or add collateral
6022	MaxInitLeverage	New-position leverage exceeds the initial-leverage cap
6023	MinLeverage	Leverage below the minimum. Increase size or reduce collateral
6064	MinInitLeverage	Initial leverage below the minimum
6024	CustodyAmountLimit	Pool capacity reached. Try smaller or wait
6025	PositionAmountLimit	Single position exceeds the max size. Split it
6031	InstructionNotAllowed	Trading paused (maintenance / circuit breaker). Wait and retry
6032	MaxUtilization	Pool utilization at capacity. Try smaller or wait
6033	CloseOnlyMode	Market in close-only mode. Only close/decrease allowed
6034	MinCollateral	Below minimum collateral. Increase it (leave a buffer for TP/SL)
6087	InsufficientCollateral	Not enough collateral for the requested position
6088	MaxPositionSize	Position size exceeds the allowed maximum
6089	MaxExposure	Market exposure cap exceeded. Reduce size or wait
6065	InsufficientPositionSize	Resulting size too small (e.g. over-large partial close)
6110	InsufficientCustodyLiquidity	Not enough free liquidity in the custody. Smaller size or wait
6040	CloseRatio	Invalid close amount relative to current size

Orders (limit / TP / SL)

Code	Name	Solution
6049	InvalidStopLossPrice	SL price invalid for the direction (e.g. SL above entry for a long)
6050	InvalidTakeProfitPrice	TP price invalid for the direction
6051	ExposureLimitExceeded	Market exposure cap hit. Reduce size or wait
6052	MaxStopLossOrders	Max SL orders per market reached. Cancel one first
6053	MaxTakeProfitOrders	Max TP orders per market reached. Cancel one first
6054	MaxOpenOrder	Max open limit orders per market reached. Cancel one first
6055	InvalidOrder	Order doesn't exist at the specified index
6057	InvalidLimitPrice	Limit price invalid for the direction
6083	MaxOrdersReached	Order limit exhausted for this market + side
6084	InvalidOrderIndex	orderId out of range (0–4)
6085	OrderNotFound	No order at the given orderId
6086	LimitPriceNotMet	Limit price condition not met (keeper context)
6090	InvalidTriggerPrice	Trigger price invalid for the order type/direction
6092	TriggerPriceNotMet	Trigger condition not met (keeper context)

Oracle

Code	Name	Solution
6005	StaleOraclePrice	Oracle price too old. Retry after a few slots; check market session
6002	UnsupportedOracle	Internal: custody oracle misconfigured
6003	InvalidOracleAccount	Wrong oracle account. Ensure the pool config is current
6004	InvalidOracleState	Oracle feed offline/corrupted. Wait and retry
6006	InvalidOraclePrice	Oracle returned 0 or invalid confidence. Wait and retry
6093	InvalidPrice	Computed/derived price invalid
6094	OracleDivergenceTooHigh	Oracle price divergence exceeds the maximum
6095	OracleConfidenceTooWide	Oracle confidence interval exceeds the maximum
6096	StaleBackupOraclePrice	Backup oracle price too stale
6097	InvalidBackupOracleSignature	Invalid backup oracle Ed25519 signature
6035–6038	PermissionlessOracle*	Keeper/oracle authority or signature errors

Pyth Lazer

Code	Name	Notes
6098	InvalidLazerMessage	Lazer message format error
6099	InvalidLazerPayload	Lazer payload parsing failure
6100	InvalidLazerChannel	Wrong Lazer channel for this custody
6101	InvalidLazerTimestamp	Lazer message too old or in the future

Deposit / withdrawal / balance

Code	Name	Solution
6078	InsufficientBalance	Insufficient balance for the operation
6079	InsufficientAvailableBalance	Insufficient available balance (deposits minus obligations)
6075	NoDepositsToClaim	No deposits available to claim
6076	PendingDepositNotClaimed	Pending deposit hasn't been claimed yet
6077	NoWithdrawalPending	No pending withdrawal to settle (nothing for withdrawal-settle to resume)
6048	MaxDepostsReached	Token vault deposit limit hit
6058	MinReserve	Custody minimum-reserve threshold
6059	MaxWithdrawTokenRequest	Max pending withdraw requests reached
6108	UserDepositDisabled	User deposits currently disabled
6109	UserWithdrawDisabled	User withdrawals currently disabled

Access, authority & delegation

Code	Name	Solution
6102	Unauthorized	Signer is not the owner or an authorized delegate
6056	InvalidAuthority	Wrong authority for the instruction
6045	InvalidOwner	Token account owner mismatch. Ensure the ATA is derived correctly
6046	InvalidAccess	Pool requires NFT/referral access
6111	InvalidValidatorKey	Delegation key is invalid
6105	TradeInitDisabled	Opening/increasing positions currently disabled
6106	TradeMaintDisabled	Position maintenance (modify) currently disabled
6107	TradeLiquidationDisabled	Liquidations currently disabled

State validation

Code	Name	Solution
6009	InvalidPoolState	Pool account corrupted/uninitialized. Verify the pool address
6010	InvalidCustodyState	Custody account issue. Re-fetch the pool config
6011	InvalidMarketState	Market account issue. Verify the market exists for this pool/side
6012	InvalidCollateralCustody	Wrong collateral token for this market
6013	InvalidPositionState	Position doesn't exist or is already closed
6018	InvalidBasketState	Basket corrupted, not initialized, or not delegated
6071	InvalidPoolAccount	Pool account failed PDA validation
6072	InvalidCustodyAccount	Custody account failed PDA validation
6069	InvalidCustodyTokenAccount	Custody token account mismatch
6070	InvalidTokenMint	Token mint mismatch for the operation
6074	InvalidAccountData	Account data failed to deserialize/validate
6007–6017	Invalid*Config / *State	Environment, platform, perpetuals, pool, custody config issues

Token / pool / market support

Code	Name	Solution
6027	UnsupportedToken	Token mint not recognized by the pool
6028	UnsupportedCustody	Custody not found in the pool
6029	UnsupportedPool	Pool address invalid
6030	UnsupportedMarket	Market doesn't exist for this target/collateral/side

Arithmetic & misc

Code	Name	Notes
6001	MathOverflow	Arithmetic overflow. Rare — extreme sizes/prices
6039	ExponentMismatch	Internal price-calc error (operand exponents)
6019	InsufficientAmountReturned	Output below minimum
6066	InsufficientLockedAmount	Not enough locked amount for the operation
6073	InvalidAmount	Amount is zero or otherwise invalid
6063	InvalidInput	Generic invalid input parameter
6091	InvalidArgument	Generic invalid argument
6000	CustomError	Generic catch-all

For step-by-step fixes to the most common integration failures, see Recovery patterns.