Pump Fun

This document describes the output structure for the Pump Fun decoder functions. The decoder handles four main event types: SWAP, COMPLETE, CREATE, and MIGRATE.

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 program ID
eventType	string	string	Type of event (SWAP, COMPLETE, CREATE, MIGRATE)
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

SWAP Event

Token swap event on Pump Fun bonding curve.

Property	Type	JSON Type	Description
maxSolCost	bigint	string	Maximum SOL cost for buy orders (optional)
maxSolCostUiAmount	PreciseDecimal	string	UI-formatted max SOL cost (optional)
minSolOutput	bigint	string	Minimum SOL output for sell orders (optional)
minSolOutputUiAmount	PreciseDecimal	string	UI-formatted min SOL output (optional)
mint	string	string	Token mint address
isBuy	boolean	boolean	True for buy orders, false for sell orders
account	string	string	User's token account
owner	string	string	Account owner address
bondingCurve	string	string	Bonding curve account address
solAmount	bigint	string	SOL amount involved in swap
solAmountUiAmount	PreciseDecimal	string	UI-formatted SOL amount
price	PreciseDecimal	string	Actual swap price
pricePost	PreciseDecimal	string	Price after swap
marketCapSol	bigint	string	Market cap in SOL
marketCapSolAmount	bigint	string	Market cap SOL amount
marketCapSolAmountUi	PreciseDecimal	string	UI-formatted market cap SOL
marketCapPumpSol	PreciseDecimal	string	Pump Fun market cap in SOL
marketCapPumpSolAmount	bigint	string	Pump Fun market cap SOL amount
marketCapPumpSolUiAmount	PreciseDecimal	string	UI-formatted Pump Fun market cap SOL
tokenAmount	bigint	string	Token amount involved in swap
tokenUiAmount	PreciseDecimal	string	UI-formatted token amount
virtualSolReserves	bigint	string	Virtual SOL reserves
virtualSolReservesAmount	bigint	string	Virtual SOL reserves amount
virtualSolReservesUiAmount	PreciseDecimal	string	UI-formatted virtual SOL reserves
virtualTokenReserves	bigint	string	Virtual token reserves
virtualTokenReservesAmount	bigint	string	Virtual token reserves amount
virtualTokenReservesUiAmount	PreciseDecimal	string	UI-formatted virtual token reserves
bondingCurvePrePercentage	number	number	Bonding curve completion before swap (%)
bondingCurvePostPercentage	number	number	Bonding curve completion after swap (%)
bondingPreBalance	bigint	string	Bonding curve balance before swap
bondingPreBalanceUiAmount	PreciseDecimal	string	UI-formatted bonding pre-balance
bondingPreBalanceAmount	bigint	string	Bonding pre-balance amount
bondingPostBalance	bigint	string	Bonding curve balance after swap
bondingPostBalanceUiAmount	PreciseDecimal	string	UI-formatted bonding post-balance
bondingPostBalanceAmount	bigint	string	Bonding post-balance amount
userTokenPreBalance	bigint	string	User token balance before swap
userTokenPreBalanceUiAmount	PreciseDecimal	string	UI-formatted user token pre-balance
userTokenPreBalanceAmount	bigint	string	User token pre-balance amount
userTokenPostBalance	bigint	string	User token balance after swap
userTokenPostBalanceUiAmount	PreciseDecimal	string	UI-formatted user token post-balance
userTokenPostBalanceAmount	bigint	string	User token post-balance amount
realSolReserves	bigint	string	Real SOL reserves
realSolReservesUiAmount	PreciseDecimal	string	UI-formatted real SOL reserves
realTokenReserves	bigint	string	Real token reserves
realTokenReservesUiAmount	PreciseDecimal	string	UI-formatted real token reserves
feeRecipient	string	string	Fee recipient address
feeBasisPoints	bigint	string	Fee in basis points
fee	bigint	string	Fee amount
creator	string	string	Token creator address
creatorFeeBasisPoints	bigint	string	Creator fee in basis points
creatorFee	bigint	string	Creator fee amount

COMPLETE Event

Bonding curve completion event when token graduates to Raydium.

Property	Type	JSON Type	Description
user	string	string	User who completed the curve
mint	string	string	Token mint address
bondingCurve	string	string	Bonding curve account address
timestamp	string	string	Event timestamp

CREATE Event

Token creation event on Pump Fun.

Property	Type	JSON Type	Description
name	string	string	Token name
symbol	string	string	Token symbol
uri	string	string	Token metadata URI
creator	string	string	Token creator address
mint	string	string	Token mint address
bondingCurve	string	string	Bonding curve account address
timestamp	string	string	Creation timestamp
virtualTokenReserves	string	string	Initial virtual token reserves (optional)
virtualSolReserves	string	string	Initial virtual SOL reserves (optional)
realTokenReserves	string	string	Initial real token reserves (optional)
tokenTotalSupply	string	string	Total token supply (optional)

MIGRATE Event

Token migration event when moving from bonding curve to Raydium.

Property	Type	JSON Type	Description
user	string	string	User who initiated migration
mint	string	string	Token mint address
mintAmount	bigint	string	Amount of tokens minted
mintAmountUiAmount	PreciseDecimal	string	UI-formatted mint amount
solAmount	bigint	string	SOL amount involved in migration
solAmountUiAmount	PreciseDecimal	string	UI-formatted SOL amount
poolMigrationFee	bigint	string	Pool migration fee
poolMigrationFeeUiAmount	PreciseDecimal	string	UI-formatted migration fee
bondingCurve	string	string	Bonding curve account address
timestamp	string	string	Migration timestamp
pool	string	string	Destination pool address

Data Types

• bigint: Large integer values for token amounts and prices

• string: Text values for addresses, names, symbols, and timestamps

• number: Numeric values for percentages and other integer values

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

• PreciseDecimal: High-precision decimal representation for UI display

• DecoderType: Enum indicating the decoder type (PUMP_FUN)

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 Pump Fun decoder handles bonding curve mechanics with comprehensive price tracking, market cap calculations, and virtual/real reserve management.