Launch your token to see activity
technical documentation v3.0.1-alpha-build.4927-sha256:7f8a9b

leveragepump.fun
protocol specification

comprehensive technical documentation for the leveragepump.fun synthetic leverage protocol. solana mainnet-beta. last updated: 2026-05-22 19:22:14 UTC.

table of contents

1. executive protocol overview

The leveragepump.fun protocol represents a paradigm shift in decentralized leveraged exposure mechanisms, implementing a novel approach to synthetic leverage through algorithmic bonding curve repricing on the Solana blockchain (65,000+ TPS theoretical maximum, 400ms block times, sub-second finality via Gulf Stream mempool propagation and Turbine block propagation). By combining Pyth Network's institutional-grade oracle infrastructure (400ms update frequency, 50+ price feeds, <0.5% deviation threshold, 99.9% uptime SLA) with proprietary virtual bonding curve mathematics, leveragepump.fun enables synthetic leverage positions of 2x to 10x on supported reference assets without traditional perp mechanics, margin requirements, funding rates, or liquidation risks inherent in both centralized (Binance, Bybit, dYdX) and decentralized (GMX, Gains Network, Synthetix) perpetual swap protocols.

1.1 Core Value Proposition Matrix

Synthetic Leverage (SL)

Tokenized leverage exposure through bonding curve repricing without perp mechanics, orderbooks, or counterparty risk. Price adjustments follow: P(t) = P₀ × (1 + L × ΔO) where L ∈ 10.

Zero Liquidation Risk (ZLR)

Users hold actual SPL tokens with intrinsic value backed by virtual SOL reserves. No margin calls, no liquidation cascades, no forced position closures. Token value can approach zero but never triggers liquidation.

Instant Liquidity (ILP)

Continuous bonding curve provides 24/7/365 liquidity with deterministic pricing. No spread, no slippage beyond curve math, immediate execution. Liquidity depth proportional to market cap.

Fair Launch (FL)

Uniform bonding curve starting at 30 virtual SOL and 1,073,000,000 virtual tokens. No presales, no insider allocations, no team tokens. Pure demand-driven price discovery.

1.2 Supported Reference Assets

The protocol currently supports the following assets for synthetic leverage, with Pyth price feed integration:

SOL
SOL/USD
BTC
BTC/USD
ETH
ETH/USD
DOGE
DOGE/USD
SHIB
SHIB/USD
FLOKI
FLOKI/USD
SPX
SPX/USD
BONK
BONK/USD
PEPE
PEPE/USD
WIF
WIF/USD

2. multi-layer system architecture

The leveragepump.fun protocol implements a hexagonal architecture pattern with domain-driven design principles, ensuring separation of concerns, testability, and maintainability across all system components. The architecture consists of six distinct layers, each with well-defined interfaces and responsibilities, communicating through asynchronous message passing and event-driven patterns.

2.1 Architectural Layer Stack

Presentation Layer (L1)

Next.js 16+ React Server Components, SSR/SSG hybrid rendering, Wallet Adapter integration (@solana/wallet-adapter-react), real-time WebSocket price feeds, optimistic UI updates with rollback capability

Application Layer (L2)

Business logic orchestration, saga pattern for complex transactions, CQRS for read/write separation, event sourcing for audit trails, circuit breakers for external service failures

Domain Layer (L3)

Core domain entities (Token, BondingCurve, LeveragePosition), value objects, domain services, aggregate roots, invariant enforcement, business rule validation

Oracle Layer (L4)

Pyth Network SDK integration, price feed aggregation, TWAP calculation (Time-Weighted Average Price), confidence interval validation, staleness detection (&gt;60s threshold)

Infrastructure Layer (L5)

Solana RPC client (@solana/web3.js), transaction construction, account management, ATA (Associated Token Account) handling, priority fee estimation

Persistence Layer (L6)

Supabase PostgreSQL for metadata, Redis for caching, IPFS for immutable token metadata, Arweave for permanent storage

3. advanced mathematical framework

The leveragepump.fun protocol employs sophisticated mathematical models derived from automated market maker (AMM) literature, modified to achieve synthetic leverage through bonding curve repricing. The following equations govern all price calculations, leverage adjustments, and graduation thresholds.

3.1 Core Price Equation (CPE)

The fundamental price calculation for any leveraged token at time t:

P(t) = P₀ × (1 + L × ΔO(t)) × (1 + β × V(t))

Where:

  • • P(t) = Current token price in SOL
  • • P₀ = Initial token price (30 SOL / 1,073,000,000 tokens)
  • • L = Leverage multiplier ∈ 10
  • • ΔO(t) = Normalized oracle price change: (O(t) - O₀) / O₀
  • • β = Volatility coefficient (0.01 for stability)
  • • V(t) = Trading volume velocity factor

3.2 Virtual Bonding Curve Formula (VBCF)

The constant product bonding curve with leverage-adjusted virtual reserves:

(R_virtual + ΔR) × (S_virtual - ΔS) = k × (1 + αL)²

Where:

  • • R_virtual = 30 SOL (initial virtual reserve)
  • • S_virtual = 1,073,000,000 tokens (initial virtual supply)
  • • k = Constant product invariant (R × S)
  • • α = Leverage curve coefficient (0.15)
  • • L = Selected leverage multiplier
  • • ΔR, ΔS = Change in reserves and supply

3.3 Graduation Threshold Calculation

Graduation occurs when the following condition is satisfied:

R_real ≥ 85 SOL

At this threshold, the bonding curve completes and the token transitions to open market trading. The 85 SOL threshold represents the point at which sufficient liquidity has been established for sustainable price discovery outside the virtual curve mechanism.

4. oracle integration layer

Price oracle integration is critical for accurate leverage calculations. The protocol uses Pyth Network's first-party oracle infrastructure with multiple redundancy layers, confidence scoring, and deviation checks to ensure price accuracy and manipulation resistance.

4.1 Oracle Specifications

400ms
Update Frequency
Sub-second price updates
50+
Price Sources
Institutional feed publishers
0.5%
Deviation Threshold
Maximum price variance
60s
Staleness Limit
Maximum acceptable age
0.8
Confidence Min
Minimum confidence score
99.9%
Uptime SLA
Annual availability target
120ms
Latency P50
Median update latency
800ms
Latency P99
99th percentile latency

5. virtual bonding curve mechanics

The virtual bonding curve serves as the primary market maker for all tokens prior to graduation. Unlike traditional AMMs that require actual liquidity deposits, the virtual curve operates with virtual reserves that algorithmically adjust based on trading activity and oracle price movements.

5.1 Initial Virtual Parameters

30 SOL
Initial Virtual Reserve
1.073B
Initial Virtual Supply
85 SOL
Graduation Threshold

5.2 Curve Dynamics

  • Price Discovery: Exponential price growth as supply decreases, following k = R × S invariant
  • Leverage Adjustment: Oracle price movements amplify token price by leverage multiplier L
  • Slippage: Deterministic based on trade size relative to pool depth: slippage = (ΔS / S)²
  • Progress: Calculated as R_real / 85 SOL, displayed as percentage to graduation

6. synthetic leverage computation engine

The Synthetic Leverage Engine (SLE) is the core innovation of the leveragepump.fun protocol. It computes leveraged price exposure through real-time bonding curve adjustments based on oracle price feeds, eliminating the need for collateral, margin, or liquidation mechanisms.

6.1 Leverage Multiplier Matrix

2x
Conservative
2x oracle price movement
3x
Moderate
3x oracle price movement
5x
Aggressive
5x oracle price movement
10x
Degen
10x oracle price movement

6.2 Computation Flow

1.Pyth oracle publishes price update for reference asset
2.SLE calculates price delta: ΔO = (O_new - O_old) / O_old
3.Leverage multiplier applied: ΔP = 1 + (L × ΔO)
4.Bonding curve repriced: P_new = P_old × ΔP
5.New trades execute against repriced curve

7. graduation protocol (85 SOL threshold)

When a token's real SOL reserves reach 85 SOL, it automatically graduates from the virtual bonding curve. This threshold, identical to pump.fun's graduation mechanism, represents sufficient liquidity for sustainable open market trading and price discovery through external AMMs.

7.1 Graduation Requirements

Primary: Reserve Threshold

Real SOL reserves ≥ 85 SOL in bonding curve

Secondary: Holder Count

Minimum 50 unique wallet holders

Tertiary: Trading Volume

24h volume > 5,000 USD equivalent

Quaternary: Token Age

Minimum 1 hour since creation

7.2 Post-Graduation Mechanics

  • • Bonding curve completes and becomes read-only
  • • Token trades on the open market
  • • Leverage characteristics continue through market forces
  • • Price discovery shifts to orderbook/AMM mechanisms
  • • Creator continues receiving trading fees

8. economic model & fee structure

The protocol maintains a transparent, creator-centric fee structure that aligns incentives between token creators and traders. All fees are clearly displayed before transaction execution and automatically distributed through smart contract logic.

8.1 Fee Schedule

Fee TypeAmountRecipientDescription
Deployment~0.02 SOLNetworkSolana transaction fee for token creation
Trading Fee1.0%Creator (100%)Fee on all buy/sell transactions

8.2 Creator Economics

Token creators receive 100% of trading fees, creating sustainable revenue streams for successful tokens. This aligns creator incentives with token success and community growth. Fees are automatically transferred to the creator wallet on each trade through the pump.fun protocol fee mechanism.

9. security architecture

Security is paramount in the leveragepump.fun protocol. Multiple safeguards protect user funds and ensure protocol integrity across all operations. The protocol operates as a non-custodial system with no admin keys or upgrade mechanisms.

9.1 Security Measures

Non-Custodial Design

Users maintain full control of funds. Protocol never holds user assets.

Immutable Curves

Bonding curve parameters cannot be changed post-deployment.

Oracle Redundancy

Multiple price sources prevent manipulation attacks.

No Admin Keys

Protocol operates without centralized control or upgrade authority.

10. advanced implementation details

10.1 Price Calculation Algorithm

function calculateTokenPrice(
  basePrice: BN,
  oraclePrice: BN,
  initialOraclePrice: BN,
  leverage: number,
  virtualSol: BN,
  virtualTokens: BN
): BN {
  // Calculate oracle delta
  const oracleDelta = oraclePrice
    .sub(initialOraclePrice)
    .mul(PRECISION)
    .div(initialOraclePrice);
  
  // Apply leverage multiplier
  const leverageDelta = oracleDelta.mul(new BN(leverage)).div(PRECISION);
  
  // Calculate new price
  const newPrice = basePrice.mul(PRECISION.add(leverageDelta)).div(PRECISION);
  
  return newPrice;
}

11. api reference

The leveragepump.fun protocol exposes a comprehensive API for developers building integrations, trading bots, analytics dashboards, and other applications.

11.1 REST Endpoints

GET /api/tokens

Retrieve all tokens with leverage metadata, prices, and graduation status

GET /api/tokens/[id]

Get detailed information for a specific token including bonding curve data

GET /api/price/[asset]

Get current oracle price for reference asset (SOL, BTC, ETH, etc.)

11.2 Response Format

{
  "token": {
    "mint": "7x8y9z...",
    "name": "Long SOL 3x",
    "symbol": "SOL3X",
    "leverage": 3,
    "direction": "LONG",
    "referenceAsset": "SOL",
    "price": 0.000042,
    "marketCap": 45000,
    "virtualSol": 45.5,
    "graduated": false,
    "progress": 53.5,
    "createdAt": "2026-05-22T19:30:00Z"
  }
}

12. frequently asked questions

Q: How does synthetic leverage work?

Synthetic leverage uses bonding curve repricing to simulate leveraged returns. When the reference asset moves, the token price adjusts by the leverage multiplier, creating leveraged exposure without margin requirements or liquidation risks.

Q: Can I get liquidated?

No. Unlike traditional perps, synthetic leverage tokens cannot be liquidated. You hold actual SPL tokens that can always be sold back to the bonding curve, even at a loss. There are no margin calls or forced position closures.

Q: What happens at graduation?

At 85 SOL in the bonding curve, the token graduates. The virtual curve completes and the token transitions to trading on the open market. The leverage characteristics continue through market forces and arbitrage.

Q: How is the price calculated?

Price follows the formula: P(t) = P₀ × (1 + L × ΔO), where P₀ is the initial price, L is the leverage multiplier (2x-10x), and ΔO is the percentage change in the oracle price. This creates amplified price movements proportional to leverage.

Q: What are the fees?

Token creation costs ~0.02 SOL (network fee). Trading has a 1% fee that goes 100% to the token creator. There are no protocol fees, no funding rates, and no hidden costs.

powered by
solana·pyth·pump.fun
launch a coin