Quoting Stream

​

Endpoint Details

• URL: wss://api.mobula.io
• Event Type: quoting

• a quote immediately after subscription,
• a periodic quote every intervalMs milliseconds,
• an extra quote whenever a trade touches either tokenIn or tokenOut,
• never more frequently than minIntervalMs.

​

Subscription Format

{
  "type": "quoting",
  "authorization": "YOUR_API_KEY",
  "payload": {
    "chainId": "solana:solana",
    "tokenIn": "So11111111111111111111111111111111111111112",
    "tokenOut": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amountRaw": "1000000000",
    "walletAddress": "YourWalletAddress",
    "slippage": 1,
    "intervalMs": 500,
    "minIntervalMs": 100,
    "subscriptionTracking": true
  }
}

​

Parameters

• chainId or blockchain (required): Blockchain identifier, for example solana:solana, solana, evm:1, or ethereum.
• tokenIn (required): Address of the token to swap from.
• tokenOut (required): Address of the token to swap to.
• amount, amountRaw, or amountUSD (required): Exactly one amount selector. amountRaw is recommended for execution-grade precision.
• walletAddress (required): Wallet used to build executable quote calldata.
• slippage (optional): Slippage tolerance in percent. Default: 1.
• intervalMs (optional): Periodic refresh interval in milliseconds. Default: 1000, minimum: 100.
• minIntervalMs (optional): Minimum delay between two emitted quotes. Default: 300, minimum: 100.
• poolAddress (optional): Restrict the route to a specific pool.
• onlyRouters (optional): Router allow-list, for example ["jupiter"] or "jupiter,naos".
• onlyProtocols / excludedProtocols (optional): Protocol filters, same semantics as the REST swap quoting endpoint.
• prioritizationFeeLamports, dynamicComputeUnitLimit, jitoTipLamports, payerAddress (optional): Solana execution options.
• feePercentage, feeWallet, minFeesNative (optional): Fee options.
• onlyVerifiedTokens (optional): Reject unverified launchpad tokens when true.
• directRoutes (optional): Force direct routes only.
• subscriptionId (optional): Custom subscription id.
• subscriptionTracking (optional): Sends a subscribed acknowledgement when true.

​

Trade Triggering

​

Response Format

{
  "type": "quoting",
  "subscriptionId": "sub_abc123",
  "event": "quote",
  "quoteTrigger": "swap",
  "quoteSequence": 12,
  "requestId": "6d9e5d8e-4c2d-4ed3-a31c-5a6a35fb03ef",
  "chainId": "solana:solana",
  "tokenInAddress": "So11111111111111111111111111111111111111112",
  "tokenOutAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "amountOutTokens": "154.23",
  "slippagePercentage": 3.5,
  "marketImpactPercentage": 0.18,
  "amountInUSD": 145.21,
  "amountOutUSD": 144.94,
  "tokenIn": {
    "address": "So11111111111111111111111111111111111111112",
    "symbol": "SOL",
    "decimals": 9
  },
  "tokenOut": {
    "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "symbol": "USDC",
    "decimals": 6
  },
  "solana": {
    "transaction": {
      "serialized": "BASE64_TRANSACTION",
      "variant": "versioned"
    },
    "lastValidBlockHeight": 269450123
  },
  "latencyMs": 42,
  "timestamp": 1779970000000
}

• initial: first quote after subscription
• interval: periodic refresh
• swap: trade-triggered refresh

​

Unsubscribe

{
  "type": "unsubscribe",
  "payload": {
    "type": "quoting",
    "subscriptionId": "sub_abc123"
  }
}