🚨 Free Crypto Data for ML & Research — High-quality on-chain and derivatives market data that typically costs $500-2000+/month from commercial providers. Help us keep this free!
Automated cryptocurrency on-chain and derivatives market data collection for ML model training and trading signal analysis.
|
The easiest way to support us! Stars help others discover this project. |
Get notified about new datasets and features. |
Help spread the word! Every share helps keep this project alive.
Data is organized by granularity (time frequency):
data/
└── daily/ # Daily aggregated data (1 data point per day)
Browse the data/daily/ folder for all available datasets.
| Dataset | File |
|---|---|
| BTC Exchange Netflow | data/daily/btc_exchange_netflow.json |
| BTC Exchange Reserve | data/daily/btc_exchange_reserve.json |
| BTC Exchange Reserve USD | data/daily/btc_exchange_reserve_usd.json |
| BTC Exchange Inflow Total | data/daily/btc_exchange_inflow_total.json |
| BTC Exchange Outflow Total | data/daily/btc_exchange_outflow_total.json |
| BTC Exchange Whale Ratio | data/daily/btc_exchange_whale_ratio.json |
| BTC Exchange Stablecoins Ratio | data/daily/btc_exchange_stablecoins_ratio.json |
| BTC Exchange Stablecoins Ratio USD | data/daily/btc_exchange_stablecoins_ratio_usd.json |
| Stablecoin Exchange Netflow | data/daily/stablecoin_exchange_netflow.json |
| Stablecoin Exchange Reserve | data/daily/stablecoin_exchange_reserve.json |
| Stablecoin Exchange Inflow Total | data/daily/stablecoin_exchange_inflow_total.json |
| Stablecoin Exchange Outflow Total | data/daily/stablecoin_exchange_outflow_total.json |
| Dataset | File |
|---|---|
| BTC Miners Position Index | data/daily/btc_miners_position_index.json |
| BTC Miner Netflow Total | data/daily/btc_miner_netflow_total.json |
| BTC Puell Multiple | data/daily/btc_puell_multiple.json |
| Dataset | File |
|---|---|
| BTC Funding Rates | data/daily/btc_funding_rates.json |
| BTC Open Interest | data/daily/btc_open_interest.json |
| BTC Taker Buy Sell Ratio | data/daily/btc_taker_buy_sell_ratio.json |
| BTC Long Liquidations | data/daily/btc_long_liquidations.json |
| BTC Long Liquidations USD | data/daily/btc_long_liquidations_usd.json |
| BTC Short Liquidations | data/daily/btc_short_liquidations.json |
| BTC Short Liquidations USD | data/daily/btc_short_liquidations_usd.json |
| Dataset | File |
|---|---|
| BTC MVRV Ratio | data/daily/btc_mvrv_ratio.json |
| Dataset | File |
|---|---|
| BTC Exchange Supply Ratio | data/daily/btc_exchange_supply_ratio.json |
| BTC Fund Flow Ratio | data/daily/btc_fund_flow_ratio.json |
| Stablecoin Exchange Supply Ratio | data/daily/stablecoin_exchange_supply_ratio.json |
| Dataset | File |
|---|---|
| BTC Coinbase Premium Index | data/daily/btc_coinbase_premium_index.json |
| BTC Coinbase Premium Gap | data/daily/btc_coinbase_premium_gap.json |
| BTC Korea Premium Index | data/daily/btc_korea_premium_index.json |
Each JSON file contains:
{
"name": "Metric Name",
"description": "What this metric measures and why it matters",
"data_type": "Decimal (BTC/USD/%)",
"update_frequency": "Daily/Hourly/Real-time",
"category": "Category Name",
"trading_signal": "How to interpret for trading decisions",
"granularity": "daily/hourly/minute",
"first_data_date": 1231006505000,
"last_data_date": 1733184000000,
"last_added_date": 1733184000,
"last_modified_date": 1733184000,
"data": [
{"timestamp": 1609459200000, "value": 123.45, "last_modified": 1733184000},
{"timestamp": 1609545600000, "value": 234.56, "last_modified": 1733184000}
],
"updated_at": 1733184000
}| Field | Description |
|---|---|
name |
Human-readable metric name |
description |
Detailed explanation of what the metric measures |
data_type |
Unit of measurement (BTC, USD, %, ratio) |
update_frequency |
How often the source data updates |
category |
Metric category for grouping |
trading_signal |
Interpretation guide for trading decisions |
granularity |
Time granularity: daily, hourly, or minute |
first_data_date |
Unix timestamp in milliseconds (UTC) of earliest data point |
last_data_date |
Unix timestamp in milliseconds (UTC) of latest data point |
last_added_date |
Unix timestamp in milliseconds (UTC) when new data was last added |
last_modified_date |
Unix timestamp in milliseconds (UTC) when any value was last modified |
data |
Array of data points with timestamp, value, and last_modified (all timestamps in ms UTC) |
updated_at |
Unix timestamp in milliseconds (UTC) when this file was last updated |
This data is structured for easy consumption by ML models:
- Time Series: Each dataset is sorted by timestamp ascending
- Consistent Format: All datasets follow the same JSON schema
- Rich Metadata: Description and trading signal fields provide context
- Granularity Support: Choose the appropriate time resolution for your model
- Change Tracking:
last_modifiedfields help identify data revisions
| What You Get | Commercial Alternative | Annual Savings |
|---|---|---|
| On-chain metrics | Premium API ($99+/mo) | $1,188+ |
| Derivatives data | Professional API ($199+/mo) | $2,388+ |
| Historical data | Enterprise API ($500+/mo) | $6,000+ |
| Total Potential Savings | $9,500+/year |
💡 Remember: If you find this valuable, star the repo and add attribution to your project!
No Warranty or Guarantee of Service
This data is provided "AS IS" without any warranty or guarantee of any kind.
- ❌ No guarantee of continued availability or updates
- ❌ No guarantee of data accuracy or completeness
- ❌ No guarantee of uptime or service continuity
- ❌ Not financial advice — for educational and research purposes only
This is a community-funded project. Without sufficient community support (stars, sponsorships, contributions), this free service may be discontinued at any time without notice. If you rely on this data, please consider supporting the project.
This project provides free access to expensive crypto market data. In return, proper attribution is required when using this data in any project, research, publication, or application.
If you use this data, you MUST include the following:
For README/Documentation:
## Data Source
Crypto market data provided by [Crypto Market Data](https://github.com/ErcinDedeoglu/crypto-market-data) by Ercin Dedeoglu.For Academic Papers/Research:
@misc{dedeoglu_crypto_market_data,
author = {Dedeoglu, Ercin},
title = {Crypto Market Data: On-chain and Derivatives Market Data},
year = {2025},
publisher = {GitHub},
url = {https://github.com/ErcinDedeoglu/crypto-market-data}
}For Applications/Websites:
Display a visible attribution link: Data: Ercin Dedeoglu - Crypto Market Data
| Cost | Commercial Providers | This Project |
|---|---|---|
| Monthly API Access | $500 - $2,000+ | FREE |
| Historical Data | $1,000 - $5,000+ | FREE |
| Real-time Updates | $200 - $500/month | FREE |
Collecting and serving this data is expensive. Your attribution helps:
- 🌟 Increase visibility so more developers can benefit
- 💪 Encourage contributions from the community
- 🚀 Attract sponsors to keep the project running
- 📈 Justify continued maintenance and new feature development
This data is provided under CC BY 4.0:
✅ You CAN:
- Use the data for personal projects
- Use the data for commercial applications
- Modify and adapt the data
- Redistribute the data (with attribution)
❌ You CANNOT:
- Use the data without proper attribution
- Remove or hide attribution from redistributed data
- Claim the data as your own original work
We welcome contributions! Here's how you can help:
- 🐛 Report bugs and data issues
- 💡 Suggest new metrics or data sources
- 📢 Share with your network
- ⭐ Star this repository
If this data saves you money, consider supporting the project:
- 🐛 Issues: GitHub Issues
- 🐦 Twitter/X: @ErcinDedeoglu
- 🔗 LinkedIn: Ercin Dedeoglu
If this project helps you, please ⭐ star this repository!
Made with ❤️ by Ercin Dedeoglu
