Exchange Data Downloader

exchange-data-downloader — простая библиотека для скачивания и распаковки исторических данных с криптовалютных бирж (Binance и Bybit). Она автоматически создаёт структуру папок, кэширует уже загруженные файлы и умеет работать с разными типами данных (klines, trades, funding и др.). Отлично подходит для бэктестов, аналитических пайплайнов и подготовки датасетов.

Установка

pip install exchange-data-downloader

или

uv add exchange-data-downloader

или

poetry add exchange-data-downloader

Быстрый старт

from exdata.binance import Downloader

downloader = Downloader(data_folder_path="data/binance")
csv_path = downloader.download(
    symbol="BTCUSDT",
    year=2024,
    month=4,
    timeframe="1h",
    market_type="futures/um",
    period_type="monthly",
    data_type="klines",
    unzip=True,
)

print(f"Файл сохранён по пути: {csv_path}")

• year, month, day передаются числами — библиотека сама добавит ведущие нули.
• Если файл уже скачан и распакован, повторный вызов просто вернёт путь из кэша.
• Параметр unzip по умолчанию равен False — библиотека вернёт путь к ZIP. Передайте unzip=True, если нужен путь к распакованному CSV.

Дополнительные примеры

Загрузка дневных trades

csv_path = downloader.download(
    symbol="TRXUSDT",
    year=2025,
    month=3,
    day=15,
    data_type="trades",
    period_type="daily",
    market_type="spot",
)

Обход диапазона дат

from exdata.utils import generate_intervals

intervals = generate_intervals(
    start_year=2024,
    start_month=12,
    start_day=1,
    end_year=2025,
    end_month=1,
    end_day=5,
)

for current in intervals:
    downloader.download(
        symbol="ETHUSDT",
        year=current.year,
        month=current.month,
        day=current.day,
        data_type="aggTrades",
        period_type="daily",
        market_type="futures/um",
        timeframe=None,
    )

Функция generate_intervals возвращает кортеж объектов date, что упрощает обход диапазонов.

Bybit

Данные берутся с public.bybit.com. Доступны только сделки (trades):

from exdata import BybitDownloader

downloader = BybitDownloader(data_folder_path="data/bybit")

# Сделки по фьючерсу за день
csv_path = downloader.download(
    symbol="BTCUSDT",
    year=2025,
    month=3,
    day=15,
    market_type="futures",
    period_type="daily",
    unzip=True,
)

# Сделки по споту за месяц
gz_path = downloader.download(
    symbol="ETHUSDT",
    year=2025,
    month=3,
    market_type="spot",
    period_type="monthly",
)

• Архивы Bybit имеют формат .csv.gz. При unzip=False возвращается путь к .csv.gz, при unzip=True — к распакованному .csv.
• Время в файлах: у фьючерсов — секунды (float), у спота — миллисекунды.
• Файл monthly для спота появляется только после окончания месяца.
• Для market_type="futures" доступен только period_type="daily", иначе будет InvalidParamsError.
• Параметра timeframe нет: свечи Bybit (kline_for_metatrader4) библиотека не поддерживает.

Полезные замечания

• Для kline-подобных типов (klines, markPriceKlines, indexPriceKlines и т.д.) параметр timeframe обязателен.
• Для period_type="daily" необходимо указать день (day), для monthly — наоборот, day не используется.
• Библиотека выбрасывает InvalidParamsError, если параметры указаны некорректно, и NotFoundError, если источник не вернул данные.

Используйте exchange-data-downloader, чтобы не тратить время на ручные скачивания и сосредоточиться на аналитике. Удачных тестов!