---
id: tardis-client
version: "1.4.2"
license: MPL-2.0
license_treatment: copyleft
maintenance: active
---

# tardis-client — Python client for tardis.dev - historical tick-level cryptocurrency market data replay API.

License: copyleft · Maintenance: active · Downloads: 777.0K/mo

## What it is and what it does

tardis-client was a Python async client for replaying historical tick-level cryptocurrency market data from the tardis.dev API. It provided methods to stream trades, orderbook snapshots, and other market events from multiple exchanges (BitMEX, Deribit, etc.) within a specified date range, along with local cache management. The package depended on aiohttp for HTTP requests, aiofiles for async file I/O, and sortedcontainers for efficient data structures.

As of version 1.4.2 (released 2026-03-26), tardis-client is deprecated and frozen. The package no longer receives new features or maintenance. Its sole purpose now is to direct existing users to tardis-dev, the unified replacement that consolidates replay, dataset downloads, exchange metadata, and cache helpers into a single package. The description includes migration examples showing how to port replay and cache-clearing code to the new API.

Use it for:

- Backtest trading strategies using historical cryptocurrency market data from multiple exchanges.
- Analyze historical orderbook and trade data for market microstructure research.
- Replay market events for debugging or validating trading algorithms offline.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

tardis-client is a deprecated Python client for historical cryptocurrency market data replay from tardis.dev; users should migrate to tardis-dev instead.

No. This package is deprecated and frozen as of 1.4.2. Install tardis-dev instead, which is the active replacement. tardis-client exists only to point users to the migration path; no new features or maintenance will be added. If you are already using it, follow the migration guide in the package description.

## Install

pip install tardis-client
uv add tardis-client
poetry add tardis-client

## Installing tardis-client

Before you install: Low install friction with three lightweight async dependencies (aiohttp, aiofiles, sortedcontainers). However, the package is frozen and no longer maintained—version 1.4.2 exists only to direct users to tardis-dev.

License in practice: Licensed under MPL-2.0 (copyleft), which requires derivative works to disclose source and license under the same terms. For a deprecated package, this is academic unless you are maintaining a fork.

Quickstart:

# Old API (deprecated)
from tardis_client import TardisClient, Channel

client = TardisClient(api_key="YOUR_API_KEY")
async for item in client.replay(
    exchange="bitmex",
    from_date="2019-06-01",
    to_date="2019-06-02",
    filters=[Channel("trade", ["XBTUSD"])],
):
    print(item)

Requires Python 3.8 or later; async/await runtime needed. Package is frozen and will not receive updates.

Verify before relying:

- Whether tardis-dev is a drop-in replacement or requires significant code refactoring beyond the migration examples shown.
- Performance or feature parity between tardis-client 1.4.2 and tardis-dev for existing workloads.

## Package facts

- License: MPL-2.0 (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 777.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cryptocurrency market data replay, historical crypto tick data, tardis.dev python client, crypto orderbook replay, exchange data api client, deprecated, cryptocurrency-data, market-replay

[View on SkillFed](https://skillfed.io/packages/tardis-client) · [View on PyPI](https://pypi.org/project/tardis-client/)