tardis-dev 16.2.0 → 16.2.2

package/src/mappers/binance.ts

@@ -5,9 +5,10 @@ import { Mapper, PendingTickerInfoHelper } from './mapper.ts'
 
 // https://github.com/binance-exchange/binance-official-api-docs/blob/master/web-socket-streams.md
 
-export class BinanceTradesMapper
-  implements Mapper<'binance' | 'binance-jersey' | 'binance-us' | 'binance-futures' | 'binance-delivery', Trade>
-{
+export class BinanceTradesMapper implements Mapper<
+  'binance' | 'binance-jersey' | 'binance-us' | 'binance-futures' | 'binance-delivery',
+  Trade
+> {
   constructor(private readonly _exchange: Exchange) {}
 
   canHandle(message: BinanceResponse<any>) {
@@ -53,14 +54,18 @@ export class BinanceTradesMapper
   }
 }
 
-export class BinanceBookChangeMapper
-  implements Mapper<'binance' | 'binance-jersey' | 'binance-us' | 'binance-futures' | 'binance-delivery', BookChange>
-{
+export class BinanceBookChangeMapper implements Mapper<
+  'binance' | 'binance-jersey' | 'binance-us' | 'binance-futures' | 'binance-delivery',
+  BookChange
+> {
   protected readonly symbolToDepthInfoMapping: {
     [key: string]: LocalDepthInfo
   } = {}
 
-  constructor(protected readonly exchange: Exchange, protected readonly ignoreBookSnapshotOverlapError: boolean) {}
+  constructor(
+    protected readonly exchange: Exchange,
+    protected readonly ignoreBookSnapshotOverlapError: boolean
+  ) {}
 
   canHandle(message: BinanceResponse<any>) {
     if (message.stream === undefined) {
@@ -217,7 +222,10 @@ export class BinanceFuturesBookChangeMapper
   extends BinanceBookChangeMapper
   implements Mapper<'binance-futures' | 'binance-delivery', BookChange>
 {
-  constructor(protected readonly exchange: Exchange, protected readonly ignoreBookSnapshotOverlapError: boolean) {
+  constructor(
+    protected readonly exchange: Exchange,
+    protected readonly ignoreBookSnapshotOverlapError: boolean
+  ) {
     super(exchange, ignoreBookSnapshotOverlapError)
   }
 

package/src/mappers/bitget.ts

@@ -1,5 +1,5 @@
-import { upperCaseSymbols } from '../handy.ts'
-import { BookChange, BookTicker, DerivativeTicker, Exchange, Trade } from '../types.ts'
+import { asNumberIfValid, upperCaseSymbols } from '../handy.ts'
+import { BookChange, BookTicker, DerivativeTicker, Exchange, Liquidation, Trade } from '../types.ts'
 import { Mapper, PendingTickerInfoHelper } from './mapper.ts'
 
 export class BitgetTradesMapper implements Mapper<'bitget' | 'bitget-futures', Trade> {
@@ -155,6 +155,182 @@ export class BitgetDerivativeTickerMapper implements Mapper<'bitget-futures', De
   }
 }
 
+export class BitgetV3TradesMapper implements Mapper<'bitget' | 'bitget-futures', Trade> {
+  constructor(private readonly _exchange: Exchange) {}
+
+  canHandle(message: BitgetV3TradeMessage) {
+    return message.arg.topic === 'publicTrade' && message.action === 'update'
+  }
+
+  getFilters(symbols?: string[]) {
+    symbols = upperCaseSymbols(symbols)
+
+    return [
+      {
+        channel: 'publicTrade',
+        symbols
+      } as const
+    ]
+  }
+
+  *map(message: BitgetV3TradeMessage, localTimestamp: Date): IterableIterator<Trade> {
+    for (const trade of message.data) {
+      yield {
+        type: 'trade',
+        symbol: message.arg.symbol,
+        exchange: this._exchange,
+        id: trade.i,
+        price: Number(trade.p),
+        amount: Number(trade.v),
+        side: trade.S === 'buy' ? 'buy' : 'sell',
+        timestamp: new Date(Number(trade.T)),
+        localTimestamp
+      }
+    }
+  }
+}
+
+export class BitgetV3BookChangeMapper implements Mapper<'bitget' | 'bitget-futures', BookChange> {
+  constructor(private readonly _exchange: Exchange) {}
+
+  canHandle(message: BitgetV3OrderbookMessage) {
+    return message.arg.topic === 'books' && (message.action === 'snapshot' || message.action === 'update')
+  }
+
+  getFilters(symbols?: string[]) {
+    symbols = upperCaseSymbols(symbols)
+
+    return [
+      {
+        channel: 'books',
+        symbols
+      } as const
+    ]
+  }
+
+  *map(message: BitgetV3OrderbookMessage, localTimestamp: Date): IterableIterator<BookChange> {
+    for (const orderbookData of message.data) {
+      yield {
+        type: 'book_change',
+        symbol: message.arg.symbol,
+        exchange: this._exchange,
+        isSnapshot: message.action === 'snapshot',
+        bids: orderbookData.b.map(mapPriceLevel),
+        asks: orderbookData.a.map(mapPriceLevel),
+        timestamp: new Date(Number(orderbookData.ts)),
+        localTimestamp
+      }
+    }
+  }
+}
+
+export class BitgetV3BookTickerMapper implements Mapper<'bitget' | 'bitget-futures', BookTicker> {
+  constructor(private readonly _exchange: Exchange) {}
+
+  canHandle(message: BitgetV3BBoMessage) {
+    return message.arg.topic === 'books1' && message.action === 'snapshot'
+  }
+
+  getFilters(symbols?: string[]) {
+    symbols = upperCaseSymbols(symbols)
+
+    return [
+      {
+        channel: 'books1',
+        symbols
+      } as const
+    ]
+  }
+
+  *map(message: BitgetV3BBoMessage, localTimestamp: Date): IterableIterator<BookTicker> {
+    for (const bboMessage of message.data) {
+      yield {
+        type: 'book_ticker',
+        symbol: message.arg.symbol,
+        exchange: this._exchange,
+        askAmount: bboMessage.a[0] ? asNumberIfValid(bboMessage.a[0][1]) : undefined,
+        askPrice: bboMessage.a[0] ? asNumberIfValid(bboMessage.a[0][0]) : undefined,
+        bidPrice: bboMessage.b[0] ? asNumberIfValid(bboMessage.b[0][0]) : undefined,
+        bidAmount: bboMessage.b[0] ? asNumberIfValid(bboMessage.b[0][1]) : undefined,
+        timestamp: new Date(Number(bboMessage.ts)),
+        localTimestamp
+      }
+    }
+  }
+}
+
+export class BitgetV3DerivativeTickerMapper implements Mapper<'bitget-futures', DerivativeTicker> {
+  private readonly pendingTickerInfoHelper = new PendingTickerInfoHelper()
+
+  canHandle(message: BitgetV3TickerMessage) {
+    return message.arg.topic === 'ticker' && (message.action === 'snapshot' || message.action === 'update')
+  }
+
+  getFilters(symbols?: string[]) {
+    symbols = upperCaseSymbols(symbols)
+
+    return [
+      {
+        channel: 'ticker',
+        symbols
+      } as const
+    ]
+  }
+
+  *map(message: BitgetV3TickerMessage, localTimestamp: Date): IterableIterator<DerivativeTicker> {
+    for (const tickerMessage of message.data) {
+      const pendingTickerInfo = this.pendingTickerInfoHelper.getPendingTickerInfo(message.arg.symbol, 'bitget-futures')
+
+      pendingTickerInfo.updateIndexPrice(Number(tickerMessage.indexPrice))
+      pendingTickerInfo.updateMarkPrice(Number(tickerMessage.markPrice))
+      pendingTickerInfo.updateOpenInterest(Number(tickerMessage.openInterest))
+      pendingTickerInfo.updateLastPrice(Number(tickerMessage.lastPrice))
+      pendingTickerInfo.updateTimestamp(new Date(Number(message.ts)))
+
+      if (tickerMessage.nextFundingTime !== '' && tickerMessage.nextFundingTime !== '0') {
+        pendingTickerInfo.updateFundingTimestamp(new Date(Number(tickerMessage.nextFundingTime)))
+        pendingTickerInfo.updateFundingRate(Number(tickerMessage.fundingRate))
+      }
+
+      if (pendingTickerInfo.hasChanged()) {
+        yield pendingTickerInfo.getSnapshot(localTimestamp)
+      }
+    }
+  }
+}
+
+export class BitgetV3LiquidationsMapper implements Mapper<'bitget-futures', Liquidation> {
+  canHandle(message: BitgetV3LiquidationMessage) {
+    return message.arg.topic === 'liquidation' && message.action === 'update'
+  }
+
+  getFilters() {
+    return [
+      {
+        channel: 'liquidation',
+        symbols: undefined
+      } as const
+    ]
+  }
+
+  *map(message: BitgetV3LiquidationMessage, localTimestamp: Date): IterableIterator<Liquidation> {
+    for (const liquidation of message.data) {
+      yield {
+        type: 'liquidation',
+        symbol: liquidation.symbol,
+        exchange: 'bitget-futures',
+        id: undefined,
+        price: Number(liquidation.price),
+        amount: Number(liquidation.amount),
+        // Bitget side is position side, normalized side is the liquidated aggressor side.
+        side: liquidation.side === 'buy' ? 'sell' : 'buy',
+        timestamp: new Date(Number(liquidation.ts)),
+        localTimestamp
+      }
+    }
+  }
+}
+
 type BitgetTradeMessage = {
   action: 'update'
   arg: { instType: 'SPOT'; channel: 'trade'; instId: 'OPUSDT' }
@@ -214,3 +390,62 @@ type BitgetTickerMessage = {
   ]
   ts: 1730332823220
 }
+
+type BitgetV3TradeMessage = {
+  action: 'snapshot' | 'update'
+  arg: { instType: string; topic: 'publicTrade'; symbol: string }
+  data: { i: string; p: string; v: string; S: 'buy' | 'sell'; T: string; L: string; isRPI?: string }[]
+  ts: number
+}
+
+type BitgetV3BookLevel = [string, string]
+
+type BitgetV3OrderbookMessage = {
+  action: 'snapshot' | 'update'
+  arg: { instType: string; topic: 'books'; symbol: string }
+  data: { a: BitgetV3BookLevel[]; b: BitgetV3BookLevel[]; checksum: number; seq: number; pseq: number; ts: string }[]
+  ts: number
+}
+
+type BitgetV3BBoMessage = {
+  action: 'snapshot'
+  arg: { instType: string; topic: 'books1'; symbol: string }
+  data: { a: BitgetV3BookLevel[]; b: BitgetV3BookLevel[]; checksum: number; seq: number; pseq: number; ts: string }[]
+  ts: number
+}
+
+type BitgetV3TickerMessage = {
+  action: 'snapshot' | 'update'
+  arg: { instType: string; topic: 'ticker'; symbol: string }
+  data: [
+    {
+      highPrice24h: string
+      lowPrice24h: string
+      openPrice24h: string
+      lastPrice: string
+      turnover24h: string
+      volume24h: string
+      bid1Price: string
+      ask1Price: string
+      bid1Size: string
+      ask1Size: string
+      price24hPcnt: string
+      indexPrice: string
+      markPrice: string
+      fundingRate: string
+      openInterest: string
+      deliveryTime: string
+      deliveryStartTime: string
+      deliveryStatus: string
+      nextFundingTime: string
+    }
+  ]
+  ts: number
+}
+
+type BitgetV3LiquidationMessage = {
+  action: 'update'
+  arg: { instType: string; topic: 'liquidation' }
+  data: { symbol: string; side: 'buy' | 'sell'; price: string; amount: string; ts: string }[]
+  ts: number
+}

package/src/mappers/bybit.ts

@@ -44,7 +44,10 @@ export class BybitV5TradesMapper implements Mapper<'bybit' | 'bybit-spot' | 'byb
 }
 
 export class BybitV5BookChangeMapper implements Mapper<'bybit' | 'bybit-spot' | 'bybit-options', BookChange> {
-  constructor(protected readonly _exchange: Exchange, private readonly _depth: number) {}
+  constructor(
+    protected readonly _exchange: Exchange,
+    private readonly _depth: number
+  ) {}
 
   canHandle(message: BybitV5OrderBookMessage) {
     if (message.topic === undefined) {
@@ -388,8 +391,8 @@ export class BybitTradesMapper implements Mapper<'bybit', Trade> {
         'trade_time_ms' in trade
           ? new Date(Number(trade.trade_time_ms))
           : 'tradeTimeMs' in trade
-          ? new Date(Number(trade.tradeTimeMs))
-          : new Date(trade.timestamp)
+            ? new Date(Number(trade.tradeTimeMs))
+            : new Date(trade.timestamp)
 
       yield {
         type: 'trade',
@@ -407,7 +410,10 @@ export class BybitTradesMapper implements Mapper<'bybit', Trade> {
 }
 
 export class BybitBookChangeMapper implements Mapper<'bybit', BookChange> {
-  constructor(protected readonly _exchange: Exchange, private readonly _canUseBook200Channel: boolean) {}
+  constructor(
+    protected readonly _exchange: Exchange,
+    private readonly _canUseBook200Channel: boolean
+  ) {}
 
   canHandle(message: BybitDataMessage) {
     if (message.topic === undefined) {
@@ -449,8 +455,8 @@ export class BybitBookChangeMapper implements Mapper<'bybit', BookChange> {
         ? 'order_book' in message.data
           ? message.data.order_book
           : 'orderBook' in message.data
-          ? message.data.orderBook
-          : message.data
+            ? message.data.orderBook
+            : message.data
         : [...message.data.delete, ...message.data.update, ...message.data.insert]
 
     const timestampBybit = message.timestamp_e6 !== undefined ? Number(message.timestamp_e6) : Number(message.timestampE6)
@@ -858,16 +864,15 @@ type BybitInstrumentUpdate = {
   ask1Price: '21213.50'
 }
 
-type BybitInstrumentDataMessage =
-  | BybitDataMessage & {
-      timestamp_e6: string
-      timestampE6: string
-      data:
-        | BybitInstrumentUpdate
-        | {
-            update: [BybitInstrumentUpdate]
-          }
-    }
+type BybitInstrumentDataMessage = BybitDataMessage & {
+  timestamp_e6: string
+  timestampE6: string
+  data:
+    | BybitInstrumentUpdate
+    | {
+        update: [BybitInstrumentUpdate]
+      }
+}
 
 type BybitLiquidationMessage = BybitDataMessage & {
   generated: true

package/src/mappers/gateio.ts

@@ -60,7 +60,10 @@ export class GateIOV4BookChangeMapper implements Mapper<'gate-io', BookChange> {
     [key: string]: LocalDepthInfo
   } = {}
 
-  constructor(protected readonly exchange: Exchange, protected readonly ignoreBookSnapshotOverlapError: boolean) {}
+  constructor(
+    protected readonly exchange: Exchange,
+    protected readonly ignoreBookSnapshotOverlapError: boolean
+  ) {}
 
   canHandle(message: GateV4OrderBookUpdate | Gatev4OrderBookSnapshot) {
     if (message.channel === undefined) {

package/src/mappers/gateiofutures.ts

@@ -76,8 +76,8 @@ export class GateIOFuturesBookChangeMapper implements Mapper<'gate-io-futures',
         depthMessage.time_ms !== undefined
           ? new Date(depthMessage.time_ms)
           : depthMessage.result.t !== undefined
-          ? new Date(depthMessage.result.t)
-          : new Date(depthMessage.time * 1000)
+            ? new Date(depthMessage.result.t)
+            : new Date(depthMessage.time * 1000)
 
       // snapshot
       yield {

package/src/mappers/huobi.ts

@@ -5,9 +5,10 @@ import { Mapper, PendingTickerInfoHelper } from './mapper.ts'
 // https://huobiapi.github.io/docs/spot/v1/en/#websocket-market-data
 // https://github.com/huobiapi/API_Docs_en/wiki/WS_api_reference_en
 
-export class HuobiTradesMapper
-  implements Mapper<'huobi' | 'huobi-dm' | 'huobi-dm-swap' | 'huobi-dm-linear-swap' | 'huobi-dm-options', Trade>
-{
+export class HuobiTradesMapper implements Mapper<
+  'huobi' | 'huobi-dm' | 'huobi-dm-swap' | 'huobi-dm-linear-swap' | 'huobi-dm-options',
+  Trade
+> {
   constructor(private readonly _exchange: Exchange) {}
   canHandle(message: HuobiDataMessage) {
     if (message.ch === undefined) {
@@ -46,9 +47,10 @@ export class HuobiTradesMapper
   }
 }
 
-export class HuobiBookChangeMapper
-  implements Mapper<'huobi' | 'huobi-dm' | 'huobi-dm-swap' | 'huobi-dm-linear-swap' | 'huobi-dm-options', BookChange>
-{
+export class HuobiBookChangeMapper implements Mapper<
+  'huobi' | 'huobi-dm' | 'huobi-dm-swap' | 'huobi-dm-linear-swap' | 'huobi-dm-options',
+  BookChange
+> {
   constructor(protected readonly _exchange: Exchange) {}
 
   canHandle(message: HuobiDataMessage) {

package/src/mappers/index.ts

@@ -27,7 +27,17 @@ import {
   BitfinexTradesMapper
 } from './bitfinex.ts'
 import { BitflyerBookChangeMapper, bitflyerBookTickerMapper, bitflyerTradesMapper } from './bitflyer.ts'
-import { BitgetBookChangeMapper, BitgetBookTickerMapper, BitgetDerivativeTickerMapper, BitgetTradesMapper } from './bitget.ts'
+import {
+  BitgetBookChangeMapper,
+  BitgetBookTickerMapper,
+  BitgetDerivativeTickerMapper,
+  BitgetTradesMapper,
+  BitgetV3BookChangeMapper,
+  BitgetV3BookTickerMapper,
+  BitgetV3DerivativeTickerMapper,
+  BitgetV3LiquidationsMapper,
+  BitgetV3TradesMapper
+} from './bitget.ts'
 import {
   BitmexBookChangeMapper,
   BitmexDerivativeTickerMapper,
@@ -208,6 +218,12 @@ const shouldUseBybitAllLiquidationFeed = (localTimestamp: Date) => {
   return isRealTime(localTimestamp) || localTimestamp.valueOf() >= BYBIT_V5_API_ALL_LIQUIDATION_SUPPORT_DATE.valueOf()
 }
 
+const BITGET_V3_API_SWITCH_DATE = new Date('2026-04-28T00:00:00.000Z')
+
+const shouldUseBitgetV3Mappers = (localTimestamp: Date) => {
+  return isRealTime(localTimestamp) || localTimestamp.valueOf() >= BITGET_V3_API_SWITCH_DATE.valueOf()
+}
+
 const OKCOIN_V5_API_SWITCH_DATE = new Date('2023-04-27T00:00:00.000Z')
 const shouldUseOkcoinV5Mappers = (localTimestamp: Date) => {
   return isRealTime(localTimestamp) || localTimestamp.valueOf() >= OKCOIN_V5_API_SWITCH_DATE.valueOf()
@@ -320,8 +336,10 @@ const tradesMappers = {
       ? new BinanceEuropeanOptionsTradesMapperV2()
       : new BinanceEuropeanOptionsTradesMapper(),
   'okex-spreads': () => new OkexSpreadsTradesMapper(),
-  bitget: () => new BitgetTradesMapper('bitget'),
-  'bitget-futures': () => new BitgetTradesMapper('bitget-futures'),
+  bitget: (localTimestamp: Date) =>
+    shouldUseBitgetV3Mappers(localTimestamp) ? new BitgetV3TradesMapper('bitget') : new BitgetTradesMapper('bitget'),
+  'bitget-futures': (localTimestamp: Date) =>
+    shouldUseBitgetV3Mappers(localTimestamp) ? new BitgetV3TradesMapper('bitget-futures') : new BitgetTradesMapper('bitget-futures'),
   'coinbase-international': () => coinbaseInternationalTradesMapper,
   hyperliquid: () => new HyperliquidTradesMapper(),
   lighter: () => new LighterTradesMapper()
@@ -391,8 +409,8 @@ const bookChangeMappers = {
     shouldUseGateIOV4OrderBookV2Mappers(localTimestamp)
       ? new GateIOV4OrderBookV2ChangeMapper('gate-io')
       : shouldUseGateIOV4Mappers(localTimestamp)
-      ? new GateIOV4BookChangeMapper('gate-io', isRealTime(localTimestamp) == false)
-      : new GateIOBookChangeMapper('gate-io'),
+        ? new GateIOV4BookChangeMapper('gate-io', isRealTime(localTimestamp) == false)
+        : new GateIOBookChangeMapper('gate-io'),
   'gate-io-futures': () => new GateIOFuturesBookChangeMapper('gate-io-futures'),
   poloniex: (localTimestamp: Date) =>
     shouldUsePoloniexV2Mappers(localTimestamp) ? new PoloniexV2BookChangeMapper() : new PoloniexBookChangeMapper(),
@@ -416,8 +434,12 @@ const bookChangeMappers = {
       ? new BinanceEuropeanOptionsBookChangeMapperV2()
       : new BinanceEuropeanOptionsBookChangeMapper(),
   'okex-spreads': () => new OkexSpreadsBookChangeMapper(),
-  bitget: () => new BitgetBookChangeMapper('bitget'),
-  'bitget-futures': () => new BitgetBookChangeMapper('bitget-futures'),
+  bitget: (localTimestamp: Date) =>
+    shouldUseBitgetV3Mappers(localTimestamp) ? new BitgetV3BookChangeMapper('bitget') : new BitgetBookChangeMapper('bitget'),
+  'bitget-futures': (localTimestamp: Date) =>
+    shouldUseBitgetV3Mappers(localTimestamp)
+      ? new BitgetV3BookChangeMapper('bitget-futures')
+      : new BitgetBookChangeMapper('bitget-futures'),
   'coinbase-international': () => new CoinbaseInternationalBookChangMapper(),
   hyperliquid: () => new HyperliquidBookChangeMapper(),
   lighter: () => new LighterBookChangeMapper()
@@ -454,7 +476,8 @@ const derivativeTickersMappers = {
   'crypto-com': () => new CryptoComDerivativeTickerMapper('crypto-com'),
   'woo-x': () => new WooxDerivativeTickerMapper(),
   'kucoin-futures': () => new KucoinFuturesDerivativeTickerMapper(),
-  'bitget-futures': () => new BitgetDerivativeTickerMapper(),
+  'bitget-futures': (localTimestamp: Date) =>
+    shouldUseBitgetV3Mappers(localTimestamp) ? new BitgetV3DerivativeTickerMapper() : new BitgetDerivativeTickerMapper(),
   'coinbase-international': () => new CoinbaseInternationalDerivativeTickerMapper(),
   hyperliquid: () => new HyperliquidDerivativeTickerMapper(),
   lighter: () => new LighterDerivativeTickerMapper()
@@ -496,7 +519,8 @@ const liquidationsMappers = {
       ? new OkexV5LiquidationsMapper('okex-futures')
       : new OkexLiquidationsMapper('okex-futures', 'futures'),
   'okex-swap': (localTimestamp: Date) =>
-    shouldUseOkexV5Mappers(localTimestamp) ? new OkexV5LiquidationsMapper('okex-swap') : new OkexLiquidationsMapper('okex-swap', 'swap')
+    shouldUseOkexV5Mappers(localTimestamp) ? new OkexV5LiquidationsMapper('okex-swap') : new OkexLiquidationsMapper('okex-swap', 'swap'),
+  'bitget-futures': () => new BitgetV3LiquidationsMapper()
 }
 
 const bookTickersMappers = {
@@ -556,8 +580,12 @@ const bookTickersMappers = {
   'gate-io': () => new GateIOV4BookTickerMapper('gate-io'),
   'okex-spreads': () => new OkexSpreadsBookTickerMapper(),
   'kucoin-futures': () => new KucoinFuturesBookTickerMapper(),
-  bitget: () => new BitgetBookTickerMapper('bitget'),
-  'bitget-futures': () => new BitgetBookTickerMapper('bitget-futures'),
+  bitget: (localTimestamp: Date) =>
+    shouldUseBitgetV3Mappers(localTimestamp) ? new BitgetV3BookTickerMapper('bitget') : new BitgetBookTickerMapper('bitget'),
+  'bitget-futures': (localTimestamp: Date) =>
+    shouldUseBitgetV3Mappers(localTimestamp)
+      ? new BitgetV3BookTickerMapper('bitget-futures')
+      : new BitgetBookTickerMapper('bitget-futures'),
   'coinbase-international': () => coinbaseInternationalBookTickerMapper,
   hyperliquid: () => new HyperliquidBookTickerMapper(),
   lighter: () => new LighterBookTickerMapper(),

package/src/mappers/kucoin.ts

@@ -46,7 +46,10 @@ export class KucoinBookChangeMapper implements Mapper<'kucoin', BookChange> {
     [key: string]: LocalDepthInfo
   } = {}
 
-  constructor(protected readonly _exchange: Exchange, private readonly ignoreBookSnapshotOverlapError: boolean) {}
+  constructor(
+    protected readonly _exchange: Exchange,
+    private readonly ignoreBookSnapshotOverlapError: boolean
+  ) {}
 
   canHandle(message: KucoinLevel2SnapshotMessage | KucoinLevel2UpdateMessage) {
     return message.type === 'message' && message.topic.startsWith('/market/level2')

package/src/mappers/okex.ts

@@ -6,7 +6,10 @@ import { Mapper, PendingTickerInfoHelper } from './mapper.ts'
 // https://www.okex.com/docs-v5/en/#websocket-api-public-channel-trades-channel
 
 export class OkexV5TradesMapper implements Mapper<OKEX_EXCHANGES, Trade> {
-  constructor(private readonly _exchange: Exchange, private readonly _useTradesAll: boolean) {}
+  constructor(
+    private readonly _exchange: Exchange,
+    private readonly _useTradesAll: boolean
+  ) {}
 
   canHandle(message: any) {
     if (message.event !== undefined || message.arg === undefined) {
@@ -62,7 +65,10 @@ const mapV5BookLevel = (level: OkexV5BookLevel) => {
 export class OkexV5BookChangeMapper implements Mapper<OKEX_EXCHANGES, BookChange> {
   private _channelName: string
 
-  constructor(private readonly _exchange: Exchange, usePublicBooksChannel: boolean) {
+  constructor(
+    private readonly _exchange: Exchange,
+    usePublicBooksChannel: boolean
+  ) {
     this._channelName = this._getBooksChannelName(usePublicBooksChannel)
   }
 
@@ -137,7 +143,10 @@ export class OkexV5BookChangeMapper implements Mapper<OKEX_EXCHANGES, BookChange
 }
 
 export class OkexV5BookTickerMapper implements Mapper<OKEX_EXCHANGES, BookTicker> {
-  constructor(private readonly _exchange: Exchange, private readonly _useTbtTickerChannel: boolean) {}
+  constructor(
+    private readonly _exchange: Exchange,
+    private readonly _useTbtTickerChannel: boolean
+  ) {}
 
   canHandle(message: any) {
     if (message.event !== undefined || message.arg === undefined) {
@@ -726,7 +735,10 @@ type OkexV5SummaryMessage = {
 // https://www.okex.com/docs/en/#ws_swap-README
 
 export class OkexTradesMapper implements Mapper<OKEX_EXCHANGES, Trade> {
-  constructor(private readonly _exchange: Exchange, private readonly _market: OKEX_MARKETS) {}
+  constructor(
+    private readonly _exchange: Exchange,
+    private readonly _market: OKEX_MARKETS
+  ) {}
 
   canHandle(message: OkexDataMessage) {
     return message.table === `${this._market}/trade`
@@ -991,7 +1003,10 @@ export class OkexOptionSummaryMapper implements Mapper<'okex-options', OptionSum
 }
 
 export class OkexLiquidationsMapper implements Mapper<OKEX_EXCHANGES, Liquidation> {
-  constructor(private readonly _exchange: Exchange, private readonly _market: OKEX_MARKETS) {}
+  constructor(
+    private readonly _exchange: Exchange,
+    private readonly _market: OKEX_MARKETS
+  ) {}
 
   canHandle(message: OkexDataMessage) {
     return message.table === `${this._market}/liquidation`
@@ -1027,7 +1042,10 @@ export class OkexLiquidationsMapper implements Mapper<OKEX_EXCHANGES, Liquidatio
 }
 
 export class OkexBookTickerMapper implements Mapper<OKEX_EXCHANGES, BookTicker> {
-  constructor(private readonly _exchange: Exchange, private readonly _market: OKEX_MARKETS) {}
+  constructor(
+    private readonly _exchange: Exchange,
+    private readonly _market: OKEX_MARKETS
+  ) {}
 
   canHandle(message: OkexDataMessage) {
     return message.table === `${this._market}/ticker`

package/src/mappers/phemex.ts

@@ -27,6 +27,11 @@ function getQtyScale(symbol: string) {
   return 1
 }
 
+function isExcludedFromNormalizedOutput(symbol: string) {
+  // Matches tardis-api metadata: Phemex spot OL/USDT uses sOLUSDT, which collides with SOLUSDT when normalized.
+  return symbol === 'sOLUSDT'
+}
+
 const COINS_STARTING_WITH_S = [
   'SOLUSD',
   'SUSHIUSD',
@@ -163,10 +168,13 @@ export const phemexTradesMapper: Mapper<'phemex', Trade> = {
   },
 
   *map(message: PhemexTradeMessage, localTimestamp: Date): IterableIterator<Trade> {
+    const symbol = message.symbol
+    if (isExcludedFromNormalizedOutput(symbol)) {
+      return
+    }
+
     if ('trades' in message) {
       for (const [timestamp, side, priceEp, qty] of message.trades) {
-        const symbol = message.symbol
-
         yield {
           type: 'trade',
           symbol: symbol.toUpperCase(),
@@ -181,8 +189,6 @@ export const phemexTradesMapper: Mapper<'phemex', Trade> = {
       }
     } else if ('trades_p' in message) {
       for (const [timestamp, side, price, qty] of message.trades_p) {
-        const symbol = message.symbol
-
         yield {
           type: 'trade',
           symbol: symbol.toUpperCase(),
@@ -253,6 +259,10 @@ export const phemexBookChangeMapper: Mapper<'phemex', BookChange> = {
 
   *map(message: PhemexBookMessage, localTimestamp: Date): IterableIterator<BookChange> {
     const symbol = message.symbol
+    if (isExcludedFromNormalizedOutput(symbol)) {
+      return
+    }
+
     if ('book' in message) {
       const mapBookLevel = mapBookLevelForSymbol(symbol)
       yield {