> For the complete documentation index, see [llms.txt](https://docs.lyslabs.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lyslabs.ai/decoders/raydium-amm.md). # Raydium AMM ### Common Properties All decoded events include the following base properties from `BaseTransactionRecord`: | Property | Type | JSON Type | Description | | ----------------- | ---------------- | ---------------- | ---------------------------------------------------------------- | | `uuid` | `bigint` | `string` | Unique identifier for the transaction record | | `instructionPath` | `string` | `string` | Path to the instruction within the transaction | | `parentProgramId` | `string \| null` | `string \| null` | ID of the parent program if applicable | | `txSignature` | `string` | `string` | Transaction signature | | `blockTime` | `number` | `number` | Block timestamp | | `programId` | `string` | `string` | Raydium AMM program ID | | `eventType` | `string` | `string` | Type of event (INITIALIZE2, SWAP, ADD\_LIQUIDITY, WITHDRAW\_PNL) | | `decoderType` | `DecoderType` | `string` | Decoder type identifier | | `blockHeight` | `number` | `number` | Block height | | `slot` | `number` | `number` | Blockchain slot number | | `txFee` | `number` | `number` | Transaction fee in lamports | | `txFeeUiAmount` | `PreciseDecimal` | `string` | UI-formatted transaction fee | ### INITIALIZE2 Event AMM pool initialization event. | Property | Type | JSON Type | Description | | ------------------------ | ---------------- | --------- | -------------------------------- | | `lpMint` | `string` | `string` | LP token mint address | | `mint` | `string` | `string` | Pool mint address | | `pcMint` | `string` | `string` | PC (quote) token mint address | | `userWallet` | `string` | `string` | User wallet address | | `amm` | `string` | `string` | AMM pool account address | | `poolCoinTokenAccount` | `string` | `string` | Pool coin token account | | `poolPcTokenAccount` | `string` | `string` | Pool PC token account | | `poolWithdrawQueue` | `string` | `string` | Pool withdraw queue account | | `ammTargetOrders` | `string` | `string` | AMM target orders account | | `poolTempLp` | `string` | `string` | Pool temporary LP account | | `nonce` | `number` | `number` | Pool nonce value | | `openTime` | `string` | `string` | Pool opening timestamp | | `initPcAmount` | `bigint` | `string` | Initial PC token amount | | `initPcAmountUiAmount` | `PreciseDecimal` | `string` | UI-formatted initial PC amount | | `initCoinAmount` | `bigint` | `string` | Initial coin token amount | | `initCoinAmountUiAmount` | `PreciseDecimal` | `string` | UI-formatted initial coin amount | ### SWAP Event Token swap event on Raydium AMM. | Property | Type | JSON Type | Description | | ------------------------------------ | ---------------- | --------- | ------------------------------------------ | | `amountIn` | `bigint` | `string` | Input token amount | | `amountInUiAmount` | `PreciseDecimal` | `string` | UI-formatted input amount | | `amountOut` | `bigint` | `string` | Output token amount | | `amountOutUiAmount` | `PreciseDecimal` | `string` | UI-formatted output amount | | `minimumAmountOut` | `bigint` | `string` | Minimum acceptable output amount | | `minimumAmountOutUiAmount` | `PreciseDecimal` | `string` | UI-formatted minimum output amount | | `inputMint` | `string` | `string` | Input token mint address | | `outputMint` | `string` | `string` | Output token mint address | | `userSourceTokenAccount` | `string` | `string` | User's source token account | | `userDestinationTokenAccount` | `string` | `string` | User's destination token account | | `poolCoinTokenAccount` | `string` | `string` | Pool coin token account | | `poolPcTokenAccount` | `string` | `string` | Pool PC token account | | `pricePre` | `PreciseDecimal` | `string` | Price before swap | | `pricePost` | `PreciseDecimal` | `string` | Price after swap | | `expectedAmountIn` | `bigint` | `string` | Expected input amount | | `expectedAmountInUiAmount` | `PreciseDecimal` | `string` | UI-formatted expected input amount | | `expectedAmountOut` | `bigint` | `string` | Expected output amount | | `expectedAmountOutUiAmount` | `PreciseDecimal` | `string` | UI-formatted expected output amount | | `slippageTolerance` | `number` | `number` | Slippage tolerance percentage | | `slippagePercentage` | `number` | `number` | Actual slippage percentage | | `slippageAmount` | `bigint` | `string` | Slippage amount | | `slippageAmountUiAmount` | `PreciseDecimal` | `string` | UI-formatted slippage amount | | `actualPrice` | `PreciseDecimal` | `string` | Actual swap price | | `userSourcePreBalance` | `bigint` | `string` | User source balance before swap | | `userSourcePreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted user source pre-balance | | `userSourcePostBalance` | `bigint` | `string` | User source balance after swap | | `userSourcePostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted user source post-balance | | `userDestinationPreBalance` | `bigint` | `string` | User destination balance before swap | | `userDestinationPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted user destination pre-balance | | `userDestinationPostBalance` | `bigint` | `string` | User destination balance after swap | | `userDestinationPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted user destination post-balance | | `poolCoinPreBalance` | `bigint` | `string` | Pool coin balance before swap | | `poolCoinPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool coin pre-balance | | `poolCoinPostBalance` | `bigint` | `string` | Pool coin balance after swap | | `poolCoinPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool coin post-balance | | `poolPcPreBalance` | `bigint` | `string` | Pool PC balance before swap | | `poolPcPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool PC pre-balance | | `poolPcPostBalance` | `bigint` | `string` | Pool PC balance after swap | | `poolPcPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool PC post-balance | ### ADD\_LIQUIDITY Event Liquidity provision event for Raydium AMM. | Property | Type | JSON Type | Description | | ----------------------------- | ---------------- | --------- | ----------------------------------- | | `mint` | `string` | `string` | Pool mint address | | `maxCoinAmount` | `bigint` | `string` | Maximum coin amount to deposit | | `maxCoinAmountUiAmount` | `PreciseDecimal` | `string` | UI-formatted max coin amount | | `maxPcAmount` | `bigint` | `string` | Maximum PC amount to deposit | | `maxPcAmountUiAmount` | `PreciseDecimal` | `string` | UI-formatted max PC amount | | `coinAmountIn` | `bigint` | `string` | Actual coin amount deposited | | `coinAmountInUiAmount` | `PreciseDecimal` | `string` | UI-formatted coin deposit amount | | `pcAmountIn` | `bigint` | `string` | Actual PC amount deposited | | `pcAmountInUiAmount` | `PreciseDecimal` | `string` | UI-formatted PC deposit amount | | `lpTokenAmountOut` | `bigint` | `string` | LP tokens minted | | `lpTokenAmountOutUiAmount` | `PreciseDecimal` | `string` | UI-formatted LP tokens minted | | `baseSide` | `string` | `string` | Base side specification | | `lpMintAddress` | `string` | `string` | LP token mint address | | `poolCoinToken` | `string` | `string` | Pool coin token account | | `poolPcToken` | `string` | `string` | Pool PC token account | | `userCoinTokenAccount` | `string` | `string` | User's coin token account | | `userPcTokenAccount` | `string` | `string` | User's PC token account | | `lpTokenAccount` | `string` | `string` | User's LP token account | | `userCoinPreBalance` | `bigint` | `string` | User coin balance before deposit | | `userCoinPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted user coin pre-balance | | `userCoinPostBalance` | `bigint` | `string` | User coin balance after deposit | | `userCoinPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted user coin post-balance | | `userPcPreBalance` | `bigint` | `string` | User PC balance before deposit | | `userPcPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted user PC pre-balance | | `userPcPostBalance` | `bigint` | `string` | User PC balance after deposit | | `userPcPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted user PC post-balance | | `userLpPreBalance` | `bigint` | `string` | User LP balance before deposit | | `userLpPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted user LP pre-balance | | `userLpPostBalance` | `bigint` | `string` | User LP balance after deposit | | `userLpPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted user LP post-balance | | `poolCoinPreBalance` | `bigint` | `string` | Pool coin balance before deposit | | `poolCoinPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool coin pre-balance | | `poolCoinPostBalance` | `bigint` | `string` | Pool coin balance after deposit | | `poolCoinPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool coin post-balance | | `poolPcPreBalance` | `bigint` | `string` | Pool PC balance before deposit | | `poolPcPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool PC pre-balance | | `poolPcPostBalance` | `bigint` | `string` | Pool PC balance after deposit | | `poolPcPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool PC post-balance | ### WITHDRAW\_PNL Event Profit and loss withdrawal event from Serum to AMM pool. | Property | Type | JSON Type | Description | | ----------------------------------- | ---------------- | --------- | ------------------------------------------ | | `mint` | `string` | `string` | Pool mint address | | `coinAmountOut` | `bigint` | `string` | Coin amount withdrawn | | `coinAmountOutUiAmount` | `PreciseDecimal` | `string` | UI-formatted coin withdrawal amount | | `pcAmountOut` | `bigint` | `string` | PC amount withdrawn | | `pcAmountOutUiAmount` | `PreciseDecimal` | `string` | UI-formatted PC withdrawal amount | | `poolCoinToken` | `string` | `string` | Pool coin token account | | `poolPcToken` | `string` | `string` | Pool PC token account | | `coinPnlToken` | `string` | `string` | Coin PnL token account | | `pcPnlToken` | `string` | `string` | PC PnL token account | | `serumCoinVault` | `string` | `string` | Serum coin vault account | | `serumPcVault` | `string` | `string` | Serum PC vault account | | `poolCoinPreBalance` | `bigint` | `string` | Pool coin balance before withdrawal | | `poolCoinPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool coin pre-balance | | `poolCoinPostBalance` | `bigint` | `string` | Pool coin balance after withdrawal | | `poolCoinPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool coin post-balance | | `poolPcPreBalance` | `bigint` | `string` | Pool PC balance before withdrawal | | `poolPcPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool PC pre-balance | | `poolPcPostBalance` | `bigint` | `string` | Pool PC balance after withdrawal | | `poolPcPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted pool PC post-balance | | `coinPnlPreBalance` | `bigint` | `string` | Coin PnL balance before withdrawal | | `coinPnlPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted coin PnL pre-balance | | `coinPnlPostBalance` | `bigint` | `string` | Coin PnL balance after withdrawal | | `coinPnlPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted coin PnL post-balance | | `pcPnlPreBalance` | `bigint` | `string` | PC PnL balance before withdrawal | | `pcPnlPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted PC PnL pre-balance | | `pcPnlPostBalance` | `bigint` | `string` | PC PnL balance after withdrawal | | `pcPnlPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted PC PnL post-balance | | `serumCoinVaultPreBalance` | `bigint` | `string` | Serum coin vault balance before withdrawal | | `serumCoinVaultPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted serum coin vault pre-balance | | `serumCoinVaultPostBalance` | `bigint` | `string` | Serum coin vault balance after withdrawal | | `serumCoinVaultPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted serum coin vault post-balance | | `serumPcVaultPreBalance` | `bigint` | `string` | Serum PC vault balance before withdrawal | | `serumPcVaultPreBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted serum PC vault pre-balance | | `serumPcVaultPostBalance` | `bigint` | `string` | Serum PC vault balance after withdrawal | | `serumPcVaultPostBalanceUiAmount` | `PreciseDecimal` | `string` | UI-formatted serum PC vault post-balance | ### Data Types * `bigint`: Large integer values for token amounts * `string`: Text values for addresses and identifiers * `number`: Numeric values for percentages, nonces, and timestamps * `PreciseDecimal`: High-precision decimal representation for UI display * `DecoderType`: Enum indicating the decoder type (RAYDIUM\_AMM) ### Usage The decoder automatically determines the event type and returns the appropriate structure. All monetary values are provided in both raw (`bigint`) and UI-formatted (`PreciseDecimal`) versions for flexibility in different use cases. The AMM decoder handles both coin and PC (quote) tokens with comprehensive balance tracking.