Swap Overview

Why Choose Vybe for Swaps?

Swapping tokens is the most common operation in DeFi, but not all swap APIs are created equal. Most aggregators add unnecessary overhead that costs you SOL and slows down execution.

Vybe Router was built from the ground up to be lean and efficient:

• Direct DEX program calls (no intermediary accounts)
• Native fee handling (no extra instructions)
• Automatic protocol selection (finds the best pool)
• Fallback to aggregators when needed (Titan, Jupiter)
• Privy-optimized transactions that preserve compression
• Gasless mode for onboarding new users

The result? Your users get better execution, pay less in fees, and experience fewer failed transactions.

Value Proposition: Direct DEX calls. No middleman.

The Problem with Aggregators

Jupiter and Titan use a common pattern that creates significant overhead: they create temporary fee accounts for every swap.

The Hidden Cost

Every swap through an aggregator opens fee token accounts—one for the buy side and one for the sell side. Each account requires ~0.002 SOL in rent:

Traditional Aggregator Flow:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Your Wallet → [Fee Account A] → DEX → [Fee Account B] → Your Wallet
                    ↓                        ↓
               ~0.002 SOL               ~0.002 SOL
            (PERMANENTLY LOST)       (PERMANENTLY LOST)

Extra instructions for:
• Creating fee accounts (buy side)
• Creating fee accounts (sell side)
• Transferring through temp accounts
• Extracting referral fees

The worst part? These 0.002 SOL rent costs are not reclaimable. Every swap permanently burns ~0.004 SOL in account rent, regardless of trade size.

Real Cost Example

For active traders and bots, this adds up to significant losses.

Additional overhead:

• Larger transaction size (more instructions)
• Slower execution (more accounts to create)
• More points of failure

The Vybe Solution

Vybe Router makes direct DEX calls with native fee transfers—no temporary accounts, no rent overhead:

Vybe Router Flow:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Your Wallet ────────────→ DEX ────────────→ Your Wallet
      │
      └──→ Fee Vault (direct transfer from swap tokens)

Minimal instructions:
• Setup ATAs if needed
• Transfer fee (from input OR output)
• Execute swap

Smart Fee Extraction

Instead of creating fee accounts, Vybe extracts fees directly from your swap tokens:

• Swapping SOL → Token? Fee comes from your SOL input (before swap)
• Swapping Token → SOL? Fee comes from SOL output (after swap)
• Token → Token? Fee from whichever side is vetted (SOL/USDC/USDT)

No accounts created. No rent lost. Just a simple token transfer to our fee vault.

Result:

• Smaller transaction size
• Zero rent overhead (saves 0.004 SOL per swap)
• Faster execution
• Fewer failure points

Head-to-Head Comparison

The Complete Swap Flow

Building a swap with Vybe is a simple 5-step process:

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│  1. GET QUOTE        →  See expected output, price impact   │
│     /trading/swap-quote                                     │
│                                                             │
│  2. BUILD TX         →  Get unsigned transaction (base64)   │
│     POST /trading/swap                                      │
│                                                             │
│  3. SIGN             →  User signs with wallet adapter      │
│     (client-side)                                           │
│                                                             │
│  4. SUBMIT           →  Send raw transaction to Solana      │
│     connection.sendRawTransaction()                         │
│                                                             │
│  5. CONFIRM          →  Wait for confirmation               │
│     connection.confirmTransaction()                         │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Quick Start Example

# Step 1: Get a quote to see expected output
curl -X GET "https://api.vybenetwork.com/trading/swap-quote" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 0.1,
    "inputMint": "So11111111111111111111111111111111111111112",
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
  }'

# Step 2: Build the swap transaction
curl -X POST "https://api.vybenetwork.com/trading/swap" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "YourWalletAddressHere",
    "amount": 0.1,
    "inputMint": "So11111111111111111111111111111111111111112",
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "router": "vybe",
    "slippage": 1
  }'

Choosing a Router

Vybe supports three router modes. Choose based on your needs:

Smart Fallback

When using router: "vybe", if no direct route exists, the API automatically falls back:

vybe → titan → jupiter

To enforce direct integration only (no fallback), use:

{
  "router": "vybe",
  "vybeOnly": true
}

Privy Embedded Wallet Support

Building with Privy embedded wallets? Vybe has you covered.

Privy requires transactions with placeholder blockhashes that get replaced during signing. The naive approach (deserialize → modify → reserialize) destroys Address Lookup Table compression, often doubling transaction size.

Vybe's privy: true mode solves this:

{
  "wallet": "...",
  "amount": 1,
  "inputMint": "...",
  "outputMint": "...",
  "privy": true
}

What happens:

1. Transaction built with real blockhash (for validation)
2. Transaction simulated to catch errors
3. Blockhash bytes patched to placeholder (1111...1111)
4. Privy replaces placeholder during signing

Result: Transaction stays at ~850 bytes instead of ballooning to ~1,800 bytes.

See Privy Integration for full implementation details.

Common Use Cases

In This Section

• Get Quote - Preview swap outcomes before execution
• Build Transaction - Create unsigned swap transactions
• Supported Protocols - All integrated DEXs and when to use each
• Slippage & Fees - Configure protection and understand fees
• Gasless Mode - Execute without holding SOL for gas
• Privy Integration - Embedded wallet support