REST API Introduction

The CryptoHFTData REST API provides direct access to our cryptocurrency market data without requiring the Python SDK. This is ideal for developers using other programming languages or those who prefer direct HTTP requests.

API Endpoint

Base URL: https://api.cryptohftdata.com

Download Endpoint: GET /download

Data Structure & File Paths

All data is organized in hourly chunks (using UTC time) and stored as compressed Parquet files. Each file contains data for a specific hour of a specific trading pair and data type.

File Path Pattern

{exchange}/{YYYY-MM-DD}/{HH}/{symbol}_{data_type}.parquet.zst

Examples:

binance_spot/2025-08-01/20/BTCUSDT_trades.parquet.zst
binance_futures/2025-08-01/20/ETHUSDT_orderbook.parquet.zst
bybit/2025-08-01/20/BTCUSDT_liquidations.parquet.zst

Data Types Available

Spot Markets

orderbook L2 snapshots
trades Individual executions
ticker 24h statistics

Futures Markets

orderbook L2 snapshots
trades Individual executions
ticker 24h statistics
mark_price Mark price updates
open_interest Open interest data
liquidations Liquidation events

File Format

All data files are stored as Parquet format compressed with Zstandard (zstd) compression. Parquet provides efficient columnar storage with excellent compression ratios and fast query performance.

Processing Required

Downloaded files need to be decompressed (zstd) and then read as Parquet files. Most programming languages have libraries to handle both operations.