Pump Swap

This document describes the output structure for the Pump Fun AMM decoder functions. The decoder handles four main event types: CREATE_POOL, SWAP (with buy/sell variants), DEPOSIT, and WITHDRAW.

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	Pump Fun AMM program ID
eventType	string	string	Type of event (CREATE_POOL, SWAP, DEPOSIT, WITHDRAW)
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

CREATE_POOL Event

Pool creation event for Pump Fun AMM.

Property	Type	JSON Type	Description
index	number	number	Pool index
baseAmountIn	bigint	string	Base token amount deposited
baseAmountInUiAmount	PreciseDecimal	string	UI-formatted base amount
quoteAmountIn	bigint	string	Quote token amount deposited
quoteAmountInUiAmount	PreciseDecimal	string	UI-formatted quote amount
timestamp	string	string	Pool creation timestamp
creator	string	string	Pool creator address
baseMint	string	string	Base token mint address
quoteMint	string	string	Quote token mint address
baseMintDecimals	number	number	Base token decimal places
quoteMintDecimals	number	number	Quote token decimal places
poolBaseAmount	bigint	string	Pool base token amount
poolBaseAmountUiAmount	PreciseDecimal	string	UI-formatted pool base amount
poolQuoteAmount	bigint	string	Pool quote token amount
poolQuoteAmountUiAmount	PreciseDecimal	string	UI-formatted pool quote amount
minimumLiquidity	bigint	string	Minimum liquidity amount
minimumLiquidityUiAmount	PreciseDecimal	string	UI-formatted minimum liquidity
initialLiquidity	bigint	string	Initial liquidity amount
initialLiquidityUiAmount	PreciseDecimal	string	UI-formatted initial liquidity
lpTokenAmountOut	bigint	string	LP tokens minted
lpTokenAmountOutUiAmount	PreciseDecimal	string	UI-formatted LP tokens minted
poolBump	number	number	Pool account bump seed
pool	string	string	Pool account address
lpMint	string	string	LP token mint address
userBaseTokenAccount	string	string	User's base token account
userQuoteTokenAccount	string	string	User's quote token account

SWAP Event

Token swap event on Pump Fun AMM pool. The swap event has different properties depending on whether it's a buy or sell order.

Common SWAP Properties

Property	Type	JSON Type	Description
timestamp	string	string	Swap timestamp
lpFeeBasisPoints	number	number	LP fee in basis points
lpFee	bigint	string	LP fee amount
lpFeeUiAmount	PreciseDecimal	string	UI-formatted LP fee
protocolFeeBasisPoints	number	number	Protocol fee in basis points
protocolFee	bigint	string	Protocol fee amount
protocolFeeUiAmount	PreciseDecimal	string	UI-formatted protocol fee
userBaseTokenReserves	bigint	string	User base token reserves
userBaseTokenReservesUiAmount	PreciseDecimal	string	UI-formatted user base reserves
userQuoteTokenReserves	bigint	string	User quote token reserves
userQuoteTokenReservesUiAmount	PreciseDecimal	string	UI-formatted user quote reserves
poolBaseTokenReserves	bigint	string	Pool base token reserves
poolBaseTokenReservesUiAmount	PreciseDecimal	string	UI-formatted pool base reserves
poolQuoteTokenReserves	bigint	string	Pool quote token reserves
poolQuoteTokenReservesUiAmount	PreciseDecimal	string	UI-formatted pool quote reserves
pool	string	string	Pool account address
user	string	string	User account address
userBaseTokenAccount	string	string	User's base token account
userQuoteTokenAccount	string	string	User's quote token account
protocolFeeRecipient	string	string	Protocol fee recipient address
protocolFeeRecipientTokenAccount	string	string	Protocol fee recipient token account
price	PreciseDecimal	string	Actual swap price
pricePost	PreciseDecimal	string	Price after swap
userBasePreBalance	bigint	string	User base balance before swap
userBasePreBalanceUiAmount	PreciseDecimal	string	UI-formatted user base pre-balance
userBasePostBalance	bigint	string	User base balance after swap
userBasePostBalanceUiAmount	PreciseDecimal	string	UI-formatted user base post-balance
userQuotePreBalance	bigint	string	User quote balance before swap
userQuotePreBalanceUiAmount	PreciseDecimal	string	UI-formatted user quote pre-balance
userQuotePostBalance	bigint	string	User quote balance after swap
userQuotePostBalanceUiAmount	PreciseDecimal	string	UI-formatted user quote post-balance
poolBasePreBalance	bigint	string	Pool base balance before swap
poolBasePreBalanceUiAmount	PreciseDecimal	string	UI-formatted pool base pre-balance
poolBasePostBalance	bigint	string	Pool base balance after swap
poolBasePostBalanceUiAmount	PreciseDecimal	string	UI-formatted pool base post-balance
poolQuotePreBalance	bigint	string	Pool quote balance before swap
poolQuotePreBalanceUiAmount	PreciseDecimal	string	UI-formatted pool quote pre-balance
poolQuotePostBalance	bigint	string	Pool quote balance after swap
poolQuotePostBalanceUiAmount	PreciseDecimal	string	UI-formatted pool quote post-balance
quoteMint	string	string	Quote token mint address
baseMint	string	string	Base token mint address

BUY Order Properties

Property	Type	JSON Type	Description
isBuy	boolean	boolean	True for buy orders
baseAmountOut	bigint	string	Base tokens received
baseAmountOutUiAmount	PreciseDecimal	string	UI-formatted base tokens received
maxQuoteAmountIn	bigint	string	Maximum quote tokens to spend
maxQuoteAmountInUiAmount	PreciseDecimal	string	UI-formatted max quote spend
quoteAmountIn	bigint	string	Actual quote tokens spent
quoteAmountInUiAmount	PreciseDecimal	string	UI-formatted quote tokens spent
quoteAmountInWithLpFee	bigint	string	Quote amount including LP fee
quoteAmountInWithLpFeeUiAmount	PreciseDecimal	string	UI-formatted quote amount with LP fee
userQuoteAmountIn	bigint	string	User's quote amount input
userQuoteAmountInUiAmount	PreciseDecimal	string	UI-formatted user quote input

SELL Order Properties

Property	Type	JSON Type	Description
isBuy	boolean	boolean	False for sell orders
baseAmountIn	bigint	string	Base tokens sold
baseAmountInUiAmount	PreciseDecimal	string	UI-formatted base tokens sold
minQuoteAmountOut	bigint	string	Minimum quote tokens to receive
minQuoteAmountOutUiAmount	PreciseDecimal	string	UI-formatted min quote receive
quoteAmountOut	bigint	string	Actual quote tokens received
quoteAmountOutUiAmount	PreciseDecimal	string	UI-formatted quote tokens received
quoteAmountOutWithoutLpFee	bigint	string	Quote amount excluding LP fee
quoteAmountOutWithoutLpFeeUiAmount	PreciseDecimal	string	UI-formatted quote amount without LP fee
userQuoteAmountOut	bigint	string	User's quote amount output
userQuoteAmountOutUiAmount	PreciseDecimal	string	UI-formatted user quote output

DEPOSIT Event

Liquidity deposit event for Pump Fun AMM.

Property	Type	JSON Type	Description
timestamp	string	string	Deposit timestamp
lpTokenAmountOut	bigint	string	LP tokens minted
lpTokenAmountOutUiAmount	PreciseDecimal	string	UI-formatted LP tokens minted
maxBaseAmountIn	bigint	string	Maximum base tokens to deposit
maxBaseAmountInUiAmount	PreciseDecimal	string	UI-formatted max base deposit
maxQuoteAmountIn	bigint	string	Maximum quote tokens to deposit
maxQuoteAmountInUiAmount	PreciseDecimal	string	UI-formatted max quote deposit
userBaseTokenReserves	bigint	string	User base token reserves
userBaseTokenReservesUiAmount	PreciseDecimal	string	UI-formatted user base reserves
userQuoteTokenReserves	bigint	string	User quote token reserves
userQuoteTokenReservesUiAmount	PreciseDecimal	string	UI-formatted user quote reserves
poolBaseTokenReserves	bigint	string	Pool base token reserves
poolBaseTokenReservesUiAmount	PreciseDecimal	string	UI-formatted pool base reserves
poolQuoteTokenReserves	bigint	string	Pool quote token reserves
poolQuoteTokenReservesUiAmount	PreciseDecimal	string	UI-formatted pool quote reserves
baseAmountIn	bigint	string	Actual base tokens deposited
baseAmountInUiAmount	PreciseDecimal	string	UI-formatted base deposit amount
quoteAmountIn	bigint	string	Actual quote tokens deposited
quoteAmountInUiAmount	PreciseDecimal	string	UI-formatted quote deposit amount
lpMintSupply	bigint	string	LP mint total supply
lpMintSupplyUiAmount	PreciseDecimal	string	UI-formatted LP mint supply
pool	string	string	Pool account address
user	string	string	User account address
userBaseTokenAccount	string	string	User's base token account
userQuoteTokenAccount	string	string	User's quote token account
userPoolTokenAccount	string	string	User's LP token account
userBasePreBalance	bigint	string	User base balance before deposit
userBasePreBalanceUiAmount	PreciseDecimal	string	UI-formatted user base pre-balance
userBasePostBalance	bigint	string	User base balance after deposit
userBasePostBalanceUiAmount	PreciseDecimal	string	UI-formatted user base post-balance
userQuotePreBalance	bigint	string	User quote balance before deposit
userQuotePreBalanceUiAmount	PreciseDecimal	string	UI-formatted user quote pre-balance
userQuotePostBalance	bigint	string	User quote balance after deposit
userQuotePostBalanceUiAmount	PreciseDecimal	string	UI-formatted user quote post-balance
poolBasePreBalance	bigint	string	Pool base balance before deposit
poolBasePreBalanceUiAmount	PreciseDecimal	string	UI-formatted pool base pre-balance
poolBasePostBalance	bigint	string	Pool base balance after deposit
poolBasePostBalanceUiAmount	PreciseDecimal	string	UI-formatted pool base post-balance
poolQuotePreBalance	bigint	string	Pool quote balance before deposit
poolQuotePreBalanceUiAmount	PreciseDecimal	string	UI-formatted pool quote pre-balance
poolQuotePostBalance	bigint	string	Pool quote balance after deposit
poolQuotePostBalanceUiAmount	PreciseDecimal	string	UI-formatted pool quote post-balance
quoteMint	string	string	Quote token mint address
baseMint	string	string	Base token mint address
lpMintPreBalance	bigint	string	LP mint balance before deposit
lpMintPreBalanceUiAmount	PreciseDecimal	string	UI-formatted LP mint pre-balance
lpMintPostBalance	bigint	string	LP mint balance after deposit
lpMintPostBalanceUiAmount	PreciseDecimal	string	UI-formatted LP mint post-balance
lpMint	string	string	LP token mint address

WITHDRAW Event

Liquidity withdrawal event for Pump Fun AMM.

Property	Type	JSON Type	Description
timestamp	string	string	Withdrawal timestamp
lpTokenAmountIn	bigint	string	LP tokens burned
lpTokenAmountInUiAmount	PreciseDecimal	string	UI-formatted LP tokens burned
minBaseAmountOut	bigint	string	Minimum base tokens to receive
minBaseAmountOutUiAmount	PreciseDecimal	string	UI-formatted min base receive
minQuoteAmountOut	bigint	string	Minimum quote tokens to receive
minQuoteAmountOutUiAmount	PreciseDecimal	string	UI-formatted min quote receive
userBaseTokenReserves	bigint	string	User base token reserves
userBaseTokenReservesUiAmount	PreciseDecimal	string	UI-formatted user base reserves
userQuoteTokenReserves	bigint	string	User quote token reserves
userQuoteTokenReservesUiAmount	PreciseDecimal	string	UI-formatted user quote reserves
poolBaseTokenReserves	bigint	string	Pool base token reserves
poolBaseTokenReservesUiAmount	PreciseDecimal	string	UI-formatted pool base reserves
poolQuoteTokenReserves	bigint	string	Pool quote token reserves
poolQuoteTokenReservesUiAmount	PreciseDecimal	string	UI-formatted pool quote reserves
baseAmountOut	bigint	string	Actual base tokens withdrawn
baseAmountOutUiAmount	PreciseDecimal	string	UI-formatted base withdrawal amount
quoteAmountOut	bigint	string	Actual quote tokens withdrawn
quoteAmountOutUiAmount	PreciseDecimal	string	UI-formatted quote withdrawal amount
lpMintSupply	bigint	string	LP mint total supply
lpMintSupplyUiAmount	PreciseDecimal	string	UI-formatted LP mint supply
pool	string	string	Pool account address
user	string	string	User account address
userBaseTokenAccount	string	string	User's base token account
userQuoteTokenAccount	string	string	User's quote token account
userPoolTokenAccount	string	string	User's LP token account
userBasePreBalance	bigint	string	User base balance before withdrawal
userBasePreBalanceUiAmount	PreciseDecimal	string	UI-formatted user base pre-balance
userBasePostBalance	bigint	string	User base balance after withdrawal
userBasePostBalanceUiAmount	PreciseDecimal	string	UI-formatted user base post-balance
userQuotePreBalance	bigint	string	User quote balance before withdrawal
userQuotePreBalanceUiAmount	PreciseDecimal	string	UI-formatted user quote pre-balance
userQuotePostBalance	bigint	string	User quote balance after withdrawal
userQuotePostBalanceUiAmount	PreciseDecimal	string	UI-formatted user quote post-balance
poolBasePreBalance	bigint	string	Pool base balance before withdrawal
poolBasePreBalanceUiAmount	PreciseDecimal	string	UI-formatted pool base pre-balance
poolBasePostBalance	bigint	string	Pool base balance after withdrawal
poolBasePostBalanceUiAmount	PreciseDecimal	string	UI-formatted pool base post-balance
poolQuotePreBalance	bigint	string	Pool quote balance before withdrawal
poolQuotePreBalanceUiAmount	PreciseDecimal	string	UI-formatted pool quote pre-balance
poolQuotePostBalance	bigint	string	Pool quote balance after withdrawal
poolQuotePostBalanceUiAmount	PreciseDecimal	string	UI-formatted pool quote post-balance
quoteMint	string	string	Quote token mint address
baseMint	string	string	Base token mint address
lpMintPreBalance	bigint	string	LP mint balance before withdrawal
lpMintPreBalanceUiAmount	PreciseDecimal	string	UI-formatted LP mint pre-balance
lpMintPostBalance	bigint	string	LP mint balance after withdrawal
lpMintPostBalanceUiAmount	PreciseDecimal	string	UI-formatted LP mint post-balance
lpMint	string	string	LP token mint address

Data Types

• bigint: Large integer values for token amounts and fees

• string: Text values for addresses and identifiers

• number: Numeric values for decimals, indices, and percentages

• boolean: True/false values for buy/sell indicators

• PreciseDecimal: High-precision decimal representation for UI display

• DecoderType: Enum indicating the decoder type (PUMP_FUN_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. SWAP events are discriminated by the isBuy property to determine if it's a buy or sell order, with different specific properties for each type.