Whalemini/binance-futures-ohlcv-2018-2026

---
license: mit
task_categories:
- time-series-forecasting
language:
- en
- zh
tags:
- cryptocurrency
- bitcoin
- ethereum
- trading
- binance
- ohlcv
- futures
- timeseries
- quantitative-finance
size_categories:
- 10M<n<100M
---

# 🐱 币安期货 Main4 数据集 (BTC/ETH/BNB/SOL)

**精简版币安期货历史数据** - 只包含 4 个主要币种，适合快速下载和研究使用。


---

## 📊 数据概览

| 文件 | 记录数 | 压缩大小 | 时间范围 | 说明 |
|------|--------|----------|----------|------|
| `candles_1m_main4_*.bin.zst` | 998 万 | 366 MB | 2020-01 ~ 2026-01 | 1分钟K线 (Binary) |
| `futures_metrics_main4_*.bin.zst` | 152 万 | 49 MB | 2021-12 ~ 2026-01 | 期货指标 (Binary) |
| `schema_*.sql.zst` | - | 6.3 KB | - | TimescaleDB Schema |

**总计**: 1150 万条记录，压缩后约 415MB

---

## 🎯 包含币种

| 币种 | K线记录数 | K线时间范围 | 期货指标记录数 | 完整度 |
|------|-----------|-------------|----------------|--------|
| **BTCUSDT** | 317 万 | 2020-01-01 ~ 2026-01-11 | 43 万 | 100% |
| **ETHUSDT** | 317 万 | 2020-01-01 ~ 2026-01-11 | 24 万 | 100% |
| **BNBUSDT** | 311 万 | 2020-02-10 ~ 2026-01-11 | 43 万 | 100% |
| **SOLUSDT** | 53 万 | 2025-01-01 ~ 2026-01-04 | 43 万 | 99.99% |

---

## 📁 数据字段

### 📈 candles_1m (1分钟K线)

| 字段 | 类型 | 说明 | 示例 |
|------|------|------|------|
| `exchange` | string | 交易所 | binance_futures_um |
| `symbol` | string | 交易对 | BTCUSDT |
| `bucket_ts` | timestamp | K线时间 (UTC) | 2024-01-01 00:00:00 |
| `open` | decimal | 开盘价 | 42150.50 |
| `high` | decimal | 最高价 | 42180.00 |
| `low` | decimal | 最低价 | 42100.00 |
| `close` | decimal | 收盘价 | 42165.30 |
| `volume` | decimal | 成交量 (币) | 125.5 |
| `quote_volume` | decimal | 成交额 (USDT) | 5289150.25 |
| `trade_count` | int | 成交笔数 | 3521 |
| `taker_buy_volume` | decimal | 主动买入量 | 68.2 |
| `taker_buy_quote_volume` | decimal | 主动买入额 | 2875420.10 |

### 📊 futures_metrics_5m (期货指标)

| 字段 | 类型 | 说明 | 用途 |
|------|------|------|------|
| `create_time` | timestamp | 时间戳 (UTC) | 数据时间 |
| `symbol` | string | 交易对 | 币种标识 |
| `sum_open_interest` | decimal | 持仓量 (张) | 市场参与度 |
| `sum_open_interest_value` | decimal | 持仓价值 (USDT) | 资金规模 |
| `sum_toptrader_long_short_ratio` | decimal | 大户多空比 | 主力方向 |
| `sum_taker_long_short_vol_ratio` | decimal | 主动买卖比 | 即时情绪 |
| `count_long_short_ratio` | decimal | 散户多空比 | 散户情绪 |

---

## 🚀 快速使用

### 数据格式说明

本数据集使用 **PostgreSQL COPY Binary + Zstandard** 格式压缩，需要导入 TimescaleDB 使用。

### 恢复到 TimescaleDB

```bash
# 1. 解压并恢复 schema
zstd -d schema_*.sql.zst -c | psql -h localhost -p 5433 -U postgres -d market_data

# 2. 恢复 K线数据
zstd -d candles_1m_main4_*.bin.zst -c | psql -h localhost -p 5433 -U postgres -d market_data \
-c "COPY market_data.candles_1m FROM STDIN WITH (FORMAT binary)"

# 3. 恢复期货指标
zstd -d futures_metrics_main4_*.bin.zst -c | psql -h localhost -p 5433 -U postgres -d market_data \
-c "COPY market_data.binance_futures_metrics_5m FROM STDIN WITH (FORMAT binary)"
```

### 或使用恢复脚本

```bash
chmod +x restore_main4_*.sh
./restore_main4_*.sh
```

### 查询示例

```sql
-- 查看 BTC 最近数据
SELECT * FROM market_data.candles_1m
WHERE symbol = 'BTCUSDT'
ORDER BY bucket_ts DESC
LIMIT 10;

-- 统计各币种数据量
SELECT symbol, COUNT(*), MIN(bucket_ts), MAX(bucket_ts)
FROM market_data.candles_1m
GROUP BY symbol;

-- BTC 日K聚合
SELECT
time_bucket('1 day', bucket_ts) AS day,
FIRST(open, bucket_ts) AS open,
MAX(high) AS high,
MIN(low) AS low,
LAST(close, bucket_ts) AS close,
SUM(volume) AS volume
FROM market_data.candles_1m
WHERE symbol = 'BTCUSDT'
GROUP BY day
ORDER BY day DESC;
```

---

## 📈 应用场景

| 场景 | 说明 |
|------|------|
| 🤖 **量化回测** | 策略历史验证，分钟级精度 |
| 🧠 **机器学习** | 价格预测、趋势分类、异常检测 |
| 📊 **技术分析** | 计算各类技术指标 (MA/RSI/MACD等) |
| 💹 **市场研究** | 波动率分析、相关性分析 |
| 📉 **情绪分析** | 多空比、持仓量变化分析 |

---

## 🔄 数据来源

- **交易所**: Binance Futures (USDT-M 永续合约)
- **采集方式**: WebSocket 实时推送 + REST API 历史回填
- **数据延迟**: < 5 秒
- **导出时间**: 2026-01-11

---

## 📦 完整版数据集

如需全部 615+ 币种的完整数据，请查看：
- **Kaggle**: [binance-crypto-ohlcv-futures](https://www.kaggle.com/datasets/tukuaiai/binance-crypto-ohlcv-futures)

---

## ⚠️ 免责声明

- 本数据集仅供教育和研究目的
- 不构成任何投资建议
- 加密货币交易存在重大风险
- 使用前请自行验证数据准确性

---

## 🔗 相关链接

- 📦 **项目源码**: [TradeCat](https://github.com/tukuaiai/tradecat)
- 📢 **Telegram 频道**: [@tradecat_ai_channel](https://t.me/tradecat_ai_channel)
- 💬 **交流群**: [@glue_coding](https://t.me/glue_coding)
- 🐦 **Twitter**: [@123olp](https://x.com/123olp)

---

## 📜 许可证

MIT License - 可自由用于商业和研究用途

---

## ❤️ 支持项目

如果这个数据集对你有帮助，欢迎：
- ⭐ 给项目点 Star
- 📢 分享给更多人

| 网络 | 地址 |
|------|------|
| **币安 UID** | `572155580` |
| **Tron (TRC20)** | `TQtBXCSTwLFHjBqTS4rNUp7ufiGx51BRey` |
| **Solana** | `HjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau` |
| **Ethereum (ERC20)** | `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC` |

---
许可证：MIT许可证（MIT License）
任务类别：
- 时间序列预测（time-series-forecasting）
语言：
- 英语
- 汉语
标签：
- 加密货币（cryptocurrency）
- 比特币（bitcoin）
- 以太坊（ethereum）
- 交易（trading）
- 币安（binance）
- OHLCV
- 期货（futures）
- 时间序列（timeseries）
- 量化金融（quantitative-finance）
数据规模：1000万条 < 记录数 < 1亿条
---

# 🐱 币安期货Main4数据集（BTC/ETH/BNB/SOL）

**币安期货历史数据精简版** — 仅涵盖四大主流币种，便于快速下载与研究使用。


---

## 📊 数据概览

| 文件路径 | 记录数 | 压缩大小 | 时间范围 | 说明 |
|------|--------|----------|----------|------|
| `candles_1m_main4_*.bin.zst` | 998万 | 366 MB | 2020-01 ~ 2026-01 | 1分钟K线（二进制格式） |
| `futures_metrics_main4_*.bin.zst` | 152万 | 49 MB | 2021-12 ~ 2026-01 | 期货指标数据（二进制格式） |
| `schema_*.sql.zst` | - | 6.3 KB | - | TimescaleDB数据库模式文件 |

**总数据量**：1150万条记录，压缩后总大小约415MB

---

## 🎯 覆盖币种

| 交易对 | K线记录数 | K线时间范围 | 期货指标记录数 | 数据完整度 |
|------|-----------|-------------|----------------|--------|
| **BTCUSDT** | 317万 | 2020-01-01 ~ 2026-01-11 | 43万 | 100% |
| **ETHUSDT** | 317万 | 2020-01-01 ~ 2026-01-11 | 24万 | 100% |
| **BNBUSDT** | 311万 | 2020-02-10 ~ 2026-01-11 | 43万 | 100% |
| **SOLUSDT** | 53万 | 2025-01-01 ~ 2026-01-04 | 43万 | 99.99% |

---

## 📁 数据字段

### 📈 1分钟K线数据（candles_1m）

| 字段名 | 数据类型 | 字段说明 | 示例值 |
|------|------|------|------|
| `exchange` | 字符串 | 交易所标识 | binance_futures_um |
| `symbol` | 字符串 | 交易对标识 | BTCUSDT |
| `bucket_ts` | 时间戳（UTC） | K线窗口时间 | 2024-01-01 00:00:00 |
| `open` | 十进制数 | 开盘价 | 42150.50 |
| `high` | 十进制数 | 最高价 | 42180.00 |
| `low` | 十进制数 | 最低价 | 42100.00 |
| `close` | 十进制数 | 收盘价 | 42165.30 |
| `volume` | 十进制数 | 成交量（基础币种） | 125.5 |
| `quote_volume` | 十进制数 | 成交额（USDT计价） | 5289150.25 |
| `trade_count` | 整数 | 成交笔数 | 3521 |
| `taker_buy_volume` | 十进制数 | 主动买入成交量 | 68.2 |
| `taker_buy_quote_volume` | 十进制数 | 主动买入成交额（USDT计价） | 2875420.10 |

### 📊 期货指标数据（futures_metrics_5m）

| 字段名 | 数据类型 | 字段说明 | 业务用途 |
|------|------|------|------|
| `create_time` | 时间戳（UTC） | 数据生成时间 | 数据时间戳 |
| `symbol` | 字符串 | 交易对标识 | 币种唯一标识 |
| `sum_open_interest` | 十进制数 | 持仓量（合约张数） | 市场参与度指标 |
| `sum_open_interest_value` | 十进制数 | 持仓总价值（USDT计价） | 市场资金规模指标 |
| `sum_toptrader_long_short_ratio` | 十进制数 | 大户多空持仓比 | 主力资金方向指标 |
| `sum_taker_long_short_vol_ratio` | 十进制数 | 主动买卖成交量比 | 即时市场情绪指标 |
| `count_long_short_ratio` | 十进制数 | 散户多空持仓比 | 散户情绪指标 |

---

## 🚀 快速使用指南

### 数据格式说明
本数据集采用**PostgreSQL COPY二进制格式 + Zstandard压缩**，需导入至TimescaleDB时序数据库中使用。

### 导入至TimescaleDB
bash
# 1. 解压并恢复数据库模式
zstd -d schema_*.sql.zst -c | psql -h localhost -p 5433 -U postgres -d market_data

# 2. 导入1分钟K线数据
zstd -d candles_1m_main4_*.bin.zst -c | psql -h localhost -p 5433 -U postgres -d market_data
-c "COPY market_data.candles_1m FROM STDIN WITH (FORMAT binary)"

# 3. 导入期货指标数据
zstd -d futures_metrics_main4_*.bin.zst -c | psql -h localhost -p 5433 -U postgres -d market_data
-c "COPY market_data.binance_futures_metrics_5m FROM STDIN WITH (FORMAT binary)"

### 或使用官方恢复脚本
bash
chmod +x restore_main4_*.sh
./restore_main4_*.sh

### 示例查询语句
sql
-- 查询BTCUSDT最新10条K线数据
SELECT * FROM market_data.candles_1m
WHERE symbol = 'BTCUSDT'
ORDER BY bucket_ts DESC
LIMIT 10;

-- 统计各币种K线数据量
SELECT symbol, COUNT(*), MIN(bucket_ts), MAX(bucket_ts)
FROM market_data.candles_1m
GROUP BY symbol;

-- BTCUSDT日K线聚合统计
SELECT
time_bucket('1 day', bucket_ts) AS day,
FIRST(open, bucket_ts) AS 开盘价,
MAX(high) AS 最高价,
MIN(low) AS 最低价,
LAST(close, bucket_ts) AS 收盘价,
SUM(volume) AS 总成交量
FROM market_data.candles_1m
WHERE symbol = 'BTCUSDT'
GROUP BY day
ORDER BY day DESC;

---

## 📈 应用场景

| 应用场景 | 详细说明 |
|------|------|
| 🤖 **量化回测** | 用于交易策略的历史回测，支持分钟级精度的全量数据验证 |
| 🧠 **机器学习建模** | 可用于价格预测、趋势分类、异常检测等任务 |
| 📊 **技术分析** | 支持各类技术指标（MA/RSI/MACD等）的计算与可视化 |
| 💹 **市场研究** | 用于加密货币波动率分析、币种相关性分析等研究 |
| 📉 **市场情绪分析** | 基于多空持仓比、持仓量变化等指标进行市场情绪研判 |

---

## 🔄 数据来源

- **交易所**：币安USDT保证金永续合约（Binance Futures USDT-M）
- **采集方式**：WebSocket实时数据推送 + REST API历史数据回填
- **数据延迟**：<5秒
- **数据导出时间**：2026-01-11

---

## 📦 全量数据集

如需获取涵盖615+币种的完整加密货币期货数据，请访问：
- **Kaggle平台**：[binance-crypto-ohlcv-futures](https://www.kaggle.com/datasets/tukuaiai/binance-crypto-ohlcv-futures)

---

## ⚠️ 免责声明

- 本数据集仅用于教育与研究目的，不构成任何投资建议
- 加密货币交易存在重大市场风险，参与前请谨慎评估
- 使用本数据集前请自行验证数据准确性

---

## 🔗 相关链接

- 📦 **项目源码仓库**：[TradeCat](https://github.com/tukuaiai/tradecat)
- 📢 **Telegram官方频道**：[@tradecat_ai_channel](https://t.me/tradecat_ai_channel)
- 💬 **技术交流社群**：[@glue_coding](https://t.me/glue_coding)
- 🐦 **Twitter官方账号**：[@123olp](https://x.com/123olp)

---

## 📜 许可证

MIT许可证（MIT License）—— 可自由用于商业与非商业研究用途

---

## ❤️ 项目支持

若本数据集对你的研究或工作有所帮助，欢迎：
- ⭐ 为项目仓库点亮Star
- 📢 分享给更多有需要的从业者与研究者

| 支持渠道 | 地址 |
|------|------|
| **币安UID** | `572155580` |
| **波场TRC20** | `TQtBXCSTwLFHjBqTS4rNUp7ufiGx51BRey` |
| **Solana链地址** | `HjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau` |
| **以太坊ERC20地址** | `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC` |