Subscriptions use the WebSocket endpoint wss://api.mobula.io/graphql/subscriptions with the graphql-transport-ws protocol.
Returns Pair metadata payload pushed on every relevant swap. See PairMetadata . Show View fields (PairMetadata)
Pair ID (pairAddress:networkId).
Exchange identifier (factory address).
Tick spacing (V3-style pools).
Which token side is the quote currency. See QuoteToken . Show TokenPairStatisticsType (enum)
Total pair liquidity in USD.
Address of the deeper-liquidity side.
Address of the non-liquidity side.
Price of the quote-side token in USD.
Price of the non-quote-side token in USD.
Top-10 holder concentration (%).
Volume (USD) over the last 5 minutes.
Volume (USD) over the last 1 hour.
Volume (USD) over the last 4 hours.
Volume (USD) over the last 12 hours.
Volume (USD) over the last 24 hours.
Price change % over 5 minutes.
Price change % over 1 hour.
Price change % over 4 hours.
Price change % over 12 hours.
Price change % over 24 hours.
Highest price over 5 minutes.
Highest price over 1 hour.
Highest price over 4 hours.
Highest price over 12 hours.
Highest price over 24 hours.
Lowest price over 5 minutes.
Lowest price over 1 hour.
Lowest price over 4 hours.
Lowest price over 12 hours.
Lowest price over 24 hours.
Pool creation timestamp (unix seconds).
Arguments Pair ID in the form pairAddress:networkId (e.g. 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640:1).
Force the quote-token side (token0 or token1). When omitted, the server picks a default. See QuoteToken . useNonLiquidityTokenAsQuoteToken
When true and quoteToken is not explicitly provided, the quote side defaults to the non-liquidity (asset) token of the pair instead of the deeper-liquidity side.
Behavior
Fires once per swap on the pair (filtered to swaps with amountUSD > 0.1).
The payload includes price, liquidity, windowed price-change / volume / high / low stats, and optional enhanced token data, wallet activity, and top-10 holder concentration — selection-aware (only fields requested are computed).
Multiple subscribers on the same pair sharing the same quoteToken / statsType / useNonLiquidityTokenAsQuoteToken triple share a single fetch per swap.
Example subscription { onPairMetadataUpdated ( id : "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640:1" statsType : FILTERED ) { id pairAddress networkId price priceNonQuoteToken quoteToken liquidityToken nonLiquidityToken liquidity volume24 priceChange24 walletActivity { sniperCount bundlerCount insiderCount } } }
Example — non-liquidity side as quote subscription { onPairMetadataUpdated ( id : "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640:1" useNonLiquidityTokenAsQuoteToken : true ) { quoteToken nonLiquidityToken price priceNonQuoteToken } }
