API Dokümantasyonu
Zaman Serisi Verileri ve Tarihsel Analiz Sorguları
Backtest, araştırma ve tarihsel analiz için kapsamlı zaman serisi verilerine erişin. OHLCV mumları, tarihsel finansman oranları, balina hareketleri zaman çizelgeleri ve birden fazla zaman aralığında toplanmış piyasa anlık görüntülerini sorgulayın.
21 Mart 2026'da yayınlandı
•
15 dakikalık okuma
•
Araştırma
Tarihsel Verilere Genel Bakış
Smart Money API, kapsamlı araştırma, backtest ve zaman temelli analiz için 24 aylık tarihsel veri sağlar. Tüm tarihsel veriler normalleştirilmiş, tekilleştirilmiş ve birden fazla toplama seviyesinde mevcuttur.
Mevcut tarihsel veriler şunları içerir:
- OHLCV Mumları — Tüm işlem gören çiftler için Açılış, Yüksek, Düşük, Kapanış, Hacim
- Balina Hareketleri — Günlük ve saatlik çözünürlükte tarihsel birikim/dağıtım
- Finansman Oranları — Tüm sürekli çiftler için tarihsel finansman oranı anlık görüntüleri
- Açık Pozisyon — Tüm borsalar ve zaman aralıkları için tarihsel açık pozisyon verileri
- Likidasyonlar — Tarihsel likidasyon kaskadları ve baskı noktaları
Veri Saklama: Tam tik verisi 90 gün boyunca saklanır. Toplanmış saatlik/günlük veriler 24 ay boyunca saklanır. Ham arşivler indirilebilir.
OHLCV Mum Grafik Verileri
Teknik analiz ve grafik çizimi için Açılış-Yüksek-Düşük-Kapanış-Hacim verileri. 1 dakikadan 1 aya kadar tüm zaman aralıklarında tüm kripto para çiftleri için mevcuttur.
OHLCV Veri Yapısı
{
"timestamp": 1709980800000,
"symbol": "BTCUSDT",
"timeframe": "1h",
"open": 71250.50,
"high": 72500.00,
"low": 71000.25,
"close": 72250.75,
"volume_base": 1234.5,
"volume_quote": 89234500,
"trades": 45678
}
OHLCV Verilerini Sorgula
// Son 30 gün için 1 saatlik mumları al
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1h&
lookback=30d&
limit=720
API anahtarınızı 30 saniyede alın
Hazır mısınız? Ücretsiz bir API anahtarı alın (günde 100 çağrı, kart gerekmez) ve canlı balina, finansman ve zincir üstü verilerini çekmeye başlayın.
API anahtarınızı alın →
Mevcut Zaman Aralıkları
Zaman Aralığı Seçenekleri
| Zaman Aralığı |
Süre |
Kullanım Durumu |
Maksimum Geriye Bakış |
| 1m |
1 dakika |
Yüksek frekanslı ticaret, scalping |
30 gün |
| 5m |
5 dakika |
Gün içi, swing ticareti |
90 gün |
| 15m |
15 dakika |
Günlük ticaret, sinyal tespiti |
180 gün |
| 1h |
1 saat |
Orta vadeli ticaret, analiz |
365 gün |
| 4h |
4 saat |
Swing ticareti, trend analizi |
24 ay |
| 1d |
1 gün |
Uzun vadeli pozisyon alma, araştırma |
24 ay |
| 1w |
1 hafta |
Makro analiz, çok yıllık trendler |
24 ay |
| 1M |
1 ay |
Stratejik pozisyon alma |
24 ay |
Zaman Aralığı Kombinasyonları
Birden fazla zaman aralığını aynı anda sorgulayın:
GET /v1/historical/ohlcv/multi?
symbol=BTCUSDT&
timeframes=1h,4h,1d&
timestamp=1709980800000
// Her zaman aralığı için en son mumu döndürür
Tarihsel Sorgu Kalıpları
Zaman Temelli Sorgular
// Belirli bir zaman aralığını sorgula
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1h&
start_time=1709894400000&
end_time=1709980800000
// Veya göreceli geriye bakış kullan
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1d&
lookback=90d
Büyük Veri Kümeleri için Sayfalama
// İlk sayfa: 1000 mum
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1m&
limit=1000&
start_time=1709980800000
// İmleç kullanarak sonraki sayfa
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1m&
cursor=1709981000000&
limit=1000
Toplama Aralıkları
Sabit Zamanlı Toplama
Verileri sabit aralıklarla topla (saatlik, günlük, haftalık):
// 1 ay için günlük anlık görüntüler
GET /v1/historical/snapshots?
metrics=whale_net_flow,funding_rate,oi&
interval=1d&
lookback=30d
Özel Toplama
Özel zaman pencereleri üzerinde topla:
// 1 dakikalık mumları 15m'ye topla
GET /v1/historical/ohlcv/resample?
symbol=BTCUSDT&
source_timeframe=1m&
target_timeframe=15m&
lookback=7d
Balina Hareketi Geçmişi
Tarihsel Balina Takibi
// Tarihsel balina birikim desenleri
GET /v1/historical/whales?
asset=BTC&
metric=net_accumulation&
interval=1d&
lookback=365d
// Fiyat seviyeleri etrafındaki tarihsel hareket
GET /v1/historical/whales/price-correlation?
asset=ETH&
lookback=90d
Balina Veri Yapısı
{
"timestamp": 1709980800000,
"asset": "BTC",
"metric": "net_accumulation",
"value": 50000,
"whale_count": 847,
"exchange_inflow": -12000,
"exchange_outflow": 62000
}
Fonlama Oranı Geçmişi
Tarihsel Fonlama Oranı Anlık Görüntüleri
// Saatlik fonlama oranı anlık görüntülerini al
GET /v1/historical/derivatives/funding-heatmap?
symbol=BTCUSDT&
exchange=binance&
interval=1h&
lookback=30d
// Borsalar arasında tarihsel oranları karşılaştır
GET /v1/historical/derivatives/funding-heatmap/comparative?
symbol=ETHUSDT&
exchanges=bybit,binance,hyperliquid&
interval=4h&
lookback=90d
Fonlama Oranı İstatistikleri
Toplanmış fonlama oranı istatistiklerini sorgula:
GET /v1/historical/derivatives/funding-stats?
symbol=BTCUSDT&
lookback=365d&
metrics=mean,median,std_dev,min,max
// Yanıt şunları içerir:
// - Yıllık ortalama fonlama oranı
// - Dağılım (std dev)
// - Tarihsel uç noktalar
// - Yüzdelik sıralamalar
Backtest Veri Erişimi
Backtest Sorgu Formatı
Backtrader, VectorBT ve özel motorlar gibi backtest çerçeveleri için optimize edilmiştir:
// 1 yıllık backtest için tüm verileri al
GET /v1/backtest/data?
symbols=BTCUSDT,ETHUSDT&
timeframe=1h&
start=2024-01-01&
end=2025-01-01&
fields=ohlcv,funding_rate,oi,whale_flow
Dışa Aktarma Formatları
Çevrimdışı analiz için tarihsel verileri indir:
- CSV — Elektronik tablolar için standart sütunlu format
- JSON — Tüm meta verilerle yapılandırılmış format
- Parquet — Veri bilimi için sıkıştırılmış sütunlu format
- HDF5 — Zaman serileri için optimize edilmiş format
// CSV olarak dışa aktar
GET /v1/backtest/export?
symbols=BTCUSDT&
timeframe=1d&
lookback=365d&
format=csv
Pratik Örnekler
Örnek 1: 2024 Boğa Piyasasını Araştır
// Balina hareketini fiyat hareketiyle ilişkilendir
GET /v1/historical/correlated-data?
asset=BTC&
start_time=2024-01-01&
end_time=2024-12-31&
include=ohlcv,whale_accumulation,funding_rates&
interval=1d
Örnek 2: Finansman Oranı Stratejisi Geri Testi
// Finansman oranı ortalama geri dönüş stratejisi için veri alın
GET /v1/backtest/data?
symbols=BTCUSDT,ETHUSDT,BNBUSDT&
timeframe=4h&
start=2023-01-01&
end=2025-01-01&
exchange=binance&
fields=funding_rate,open_interest,liquidations
Tarihsel Veri En İyi Uygulamaları
1. Uygun Zaman Aralıklarını Seçin
Analiziniz için gereken en küçük zaman aralığını kullanın. 1 dakikalık veri, saatlik veriden daha pahalıdır.
2. Zaman Aralıklarını Belirtin
Her zaman start_time/end_time veya lookback parametrelerini kullanın. Sınırsız sorgular verimsizdir.
3. Tarihsel Sorguları Önbelleğe Alın
Tarihsel veri değişmez. Agresif önbellekleme yapın (aylık veri için 30 günlük TTL).
4. Büyük Sonuçlar için Sayfalama Kullanın
1 yıllık 1 dakikalık veri = 525,600 mum. Büyük veri setleri için sayfalama ve akış kullanın.
5. Veri Tamlığını Doğrulayın
Analizde kullanmadan önce cevap meta verilerinde boşluk veya eksik borsaları kontrol edin.
Araştırma için Tarihsel Veriye Erişin
24 aylık OHLCV, balina hareketleri ve finansman oranı verisi. Geri test, araştırma ve strateji geliştirme için ideal.
Planları Görüntüle
Ücretsiz katman: 30 günlük geçmiş. Pro: 24 ay. Enterprise: Tam arşiv erişimi.