Raw data
Every trade printed on the venue, with its trade id, taker side, price and size.
/api/v1/data/raw/trades
exchange_timestamp | timestamp | When the venue says the event happened (UTC, µs). Exact. |
local_timestamp | timestamp | When the event reached our capture machine (UTC, µs). |
id | string | Venue trade id |
side | string | Taker side: "buy", "sell" or "unknown" |
price | float64 | Trade price |
amount | float64 | Trade size. Base asset on Binance USDⓈ-M and Hyperliquid, contracts on OKX |
| Venue | Symbols | From |
|---|---|---|
| Binance | 1015 | Jan 2020 |
| OKX | 747 | Sep 2019 |
| Hyperliquid | 550 | Jan 2025 |
One file per calendar month before 2026-08-01, one per day from then on, in the aperiodic-raw-trades bucket. Example key:
v1/trades/exchange=binance-futures/symbol=perpetual-BTC-USDT:USDT/year=2025/month=06/data.parquet
The shared DEMO-KEY gets the 2025-06 file of the BTC perpetual on Binance and OKX. No account needed.
# Install the Aperiodic CLI into ~/.local/bin
mkdir -p "$HOME/.local/bin"
curl -fsSL https://raw.githubusercontent.com/aperiodic-io/cli/main/install.sh | INSTALL_DIR="$HOME/.local/bin" bash
export PATH="$HOME/.local/bin:$PATH"
# Download the 2025-06 trades file into ./raw — no API key needed
aperiodic raw trades --preview \
--exchange binance-futures \
--symbol perpetual-BTC-USDT:USDT \
--output-dir ./raw && echo "Saved to $PWD/raw"exchange_timestamp is the venue's own time. local_timestamp is when the event reached our capture machine.