# 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.lyslabs.ai/decoders/raydium-amm.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.