tardis-machine 17.0.0 → 18.0.0

package/node_modules/tardis-dev/dist/types.d.ts

@@ -0,0 +1,154 @@
+import { EXCHANGES, EXCHANGE_CHANNELS_INFO } from './consts.ts';
+export type Exchange = (typeof EXCHANGES)[number];
+export type FilterForExchange = {
+    [key in Exchange]: Filter<(typeof EXCHANGE_CHANNELS_INFO)[key][number]>;
+};
+export type Filter<T> = {
+    channel: T;
+    symbols?: string[];
+};
+export type Writeable<T> = {
+    -readonly [P in keyof T]: T[P];
+};
+export type NormalizedData = {
+    readonly type: string;
+    readonly symbol: string;
+    readonly exchange: Exchange;
+    readonly timestamp: Date;
+    readonly localTimestamp: Date;
+    readonly name?: string;
+};
+export type Trade = {
+    readonly type: 'trade';
+    readonly symbol: string;
+    readonly exchange: Exchange;
+    readonly id: string | undefined;
+    readonly price: number;
+    readonly amount: number;
+    /** liquidity taker side (aggressor), not the resting maker order side */
+    readonly side: 'buy' | 'sell' | 'unknown';
+    readonly timestamp: Date;
+    readonly localTimestamp: Date;
+};
+export type BookPriceLevel = {
+    readonly price: number;
+    readonly amount: number;
+};
+export type BookChange = {
+    readonly type: 'book_change';
+    readonly symbol: string;
+    readonly exchange: Exchange;
+    readonly isSnapshot: boolean;
+    readonly bids: BookPriceLevel[];
+    readonly asks: BookPriceLevel[];
+    readonly timestamp: Date;
+    readonly localTimestamp: Date;
+};
+export type DerivativeTicker = {
+    readonly type: 'derivative_ticker';
+    readonly symbol: string;
+    readonly exchange: Exchange;
+    readonly lastPrice: number | undefined;
+    readonly openInterest: number | undefined;
+    readonly fundingRate: number | undefined;
+    readonly fundingTimestamp: Date | undefined;
+    readonly predictedFundingRate: number | undefined;
+    readonly indexPrice: number | undefined;
+    readonly markPrice: number | undefined;
+    readonly timestamp: Date;
+    readonly localTimestamp: Date;
+};
+export type BookTicker = {
+    readonly type: 'book_ticker';
+    readonly symbol: string;
+    readonly exchange: Exchange;
+    readonly askAmount: number | undefined;
+    readonly askPrice: number | undefined;
+    readonly bidPrice: number | undefined;
+    readonly bidAmount: number | undefined;
+    readonly timestamp: Date;
+    readonly localTimestamp: Date;
+};
+export type OptionSummary = NormalizedData & {
+    type: 'option_summary';
+    optionType: 'put' | 'call';
+    strikePrice: number;
+    expirationDate: Date;
+    bestBidPrice: number | undefined;
+    bestBidAmount: number | undefined;
+    bestBidIV: number | undefined;
+    bestAskPrice: number | undefined;
+    bestAskAmount: number | undefined;
+    bestAskIV: number | undefined;
+    lastPrice: number | undefined;
+    openInterest: number | undefined;
+    markPrice: number | undefined;
+    markIV: number | undefined;
+    delta: number | undefined;
+    gamma: number | undefined;
+    vega: number | undefined;
+    theta: number | undefined;
+    rho: number | undefined;
+    underlyingPrice: number | undefined;
+    underlyingIndex: string;
+};
+export type Liquidation = {
+    readonly type: 'liquidation';
+    readonly symbol: string;
+    readonly exchange: Exchange;
+    readonly id: string | undefined;
+    readonly price: number;
+    readonly amount: number;
+    readonly side: 'buy' | 'sell' | 'unknown';
+    readonly timestamp: Date;
+    readonly localTimestamp: Date;
+};
+export type Disconnect = {
+    readonly type: 'disconnect';
+    readonly exchange: Exchange;
+    readonly localTimestamp: Date;
+    readonly symbols: string[] | undefined;
+};
+export type TradeBar = {
+    readonly type: 'trade_bar';
+    readonly symbol: string;
+    readonly exchange: Exchange;
+    readonly name: string;
+    readonly interval: number;
+    readonly kind: 'time' | 'volume' | 'tick';
+    readonly open: number;
+    readonly high: number;
+    readonly low: number;
+    readonly close: number;
+    readonly volume: number;
+    readonly buyVolume: number;
+    readonly sellVolume: number;
+    readonly trades: number;
+    readonly vwap: number;
+    readonly openTimestamp: Date;
+    readonly closeTimestamp: Date;
+    readonly timestamp: Date;
+    readonly localTimestamp: Date;
+};
+export type BookSnapshot = {
+    readonly type: 'book_snapshot';
+    readonly symbol: string;
+    readonly exchange: Exchange;
+    readonly name: string;
+    readonly depth: number;
+    readonly interval: number;
+    readonly grouping?: number;
+    readonly bids: Optional<BookPriceLevel>[];
+    readonly asks: Optional<BookPriceLevel>[];
+    readonly timestamp: Date;
+    readonly localTimestamp: Date;
+};
+declare global {
+    interface Date {
+        μs?: number;
+    }
+}
+export type Optional<T> = {
+    [P in keyof T]: T[P] | undefined;
+};
+//# sourceMappingURL=types.d.ts.map

package/node_modules/tardis-dev/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/node_modules/tardis-dev/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/node_modules/tardis-dev/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/node_modules/tardis-dev/dist/worker.d.ts

@@ -0,0 +1,24 @@
+import type { DataFeedCompression } from './options.ts';
+import { Exchange, Filter } from './types.ts';
+export type WorkerMessage = {
+    sliceKey: string;
+    slicePath: string;
+    sliceSize: number;
+};
+export type WorkerJobPayload = {
+    cacheDir: string;
+    endpoint: string;
+    apiKey: string;
+    dataFeedCompression: DataFeedCompression;
+    userAgent: string;
+    fromDate: Date;
+    toDate: Date;
+    exchange: Exchange;
+    filters: Filter<any>[];
+    waitWhenDataNotYetAvailable?: boolean | number;
+};
+export declare const enum WorkerSignal {
+    BEFORE_TERMINATE = "BEFORE_TERMINATE",
+    READY_TO_TERMINATE = "READY_TO_TERMINATE"
+}
+//# sourceMappingURL=worker.d.ts.map

package/node_modules/tardis-dev/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAgM7C,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,IAAI,CAAA;IACd,MAAM,EAAE,IAAI,CAAA;IACZ,QAAQ,EAAE,QAAQ,CAAA;IAClB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;IACtB,2BAA2B,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAC/C,CAAA;AAED,0BAAkB,YAAY;IAC5B,gBAAgB,qBAAqB;IACrC,kBAAkB,uBAAuB;CAC1C"}

package/node_modules/tardis-dev/dist/worker.js

@@ -0,0 +1,143 @@
+import dbg from 'debug';
+import { existsSync } from 'node:fs';
+import { isMainThread, parentPort, workerData } from 'worker_threads';
+import { forEachConcurrent } from "./foreachconcurrent.js";
+import { addMinutes, download, formatDateToPath, optimizeFilters, sha256, wait, cleanTempFiles } from "./handy.js";
+const debug = dbg('tardis-dev');
+const DEFAULT_DATA_FEED_SLICE_SIZE = 1;
+if (isMainThread) {
+    debug('current worker is not meant to run in main thread');
+}
+else {
+    parentPort.on('message', (signal) => {
+        if (signal === "BEFORE_TERMINATE" /* WorkerSignal.BEFORE_TERMINATE */) {
+            cleanTempFiles();
+            parentPort.postMessage("READY_TO_TERMINATE" /* WorkerSignal.READY_TO_TERMINATE */);
+        }
+    });
+    getDataFeedSlices(workerData);
+}
+process.on('unhandledRejection', (err, promise) => {
+    debug('Unhandled Rejection at: %o, reason: %o', promise, err);
+    throw err;
+});
+async function getDataFeedSlices(payload) {
+    const MILLISECONDS_IN_MINUTE = 60 * 1000;
+    const MIN_WAIT_WHEN_DATA_NOT_AVAILABLE_OFFSET = 6;
+    const CONCURRENCY_LIMIT = 60;
+    // deduplicate filters (if the channel was provided multiple times)
+    const filters = optimizeFilters(payload.filters);
+    // let's calculate number of minutes between "from" and "to" dates as those will give us total number of requests or checks
+    // that will have to be performed concurrently with CONCURRENCY_LIMIT
+    const minutesCountToFetch = Math.floor((payload.toDate.getTime() - payload.fromDate.getTime()) / MILLISECONDS_IN_MINUTE);
+    // each filter will have separate sub dir based on it's sha hash
+    const cacheDir = `${payload.cacheDir}/feeds/${payload.exchange}/${sha256(filters)}`;
+    const waitOffsetMinutes = typeof payload.waitWhenDataNotYetAvailable === 'number'
+        ? Math.max(payload.waitWhenDataNotYetAvailable, MIN_WAIT_WHEN_DATA_NOT_AVAILABLE_OFFSET)
+        : 30;
+    const waitOffsetMS = waitOffsetMinutes * MILLISECONDS_IN_MINUTE;
+    const minutesCountThatAreAlreadyAvailableToFetch = await getAvailableMinutesCount(payload, minutesCountToFetch, waitOffsetMS, MILLISECONDS_IN_MINUTE);
+    await getAvailableDataFeedSlices(payload, filters, cacheDir, minutesCountThatAreAlreadyAvailableToFetch, CONCURRENCY_LIMIT);
+    // for remaining data iterate one by one and wait as needed
+    for (let offset = minutesCountThatAreAlreadyAvailableToFetch; offset < minutesCountToFetch; offset++) {
+        const timestampToFetch = payload.fromDate.valueOf() + offset * MILLISECONDS_IN_MINUTE;
+        const timestampForLastAvailableData = new Date().valueOf() - waitOffsetMS;
+        if (timestampToFetch > timestampForLastAvailableData) {
+            const waitTime = timestampToFetch - timestampForLastAvailableData + 100;
+            await wait(waitTime);
+        }
+        await getDataFeedSlice(payload, offset, filters, cacheDir);
+    }
+}
+async function getAvailableMinutesCount(payload, minutesCountToFetch, waitOffsetMS, millisecondsInMinute) {
+    const waitWhenDataIsNotAvailable = payload.waitWhenDataNotYetAvailable && payload.toDate.valueOf() > new Date().valueOf() - waitOffsetMS;
+    if (!waitWhenDataIsNotAvailable) {
+        return minutesCountToFetch;
+    }
+    let timestampForLastAvailableData = new Date().valueOf() - waitOffsetMS;
+    // in case when even initial from date is not yet available wait until it is
+    if (timestampForLastAvailableData < payload.fromDate.valueOf()) {
+        const initialWaitTime = payload.fromDate.valueOf() - timestampForLastAvailableData;
+        if (initialWaitTime > 0) {
+            await wait(initialWaitTime);
+        }
+    }
+    // fetch concurently any data that is already available
+    timestampForLastAvailableData = new Date().valueOf() - waitOffsetMS;
+    const availableMinutesCount = Math.floor((timestampForLastAvailableData - payload.fromDate.valueOf()) / millisecondsInMinute);
+    return Math.min(Math.max(availableMinutesCount, 0), minutesCountToFetch);
+}
+async function getAvailableDataFeedSlices(payload, filters, cacheDir, minutesCountToFetch, concurrencyLimit) {
+    if (minutesCountToFetch <= 0) {
+        return;
+    }
+    // fetch last slice - it will tell us if user has access to the end of requested date range and data is available
+    // also fetch it from API to get current suggested slice size headers
+    const lastSlice = await getDataFeedSlice(payload, minutesCountToFetch - 1, filters, cacheDir, DEFAULT_DATA_FEED_SLICE_SIZE, false);
+    // fetch first slice - it will tell us if user has access to the beginning of requested date range
+    const firstSlice = minutesCountToFetch === 1 ? lastSlice : await getDataFeedSlice(payload, 0, filters, cacheDir, DEFAULT_DATA_FEED_SLICE_SIZE, false);
+    const replaySliceSize = filters.length === 0 ? DEFAULT_DATA_FEED_SLICE_SIZE : Math.max(firstSlice.suggestedSliceSize, lastSlice.suggestedSliceSize);
+    const sliceOffsets = [];
+    for (let offset = 1; offset < minutesCountToFetch - 1; offset += replaySliceSize) {
+        sliceOffsets.push(offset);
+    }
+    // it both begining and end date of the range is accessible fetch all remaning slices concurently with CONCURRENCY_LIMIT
+    await forEachConcurrent(sliceOffsets, concurrencyLimit, async (offset) => {
+        const requestedSliceSize = Math.min(replaySliceSize, minutesCountToFetch - 1 - offset);
+        await getDataFeedSlice(payload, offset, filters, cacheDir, requestedSliceSize);
+    });
+}
+async function getDataFeedSlice({ exchange, fromDate, endpoint, apiKey, dataFeedCompression, userAgent }, offset, filters, cacheDir, requestedSliceSize = DEFAULT_DATA_FEED_SLICE_SIZE, useCache = true) {
+    const sliceTimestamp = addMinutes(fromDate, offset);
+    const sliceKey = sliceTimestamp.toISOString();
+    const sliceSizeSuffix = requestedSliceSize === DEFAULT_DATA_FEED_SLICE_SIZE ? '' : `.size-${requestedSliceSize}`;
+    const sliceBasePath = `${cacheDir}/${formatDateToPath(sliceTimestamp)}${sliceSizeSuffix}.json`;
+    const zstdSlicePath = `${sliceBasePath}.zst`;
+    const gzipSlicePath = `${sliceBasePath}.gz`;
+    let cachedSlicePath;
+    if (useCache) {
+        cachedSlicePath = existsSync(zstdSlicePath) ? zstdSlicePath : existsSync(gzipSlicePath) ? gzipSlicePath : undefined;
+    }
+    if (cachedSlicePath !== undefined) {
+        debug('getDataFeedSlice already cached: %s, sliceSize: %d', sliceKey, requestedSliceSize);
+        const message = {
+            sliceKey,
+            slicePath: cachedSlicePath,
+            sliceSize: requestedSliceSize
+        };
+        parentPort.postMessage(message);
+        return {
+            sliceSize: requestedSliceSize,
+            suggestedSliceSize: DEFAULT_DATA_FEED_SLICE_SIZE
+        };
+    }
+    let url = `${endpoint}/data-feeds/${exchange}?from=${fromDate.toISOString()}&offset=${offset}&compression=${dataFeedCompression}`;
+    if (requestedSliceSize > DEFAULT_DATA_FEED_SLICE_SIZE) {
+        url += `&sliceSize=${requestedSliceSize}`;
+    }
+    if (filters.length > 0) {
+        url += `&filters=${encodeURIComponent(JSON.stringify(filters))}`;
+    }
+    const downloadResult = await download({
+        apiKey,
+        downloadPath: sliceBasePath,
+        url,
+        userAgent,
+        appendContentEncodingExtension: true,
+        acceptEncoding: dataFeedCompression === 'gzip' ? 'gzip' : 'zstd, gzip'
+    });
+    const responseSliceSize = Number(downloadResult.headers['x-slice-size']);
+    const suggestedSliceSize = Number(downloadResult.headers['x-suggested-slice-size'] ?? DEFAULT_DATA_FEED_SLICE_SIZE);
+    debug('getDataFeedSlice fetched from API and cached, %s, sliceSize: %d', sliceKey, responseSliceSize);
+    const message = {
+        sliceKey,
+        slicePath: downloadResult.downloadPath,
+        sliceSize: responseSliceSize
+    };
+    parentPort.postMessage(message);
+    return {
+        sliceSize: responseSliceSize,
+        suggestedSliceSize
+    };
+}
+//# sourceMappingURL=worker.js.map

package/node_modules/tardis-dev/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"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"}

package/node_modules/tardis-dev/example.js

@@ -0,0 +1,171 @@
+import { parseArgs } from 'node:util'
+import {
+  init,
+  normalizeBookChanges,
+  normalizeBookTickers,
+  normalizeDerivativeTickers,
+  normalizeLiquidations,
+  normalizeOptionsSummary,
+  normalizeTrades,
+  replay,
+  replayNormalized,
+  stream,
+  streamNormalized
+} from './dist/index.js'
+
+const options = getOptions(process.argv.slice(2))
+const optionsError = getOptionsError(options)
+if (optionsError !== undefined) {
+  console.error(`${optionsError}
+
+Usage:
+  node example.js stream <exchange> <symbol> <channel>
+  node example.js replay <exchange> <symbol> <channel> <from> <to>
+
+Options:
+  --normalized       use normalized <data-type> instead of native <channel>
+  --endpoint <url>   override API endpoint, default: https://api.tardis.dev/v1
+                     local API example: http://127.0.0.1:8787/v1
+  --api-key <key>    override API key, default: TARDIS_DEV_API_KEY env var
+                     local API example: TD.LOCAL.DEV.API.KEY
+  --limit <n>        stop after n messages
+
+Examples:
+  node example.js stream mexc-futures BTC_USDT push.depth
+  node example.js replay mexc-futures BTC_USDT push.depth 2026-06-17 2026-06-18
+  node example.js --normalized stream mexc-futures BTC_USDT book_change
+  node example.js --normalized replay mexc-futures BTC_USDT book_change 2026-06-17 2026-06-18`)
+  process.exit(1)
+}
+
+init(options.init)
+
+let messagesCount = 0
+for await (const message of createMessageStream(options)) {
+  if (message === undefined || message?.type === 'disconnect') {
+    console.log({ type: 'disconnect' })
+    continue
+  }
+
+  console.log(message)
+  messagesCount++
+  if (options.limit !== undefined && messagesCount >= options.limit) {
+    break
+  }
+}
+
+function getOptions(args) {
+  const { values, positionals } = parseArgs({
+    args,
+    options: {
+      normalized: { type: 'boolean' },
+      endpoint: { type: 'string' },
+      'api-key': { type: 'string' },
+      limit: { type: 'string' }
+    },
+    allowPositionals: true
+  })
+  const [mode, exchange, symbol, channelOrDataType, from, to] = positionals
+  const normalized = values.normalized === true
+  const apiKey = values['api-key'] ?? process.env.TARDIS_DEV_API_KEY
+
+  const normalizersByDataType = {
+    trade: normalizeTrades,
+    book_change: normalizeBookChanges,
+    derivative_ticker: normalizeDerivativeTickers,
+    option_summary: normalizeOptionsSummary,
+    liquidation: normalizeLiquidations,
+    book_ticker: normalizeBookTickers
+  }
+
+  return {
+    mode, // 'stream' or 'replay'
+    normalized,
+    exchange,
+    symbol,
+    channel: normalized ? undefined : channelOrDataType,
+    dataType: normalized ? channelOrDataType : undefined,
+    normalizer: normalized ? normalizersByDataType[channelOrDataType] : undefined,
+    from,
+    to,
+    init: {
+      ...(values.endpoint === undefined ? {} : { endpoint: values.endpoint }),
+      ...(apiKey === undefined ? {} : { apiKey })
+    },
+    limit: values.limit === undefined ? undefined : Number(values.limit)
+  }
+}
+
+function getOptionsError(options) {
+  if (options.mode !== 'stream' && options.mode !== 'replay') {
+    return 'Missing or invalid mode. Expected "stream" or "replay".'
+  }
+  if (options.exchange === undefined) {
+    return 'Missing exchange name.'
+  }
+  if (options.symbol === undefined) {
+    return 'Missing symbol.'
+  }
+  if (options.normalized && options.dataType === undefined) {
+    return 'Missing normalized data type.'
+  }
+  if (options.normalized === false && options.channel === undefined) {
+    return 'Missing native channel.'
+  }
+  if (options.normalized && options.normalizer === undefined) {
+    return `Invalid normalized data type "${options.dataType}".`
+  }
+  if (options.mode === 'replay' && (options.from === undefined || options.to === undefined)) {
+    return 'Replay mode requires from and to dates.'
+  }
+  if (options.limit !== undefined && (!Number.isSafeInteger(options.limit) || options.limit <= 0)) {
+    return 'Invalid limit. Expected a positive integer.'
+  }
+}
+
+function createMessageStream(options) {
+  if (options.normalized) {
+    if (options.mode === 'stream') {
+      return streamNormalized(
+        {
+          exchange: options.exchange,
+          symbols: [options.symbol],
+          timeoutIntervalMS: 20_000,
+          withDisconnectMessages: true,
+          onError: (error) => console.error(`[${options.exchange}] ${error.message}`)
+        },
+        options.normalizer
+      )
+    }
+
+    return replayNormalized(
+      {
+        exchange: options.exchange,
+        symbols: [options.symbol],
+        from: options.from,
+        to: options.to,
+        withDisconnectMessages: true
+      },
+      options.normalizer
+    )
+  }
+
+  const nativeFilters = [{ channel: options.channel, symbols: [options.symbol] }]
+  if (options.mode === 'stream') {
+    return stream({
+      exchange: options.exchange,
+      filters: nativeFilters,
+      timeoutIntervalMS: 20_000,
+      withDisconnects: true,
+      onError: (error) => console.error(`[${options.exchange}] ${error.message}`)
+    })
+  }
+
+  return replay({
+    exchange: options.exchange,
+    from: options.from,
+    to: options.to,
+    filters: nativeFilters,
+    withDisconnects: true
+  })
+}

package/node_modules/tardis-dev/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "tardis-dev",
+  "version": "18.0.1",
+  "engines": {
+    "node": ">=24.5"
+  },
+  "devEngines": {
+    "runtime": {
+      "name": "node",
+      "version": ">=24.5"
+    },
+    "packageManager": {
+      "name": "npm",
+      "version": ">=11.17.0"
+    }
+  },
+  "description": "Convenient access to tick-level historical and real-time cryptocurrency market data via Node.js",
+  "main": "dist/index.js",
+  "source": "src/index.ts",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": "tardis-dev/tardis-node",
+  "homepage": "https://docs.tardis.dev/api/node-js",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && tsc -p test/tsconfig.json && node --experimental-test-module-mocks --test --test-concurrency=4 test/*.test.ts",
+    "test:update-snapshots": "npm run build && tsc -p test/tsconfig.json && node --experimental-test-module-mocks --test --test-concurrency=4 --test-update-snapshots test/*.test.ts",
+    "prepare": "npm run build",
+    "format": "prettier --write .",
+    "check-format": "prettier --check ."
+  },
+  "files": [
+    "src",
+    "dist",
+    "example.js"
+  ],
+  "keywords": [
+    "cryptocurrency data feed",
+    "market data",
+    "api client",
+    "crypto markets data replay",
+    "historical data",
+    "real-time cryptocurrency market data feed",
+    "historical cryptocurrency prices",
+    "cryptocurrency api",
+    "real-time normalized WebSocket cryptocurrency markets data",
+    "normalized cryptocurrency market data API",
+    "order book reconstruction",
+    "market data normalization",
+    "cryptocurrency api",
+    "cryptocurrency",
+    "orderbook",
+    "exchange",
+    "websocket",
+    "realtime",
+    "bitmex",
+    "binance",
+    "trading",
+    "high granularity order book data"
+  ],
+  "license": "MPL-2.0",
+  "dependencies": {
+    "debug": "^4.4.3",
+    "follow-redirects": "^1.16.0",
+    "protobufjs": "^8.7.1",
+    "ws": "^8.21.1"
+  },
+  "devDependencies": {
+    "@types/debug": "^4.1.13",
+    "@types/follow-redirects": "^1.14.4",
+    "@types/node": "^26.1.1",
+    "@types/ws": "^8.18.1",
+    "prettier": "3.8.3",
+    "typescript": "^6.0.3"
+  },
+  "runkitExampleFilename": "example.js"
+}

package/node_modules/tardis-dev/src/apikeyaccessinfo.ts

@@ -0,0 +1,25 @@
+import { getJSON } from './handy.ts'
+import { getOptions } from './options.ts'
+import { Exchange } from './types.ts'
+
+export async function getApiKeyAccessInfo(apiKey?: string) {
+  const options = getOptions()
+  const apiKeyToCheck = apiKey || options.apiKey
+
+  const { data } = await getJSON<ApiKeyAccessInfo>(`${options.endpoint}/api-key-info`, {
+    headers: {
+      Authorization: `Bearer ${apiKeyToCheck}`
+    }
+  })
+
+  return data
+}
+
+export type ApiKeyAccessInfo = {
+  exchange: Exchange
+  accessType: string
+  from: string
+  to: string
+  symbols: string[]
+  dataPlan: string
+}[]