tardis-dev

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 on this page — 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

tardis-dev on PyPI

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

Evidence: tardis_dev-4.3.0-py3-none-any.whl

Keywords: cryptocurrency data feed, market data, api client, orderbook, crypto markets data replay, historical data, historical cryptocurrency prices, cryptocurrency api

Tags

More WWW/HTTP packages