Skip to main content

​
Swap model

Swaps are abstractions on AMM transfers, procotol & chain agnostic. Identifier on Mobula: swap Note on Swap Direction and Amount Signs:
In a swap, tokens move between addressToken0 and addressToken1. The direction of the swap and the meaning of the amounts can be understood as follows:
  • If amount0 is positive, the token at addressToken0 is going into the pool, and it is being swapped for the token at addressToken1.
  • If amount0 is negative, the token at addressToken0 is coming out of the pool, meaning the swap is from addressToken1 to addressToken0.
The amount1 value reflects the opposite movement:
  • Positive → token enters the pool
  • Negative → token leaves the pool
In simple terms:
  • Positive amount0 → swapping Token0 → Token1
  • Negative amount0 → swapping Token1 → Token0
Example: SOL → SUPER Agent Swap: 
{
  "ratio": 1608943.9743539998,
  "swapSenderAddress": "CxNUEf6Aw8o8i84GfyPE3ZcKKpa4XRyuXEwypECbdjV8",
  "poolAddress": "EQ4p8CGFJz92FkL8H4eeN3txR1ohp613ZWdVkjFromED",
  "rawAmount0": "1000000000",
  "rawAmount1": "-1608943974354",
  "poolType": "raydium",
  "swapType": "REGULAR",
  "addressToken0": "So11111111111111111111111111111111111111112", //SOL
  "addressToken1": "GqwD19dg25154kJ8kK2FLCeXZJzPDs6CPaUhdsW9pump", //SuperAgent
  "blockHeight": "1737653025",
  "transactionHash": "3QbHFowf7xeW9BM2fR2TKfYcmUKNnhQN7XyqdEmqS3SWKtfEw686RDxKaFxp3dGGc7D1RZuHaCrzSJEkg3hn9s5A",
  "transactionSenderAddress": "CxNUEf6Aw8o8i84GfyPE3ZcKKpa4XRyuXEwypECbdjV8",
  "transactionIndex": 0,
  "blockHash": "GMKNhiUnUVQrTzYuy2t5qZVd1JfoyGi5LdifNG6gEHiP",
  "logIndex": 0,
  "chainId": "solana:solana",
  "timestamp": "1737653025",
  "date": "2025-01-23T17:23:45.000Z",
  "priceUSDToken0": 250.0741553570125,
  "priceUSDToken1": 0.00015542750980960583,
  "amount0": 1,       // Positive → Token0 goes into the pool
  "amount1": -1608943.974354, // Negative → Token1 comes out of the pool
  "amountUSD": 250.0741553570125,
  "type": "swap"
}

​
Enriched Swap model

The Enriched Swap extends the basic Swap model with baseTokenData, post & pre balances, baseToken and quoteToken identification, and derived fields for UI and analytics. Important: The baseTokenData field contains enriched data (including price, volume, market cap, liquidity, and many other stats) for the base token as determined by baseQuote logic. 
{
        "ratio": 9202655.68008125,
        "swapSenderAddress": "7rhFTmUrRSQsL2b3YDoTuSC2sBQUeN9smbSHpne3vowa",
        "poolAddress": "4WYhS4JwJQsqfVfNx2uN9ZoRhrMTTsYo8kjdTLvFtSDy",
        "rawAmount0": "320000000",
        "rawAmount1": "-2944849817626",
        "poolType": "raydium-clmm",
        "swapType": "REGULAR",
        "rawPostBalance0": "0",
        "rawPostBalance1": "52076639903895",
        "rawPreBalance0": "0",
        "rawPreBalance1": "49131790086269",
        "addressToken0": "So11111111111111111111111111111111111111112",
        "addressToken1": "HjgFP3f1nc9kxD71YQXxD1fWHZLNp6b5ARdvhfVKpgCP",
        "blockHeight": "370511250",
        "transactionHash": "snFJGsc6gUyZHpYTbxVQQnDYpWSuPUJ4NTdvTJHTX6Wyd2Amsb3MTbNeyDe9VzkRVf87DhQ1aV79Ptnq2fZufei",
        "transactionSenderAddress": "7rhFTmUrRSQsL2b3YDoTuSC2sBQUeN9smbSHpne3vowa",
        "transactionIndex": 1007,
        "blockHash": "snFJGsc6gUyZHpYTbxVQQnDYpWSuPUJ4NTdvTJHTX6Wyd2Amsb3MTbNeyDe9VzkRVf87DhQ1aV79Ptnq2fZufei",
        "miniBlockSlot": 3705112501007,
        "logIndex": 0,
        "chainId": "solana:solana",
        "timestamp": "1759334642100",
        "date": "2025-10-01T16:04:02.100Z",
        "priceUSDToken0": 220.4363745057309,
        "priceUSDToken1": 0.000023953561033784614,
        "amount0": 0.32,
        "amount1": -2944849.817626,
        "amountUSD": 70.53963984183389,
        "gasFeesUSD": 0.0001254,
        "platformFeesUSD": 0.0002,
        "mevFeesUSD": 0.0005,
        "totalFeesUSD": 0.0008454,
        "baseToken": "HjgFP3f1nc9kxD71YQXxD1fWHZLNp6b5ARdvhfVKpgCP",
        "quoteToken": "So11111111111111111111111111111111111111112",
        "pair": "4WYhS4JwJQsqfVfNx2uN9ZoRhrMTTsYo8kjdTLvFtSDy",
        "tokenPrice": 0.000023953561033784614,
        "tokenPriceVs": 220.4363745057309,
        "tokenAmount": 2944849.817626,
        "tokenAmountVs": 0.32,
        "tokenAmountUsd": 70.53963984183389,
        "type": "buy",
        "operation": "regular",
        "blockchain": "Solana",
        "hash": "snFJGsc6gUyZHpYTbxVQQnDYpWSuPUJ4NTdvTJHTX6Wyd2Amsb3MTbNeyDe9VzkRVf87DhQ1aV79Ptnq2fZufei",
        "sender": "7rhFTmUrRSQsL2b3YDoTuSC2sBQUeN9smbSHpne3vowa",
        "tokenAmountRaw": 2944849817626,
        "tokenAmountRawVs": "320000000",
        "baseTokenData": {
            "chainId": "solana:solana",
            "address": "HjgFP3f1nc9kxD71YQXxD1fWHZLNp6b5ARdvhfVKpgCP",
            "name": "🦊",
            "symbol": "🦊",
            "decimals": 6,
            "priceUSD": 0.000023953561033784614,
            "volume24hUSD": 150000,
            "liquidityUSD": 50000,
            "marketCapUSD": 239535,
            "priceChange24hPercentage": 5.2,
            "id": 12345,
            "logo": "https://pbs.twimg.com/media/G1ViqBdbQAA0-nS?format=jpg&name=360x360",
            "deployer": "7rhFTmUrRSQsL2b3YDoTuSC2sBQUeN9smbSHpne3vowa",
            "source": "raydium",
            "totalSupply": "10000000000",
            "circulatingSupply": "10000000000"
        },
        "position": {
            "balance": 2944849.817626,
            "rawBalance": "2944849817626",
            "amountUSD": 70.54,
            "nativeBalanceRaw": "92553887",
            "nativeBalance": 0.092553887,
            "buys": 1,
            "sells": 0,
            "volumeBuyToken": 2944849.817626,
            "volumeSellToken": 0,
            "volumeBuy": 70.54,
            "volumeSell": 0,
            "avgBuyPriceUSD": 0.000023953561033784614,
            "avgSellPriceUSD": 0,
            "realizedPnlUSD": 0,
            "unrealizedPnlUSD": 0,
            "totalPnlUSD": 0,
            "realizedPnlPercent": 0,
            "unrealizedPnlPercent": 0
        }
    },

​
Position data on Enriched Swaps

Every swap-enriched event includes a position object that tracks the swap sender’s (or recipient’s) running position for the base token. This is computed in real-time from on-chain data and historical trades.
FieldTypeDescription
balancenumberCurrent token balance (human-readable)
rawBalancestringToken balance as raw string (unformatted)
amountUSDnumberToken balance value in USD (balance × currentPrice)
nativeBalanceRawstringNative chain token balance in lamports/wei
nativeBalancenumberNative chain token balance (formatted, e.g. SOL not lamports)
buysnumberTotal number of buy transactions
sellsnumberTotal number of sell transactions
volumeBuyTokennumberTotal tokens bought
volumeSellTokennumberTotal tokens sold
volumeBuynumberTotal USD value of buys
volumeSellnumberTotal USD value of sells
avgBuyPriceUSDnumberAverage buy price in USD
avgSellPriceUSDnumberAverage sell price in USD
realizedPnlUSDnumberRealized profit/loss in USD
unrealizedPnlUSDnumberUnrealized profit/loss in USD
totalPnlUSDnumberTotal P&L (realized + unrealized)
realizedPnlPercentnumberRealized PnL as percentage of cost basis
unrealizedPnlPercentnumberUnrealized PnL as percentage of cost basis

​
Pool model

Pools are abstractions on AMM pools, protocol & chain agnostic. Identifier on Mobula: pool Example: 
{
    "chainId": "solana:solana",
    "address": "B945wuhaQz3p238XDnghSsLKix8MiizT2j2yuHSgX7Xi",
    "type": "pool",
    "factory": "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P",
    "tokens": [
      "So11111111111111111111111111111111111111112",
      "C8U4ofzDkFdwxxP9twNut4vkxVVSQovHDedGAQ5apump"
    ],
    "createdAt": 1744358732000,
    "deployer": "BjMRkgnfkDPVPjLJqejEV5dhrnVNJ4ycriMp3ctcqYME",
    "source": "pumpfun"
}