---
id: tardis-dev
version: "4.3.0"
license: MPL-2.0
license_treatment: copyleft
maintenance: active
---

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

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

## What it is and what it does

tardis-dev is a Python async client for the Tardis.dev API, designed to fetch and replay historical cryptocurrency market data at tick granularity from multiple exchanges. It abstracts away HTTP polling and connection management, letting you iterate over timestamped market events (trades, orderbook updates) as if replaying a live feed. The package supports two primary workflows: streaming historical data through an async iterator for backtesting or analysis, and bulk downloading datasets as CSV files for offline processing.

The package requires Python 3.9+ and depends on aiohttp for HTTP requests, python-dateutil for flexible date parsing, aiofiles for async file I/O during downloads, and zstandard for decompression. It is actively maintained, carries no known security vulnerabilities, and is positioned as the v3 API—users of the older tardis-client package should migrate to the new top-level functions (replay, download_datasets, clear_cache).

Use it for:

- Backtest trading strategies using historical tick-level data from multiple crypto exchanges without manual data collection.
- Build market microstructure analysis tools that need precise orderbook snapshots and trade events in exchange-native format.
- Download and archive historical cryptocurrency price and volume data as CSV for research or reporting.
- Replay market conditions from a specific date range to validate order execution logic or risk models.
- Feed historical data into live trading systems for dry runs before deploying to production.

## Worth the install?

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

Provides async access to tick-level historical cryptocurrency market data from multiple exchanges via the Tardis.dev API, supporting both live replay and CSV download workflows.

Yes. The package is actively maintained, has no known vulnerabilities, and solves a specific problem—accessing tick-level crypto market data—with low install friction. The MPL-2.0 copyleft license is a consideration only if you plan to redistribute or embed it in proprietary code. Install it if you need historical cryptocurrency market replay or bulk data downloads; skip it if you need real-time streaming or normalized data across exchanges.

## Install

pip install tardis-dev
uv add tardis-dev
poetry add tardis-dev

## Installing tardis-dev

Before you install: Low friction install with four runtime dependencies (aiohttp, python-dateutil, aiofiles, zstandard). Package is actively maintained with a recent release and no known vulnerabilities.

License in practice: Licensed under MPL-2.0 (copyleft), which requires derivative works to disclose source code modifications under the same license—relevant if you plan to redistribute or embed this package in a proprietary product.

Quickstart:

pip install tardis-dev

import asyncio
from tardis_dev import Channel, replay

async def main():
    async for local_timestamp, message in replay(
        exchange="binance",
        from_date="2024-03-01",
        to_date="2024-03-02",
        filters=[Channel("trade", ["btcusdt"])],
        api_key="YOUR_API_KEY",
    ):
        print(local_timestamp, message)

asyncio.run(main())

Requires Python 3.9+; Tardis.dev API key required for data access.

Verify before relying:

- Whether Tardis.dev API key is required for all use cases or only certain data types
- Scope and completeness of exchange coverage beyond the reference to docs.tardis.dev
- Data retention and update frequency for historical datasets across supported exchanges

## Package facts

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

## Tags

cryptocurrency historical market data, crypto tick-level data replay, exchange market data api client, historical orderbook data, crypto data download csv, market data backtest feed, async crypto data client, crypto-data, async-client, backtesting

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