Enriched Swap Events Stream

This endpoint is only available to Growth and Enterprise plans.

Endpoint Details

Use this stream when raw swaps are not enough and you need derived base/quote context, token metadata, and post-balance fields.

Chain family	Endpoint	Event
EVM	`wss://stream-evm-prod.mobula.io/`	`swap-enriched`
Solana	`wss://stream-sol-prod.mobula.io/`	`swap-enriched`
Stellar	`wss://stream-stellar-prod.mobula.io/`	`swap-enriched`

Each endpoint serves a single chain family. Do not mix chainIds across families, for example Solana or Stellar chainIds on the EVM endpoint.

The EVM addresses used in filters must be lowercase.

Stellar address casing in filters:

Classic AMM pools — lowercase, in the lp:<hex> form. Example: lp:59fa1dc57433dcfbd2db7319d26cb3da1f28f2d8095a3ec36ad4ef9cadb0013e (XLM/AQUA)
All other addresses — uppercase: G... accounts, C... contracts, and CODE:ISSUER assets.

Subscription Payload

{
  "type": "stream",
  "authorization": "YOUR_API_KEY",
  "payload": {
    "name": "SolanaEnrichedSwaps",
    "chainIds": ["solana:solana"],
    "events": ["swap-enriched"],
    "filters": {
      "or": [
        { "eq": ["poolType", "raydium"] },
        { "eq": ["poolType", "raydium-clmm"] }
      ]
    },
    "subscriptionId": "solana-enriched-swaps",
    "subscriptionTracking": true
  }
}

Response Frame

Every message uses the standard Multi-Events frame:

{
  "data": {
    "type": "swap-enriched",
    "poolAddress": "4WYhS4JwJQsqfVfNx2uN9ZoRhrMTTsYo8kjdTLvFtSDy",
    "poolType": "raydium-clmm",
    "transactionHash": "snFJGsc6gUyZHpYTbxVQQnDYpWSuPUJ4NTdvTJHTX6Wyd2Amsb3MTbNeyDe9VzkRVf87DhQ1aV79Ptnq2fZufei",
    "baseToken": "HjgFP3f1nc9kxD71YQXxD1fWHZLNp6b5ARdvhfVKpgCP",
    "quoteToken": "So11111111111111111111111111111111111111112",
    "baseTokenData": {
      "symbol": "TOKEN",
      "name": "Token",
      "priceUSD": 0.0000123
    },
    "postBalanceBaseToken": "49131790086269",
    "postBalanceRecipientBaseToken": "0",
    "date": "2026-06-08T00:18:34.613Z"
  },
  "chainId": "solana:solana",
  "duplicateCount": 1,
  "subscriptionId": "solana-enriched-swaps"
}

See the Curated Data Model for the full enriched swap payload.

Common Filters

Pool Types

{
  "or": [
    { "eq": ["poolType", "raydium"] },
    { "eq": ["poolType", "raydium-clmm"] }
  ]
}

Specific Pool

{
  "eq": ["poolAddress", "68L2iPWLtkRuxhHBYVJLSzaApBVuM6DNqLL1pEywbDGR"]
}

Wallet Activity

{
  "or": [
    { "eq": ["swapSenderAddress", "7rhFTmUrRSQsL2b3YDoTuSC2sBQUeN9smbSHpne3vowa"] },
    { "eq": ["swapRecipient", "7rhFTmUrRSQsL2b3YDoTuSC2sBQUeN9smbSHpne3vowa"] }
  ]
}

Parameters

chainIds (required): Chain identifiers, for example ["evm:8453"], ["solana:solana"], or ["stellar:stellar"].
events (required): Must include swap-enriched.
filters (optional): Filter conditions. See filters.
subscriptionId (optional): Identifier copied into matching responses.
subscriptionTracking (optional, default: false): Include subscription details in response logs.
tag (optional): Usage tag shown in the dashboard breakdown.

Keepalive

{ "event": "ping" }

Unsubscribe

{
  "type": "unsubscribe",
  "authorization": "YOUR_API_KEY",
  "payload": {
    "subscriptionId": "solana-enriched-swaps"
  }
}

Introduction

Market & Token Data

Trades & OHLCV

Pulse Streams

Filter Tokens

Multi-Events & Raw Data

Data Models

Holders & Positions

Perps Streams

Webhooks

Misc

Enriched Swap Events Stream

Endpoint Details

Subscription Payload

Response Frame

Common Filters

Pool Types

Specific Pool

Wallet Activity

Parameters

Keepalive

Unsubscribe

​Endpoint Details

​Subscription Payload

​Response Frame

​Common Filters

​Pool Types

​Specific Pool

​Wallet Activity

​Parameters

​Keepalive

​Unsubscribe

Endpoint Details

Subscription Payload

Response Frame

Common Filters

Pool Types

Specific Pool

Wallet Activity

Parameters

Keepalive

Unsubscribe