Smart Money API
Türev verilerini, zincir üstü metrikleri ve balina cüzdan aktivitelerini tek bir güven skorunda birleştiren profesyonel seviyede bir istihbarat API'si. Bu skor, trading bot'unuz için kullanılabilir.
https://api.smartmoneyapi.com/v1Tasarım Prensipleri
Bu API'nin her endpoint'ini ve döndürdüğü her skoru şekillendiren dört fikir. Aynı zamanda, ne vaat ettiğinin ve etmediğinin dürüst sınırlarıdır.
Önce strateji, sinyal değil. Bu bir al/sat sinyal akışı değildir. Stratejinizi ve giriş noktanızı siz belirlersiniz; API, çevredeki piyasa yapısının — türev pozisyonları, fonlama, açık pozisyon, likidasyonlar, zincir üstü akış ve balina konsensüsü — zaten almak istediğiniz trade ile uyumlu olup olmadığını söyler.
Güven skorlu, ikili tahmin değil. Her cevap derecelendirilmiş bir confidence (YÜKSEK / ORTA / DÜŞÜK) ve composite -1.0 ile +1.0 arasında bir skor taşır. Garanti yoktur ve oracle çağrıları yoktur — orantılı bir şekilde hareket edebilmeniz için, arkasındaki nedenlerle birlikte kalibre edilmiş bir uyum okuması alırsınız.
Karar desteği, yürütme tavsiyesi değil. API, mantığınızın üzerinde hareket edebilmesi için bir ONAYLA / AZALT / ATLA önerisi ve bir boyut çarpanı döndürür. senin hiçbir zaman emir vermez ve buradaki hiçbir şey finansal tavsiye değildir. Risk, boyutlandırma ve yürütme sorumluluğu size aittir.
Canlı metrikler, sabit garantiler değil. Kazanma oranları, rejim istatistikleri ve doğruluk rakamları, hareketli bir örneklemden hesaplanır ve piyasalar hareket ettikçe değişir. Bunları dürüstçe yayınlıyoruz, vasat olduklarında bile. Her metriği geleceğe dair bir vaat değil, mevcut bir gözlem olarak değerlendirin.
Bu API Kimin İçin
Bu API, kripto bot, algo ve yapay zeka ajanı geliştiricileri için oluşturulmuştur — zaten bir uzun/kısa sinyali olan (TA stratejisinden, bir ML modelinden, Freqtrade pipeline'ından, TradingView uyarısından veya bir LLM ajanından) ve sermaye ayırmadan önce hızlı bir ön-trade ONAYLA / AZALT / ATLA kararı almak isteyenler için.
Tipik bir döngü: stratejiniz "BTC'de uzun pozisyon aç" → siz GET /v1/confirm?symbol=BTC&direction=long → girişi onaylar, azaltır veya atlar ve boyutu size_multile ölçeklendirirsiniz. Tek çağrı, tek düşük gecikmeli JSON yanıtı, ekstra altyapı yok.
Bu değil bağımsız bir sinyal üreticisi, bir grafik ürünü veya bir yürütme platformu. Eğer kendi sinyaliniz yoksa, canlı bir bota bağlamadan önce performans sayfasına bakarak skorun nasıl davrandığını görebilirsiniz.
Erişim Sağlama
1 — Kaydolun. ücretsiz bir hesap oluşturun signup (e-posta/şifre veya Google). Ücretsiz tier için kredi kartı gerekmez.
2 — Kontrol panelinizi açın. Senin kontrol panelin API anahtarınızı, mevcut planınızı ve günlük kotanıza karşı canlı kullanımınızı gösterir.
3 — API anahtarınızı kopyalayın. Anahtarlar önek alır sm_. Her istekte X-API-Key başlığı olarak geçirin (bkz. Kimlik Doğrulama). Yükseltme işlemini istediğiniz zaman fiyatlandırma sayfası limitleri artırmak ve daha fazla sembol ve endpointin kilidini açmak için.
Spec, SDK & Cookbook
Kodu kendiniz yazın veya bir kodlama ajanına verin, hızlı bir şekilde entegre olmak için ihtiyacınız olan her şey.
| Kaynak | Ne olduğu |
|---|---|
| Cookbook | En yaygın entegrasyonlar için kopyala-yapıştır tarifleri — giriş yapmadan önce onaylayın, bir Freqtrade sinyalini kontrol edin, çarpanla boyutlandırın, 402/429'u yönetin ve bir kodlama ajanına bağlayın. |
| OpenAPI spec | Her endpointin makine tarafından okunabilir OpenAPI tanımı. Postman/Insomnia'ya aktarın, istemci oluşturun veya bir LLM'e besleyin. github.com/tashiardit/smartmoneyapi-docs. |
| Python client | Resmi Python istemci kütüphanesi github.com/tashiardit/smartmoneyapi-python. |
| /llms.txt | API'nin LLM-dostu düz metin özeti. Claude, Codex veya Cursor'ı buna yönlendirin (bkz. Kodlama Ajanları). |
2 dakikada hızlı başlangıç
Adım 1 — Base URL. Her endpoint şu adresin altında yer alır:
Adım 2 — API anahtarınızı alın. Ücretsiz kaydolun (kredi kartı gerekmez) ve anahtarınızı dashboarddan kopyalayın. Her istekte X-API-Key başlığı olarak iletin.
Adım 3 — İlk çağrınız. Bunu terminalinize yapıştırın ve sm_your_key dashboard'dan aldığınız anahtarla değiştirin:
Beklenen yanıt:
"ts": 1710940821,
"symbol": "BTC",
"direction": "long",
"composite": 0.74,
"confidence": "HIGH",
"action": "CONFIRM",
"size_mult": 1.5,
"deriv_score": 0.81,
"onchain_score": 0.68,
"whale_score": 0.73,
"reasons": ["Funding rate positive across all venues", "Whales: 67% long consensus"]
}
Ne zaman confidence ise HIGH veya MEDIUM ve action ise CONFIRM, pozisyon büyüklüğünüzü şu kadar ölçeklendirin: size_mult. İşte tüm entegrasyon döngüsü bu. Detaylar için Yanıt Alanları tüm alan referansına bakın.
Kimlik Doğrulama
Tüm istekler, bir API anahtarı gerektirir. Bu anahtar X-API-Key HTTP başlığı olarak iletilmelidir.
API anahtarınızı kontrol panelinden alabilirsiniz (kayıt olduktan sonra). Anahtarınızı gizli tutun — istemci tarafı kodunda veya herkese açık depolarında paylaşmayın.
/v1/ws/ticket başlığı ile birlikte X-API-Key adresine POST edin, ardından dönen biletle bağlantı kurun. Detaylar için WebSocket kimlik doğrulama (biletler).Google ile Giriş (Firebase Auth)
Kullanıcılar, Firebase Authentication üzerinden Google hesaplarıyla kimlik doğrulayabilir. İstemcide başarılı bir Google girişi sonrasında, Firebase ID token'ını bir bağlantılı API oturumu için takas edin. Sistem, Google kimliğinizi otomatik olarak API anahtarı sistemiyle senkronize eder.
İstek Gövdesi
| Alan | Tür | Açıklama |
|---|---|---|
| id_tokenzorunlu | string | İstemcide Google girişi sonrası alınan Firebase ID token'ı |
Örnek Yanıt
"api_key": "sm_your_linked_key",
"uid": "firebase_uid_abc123",
"email": "[email protected]",
"plan": "trader",
"synced": true
}
Oran Sınırları
| Plan | Çağrı/Gün | Anlık Limit | Veri Gecikmesi |
|---|---|---|---|
| Ücretsiz | 50 | 2/dak | 60 saniye |
| Trader | 1,000 | 20/dak | Gerçek zamanlı |
| Pro | 5,000 | 60/dakika | Gerçek zamanlı |
| Kurumsal | 100,000 | 400/dakika | Gerçek zamanlı |
Hız sınırı başlıkları her yanıta dahildir: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Temel URL
Aşağıdaki tüm endpoint'ler bu temel URL'e göredir. Tüm yanıtlar JSON formatındadır. Content-Type: application/json.
Hatalar
Hatalar standart HTTP durum kodlarını ve tutarlı bir JSON gövdesini kullanır. Her zaman durum koduna göre dallanın, yanıt metnine göre değil. En sık karşılaşacağınız üçü:
| Durum | Kod | Anlamı ve yapılacaklar |
|---|---|---|
| 401 | yetkisiz | Eksik veya geçersiz API anahtarı. Kontrol edin X-API-Key başlık mevcut ve doğru. |
| 402 | ödeme_gerekli | Endpoint veya sembol, anahtarınızın sahip olduğu plandan daha yüksek bir plan gerektiriyor (örneğin, ücretsiz bir anahtar WebSocket firehose'u çağırıyor). Yükselt veya genel bir endpoint'e geri dönün. |
| 429 | hız_sınırı_aşıldı | Günlük veya ani limit aşıldı. Geri çekilin ve sonra yeniden deneyin X-RateLimit-Reset; tekrar tekrar denemeyin. |
Her hata aynı şekli döndürür:
"error": "rate_limit_exceeded",
"message": "Günlük 100 çağrı limitine ulaşıldı. 00:00 UTC'de sıfırlanır.",
"status": 429
}
Tüm durum kodlarının tam listesi için (400 / 403 / 500 / 503 ve daha fazlası), bkz. Hata Kodları. Sağlam bir entegrasyon, 5xx ve 429'u geçici (geri çekilerek yeniden deneyin) ve 401/402/403'ü terminal (anahtarı veya planı düzeltin) olarak ele alır.
Güvenlik en iyi uygulamaları
Anahtarı URL'de değil, başlıkta gönderin. Her zaman geçirin X-API-Key bir HTTP başlığı olarak. Sorgu dizelerindeki anahtarlar (?key=) proxy'ler, yük dengeleyiciler ve tarayıcı geçmişi tarafından kaydedilir — eski ?key= kimlik doğrulaması tam da bu nedenle WebSocket endpoint'lerinde artık kabul edilmiyor.
Anahtarları sunucu tarafında tutun. Bir API anahtarını istemci tarafı JavaScript'e, bir mobil uygulama paketine veya genel bir depoya gömeyin. Bir ortam değişkeninden veya gizli yöneticiden yükleyin. Bir anahtar sızarsa, değiştirin.
Anahtarları periyodik olarak değiştirin. Anahtarınızı yeniden oluşturun kontrol paneli bir program dahilinde ve maruz kalındığında hemen. Eski anahtar, yeni bir anahtar verildiği anda çalışmayı durdurur.
Tarayıcı soketleri için biletleri kullanın. Tarayıcıdan gerçek zamanlı akışlar için, ham anahtarla bağlanmak yerine anahtarınızı tek kullanımlık bir biletle değiştirin — bkz. WebSocket kimlik doğrulaması (biletler).
Kodlama ajanları / LLM'ler ile kullanma
Claude Code, Codex, Cursor veya herhangi bir LLM kodlama ajanı ile mi geliştiriyorsunuz? Ajanın bu API'yi doğru bir şekilde bağlaması için gereken her şeyi tek seferde verebilirsiniz. İki makine tarafından okunabilir referans yayınlandı:
| Kaynak | URL |
|---|---|
| LLM özeti | https://smartmoneyapi.com/llms.txt |
| OpenAPI spesifikasyonu | github.com/tashiardit/smartmoneyapi-docs |
Ajanınızı işaret edin /llms.txt dosyasına ( llms.txt kuralı) kısa bir genel bakış için, ardından tam istek/yanıt şekilleri için OpenAPI spesifikasyonuna. İyi çalışan tek satırlık bir istem:
https://smartmoneyapi.com/llms.txt adresini ve github.com/tashiardit/smartmoneyapi-docs'daki OpenAPI spesifikasyonunu okuyun, ardından bir ön işlem
github.com/tashiardit/smartmoneyapi-docs adresindeki OpenAPI spesifikasyonunu okuyun, ardından bir ön işlem ekleyin
GET /v1/confirm çağrısı yapan ve girişleri atlayan botumu kontrol et
aksiyon CONFIRM olmadığı sürece
Görüntüle Yemek Kitabı Uygulamalı bir kodlama ajanı tarifi için.
Uç Noktalar
GET /confirm
Ana uç nokta. Belirli bir işlem yönü için bileşik bir güven skoru ve eylem önerisi döndürür. Herhangi bir pozisyona girmeden önce bunu çağırın.
Basit bir ifadeyle kapsam. /confirm şu anda puan veriyor BTC, ETH ve SOL — dürüstlüğü doğrulamak için yeterli geçmiş verisi olan semboller. Türev tarayıcı ayrıca ~519 türev piyasasını izler fonlama, açık pozisyon ve likidasyon verileri için; balina takibi ise 600+ cüzdanı kapsar. Pro, tam tarayıcı, dışa aktarma ve daha geniş piyasa kapsamının kilidini açar; /confirm her piyasa güvenilir bir geçmiş biriktirdikçe sembol desteği genişletilir.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| sembolzorunlu | string | Varlık sembolü. Şunlardan biri: BTC, ETH, SOL (Trader+) |
| yöngerekli | string | İşlem yönü: long veya short |
| kaynakisteğe bağlı | string | Sinyal kaynağınız için etiket (analiz için kaydedilir). Maks. 32 karakter. |
Örnek İstek
"https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"
Örnek Yanıt
"ts": 1710940821,
"symbol": "BTC",
"direction": "long",
"composite": 0.74,
"confidence": "HIGH",
"action": "CONFIRM_FULL",
"size_mult": 1.5,
deriv_score: 0.81,
onchain_score: 0.68,
balina_score: 0.73,
x_score: 0.0,
faktörler: {
türevler: { skor: 0.81, ağırlık: 0.40, ağırlıklı: 0.324 },
on-chain: { skor: 0.68, ağırlık: 0.35, ağırlıklı: 0.238, kaynak: coinmetrics, mevcut: True },
balina: { skor: 0.73, ağırlık: 0.25, bayatlama_faktörü: 1.0, ağırlıklı: 0.183 }
},
ayarlamalar: { mutabakat: 0.0, trend: 0.0, haber_makro: 0.0 },
ağırlıklar: { türevler: 0.40, on-chain: 0.35, balina_istihbaratı: 0.25 },
kapsam: { türevler: True, balina: True, on-chain: True },
nedenler: [
Tüm platformlarda fonlama oranı pozitif,
LSR uzunları destekliyor: 1.42,
Balinalar: %67 uzun konsensüs,
MVRV 1.0 üzerinde — on-chain boğa sinyali
]
}
Şeffaf tasarım. Her yanıt, her bileşenin factors nesnesini içerir; burada skor × ağırlık = ağırlıklı katkı, bir adjustments nesne (sonradan filtre ayarları için), weights kullanılan coverage harita. On-chain bileşeni, Glassnode anahtarı ayarlanmadığında gerçek ücretsiz Coin Metrics verilerini kullanır (MVRV / borsa-akışı / aktif-adres). Bu çok faktörlü bir birleşim skorudur — karar destek aracı, garantili bir kazanma oranı değil..
Takip edilmeyen semboller şeffaftır. Takip edilen türev/balina evreni dışındaki bir sembol, açık bir "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" döndürür "unsupported":true — asla uydurulmuş bir LOW.
Yanıt Alanları
| Alan | Tür | Açıklama |
|---|---|---|
| ts | integer | Hesaplamanın Unix zaman damgası |
| symbol | string | Varlık sembolü (BTC/ETH/SOL) |
| direction | string | Talep edilen yön (long/short) |
| composite | float | -1.0 (aşırı karşıt) ile +1.0 (güçlü onay) arası bileşik birleşim puanı. Kazanma oranı değildir. |
| base_composite | float | Son filtre ayarları uygulanmadan önceki bileşik puan |
| confidence | string | HIGH / MEDIUM / LOW / VETO / NO_DATA |
| action | string | CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP |
| size_mult | float | Önerilen pozisyon büyüklük çarpanı (örn. 0.0 – 1.5) |
| unsupported | bool | true sembol kapsam dışındayken (NO_DATA ile birlikte) |
| deriv_score | float | Türev alt puanı (-1 ile 1 arası) |
| onchain_score | float | On-chain alt puanı (-1 ile 1 arası) |
| whale_score | float | Balina konsensüs alt puanı (-1 ile 1 arası) |
| x_score | float | X/sosyal-duyarlılık alt puanı (-1 ile 1 arası); kullanılmadığında 0 |
| factors | object | Bacak bazında ayrıntılar: score × weight = weighted türevler / onchain / balina / x_sentiment için (onchain ayarlamaları içerir source) |
| adjustments | object | İşaretli son filtre ayarları (anlaşma, eğilim, rsi_1h, news_macro, momentum, time_of_day, streak_decay) |
| weights | object | Bu değerlendirme için gerçekte kullanılan ağırlık seti |
| coverage | object | {derivatives, whale, onchain} hangi bacaklarda gerçek veri vardı |
| reasons | array | Puan için insan tarafından okunabilir açıklama dizileri |
GET /snapshot
Belirli bir sembol için tüm alt puanları, ham metrikleri ve gösterge değerlerini içeren tam bir piyasa anlık görüntüsü döndürür. Panolar ve günlük kaydı için kullanışlıdır.
GET /onchain
Ham zincir metriklerini döndürür: MVRV, SOPR, borsa net akışı, realize edilmiş piyasa değeri oranı ve döngü pozisyon sınıflandırması.
GET /v1/derivatives/*
500+ sembol üzerinde çapraz borsa türev tarayıcısı: fonlama oranı ısı haritası, açık pozisyon sıralamaları ve uzun/kısa oranı sinyal tespiti. İlk 10 satır herkese açık; tam tarayıcı için Trader veya Pro gereklidir. Uç noktalar: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.
GET /v1/options/*
Deribit kaynaklı BTC & ETH opsiyon analizleri (herkese açık, kimlik doğrulama gerekmez): put/call oranı, maksimum acı ve strike'a göre açık pozisyon. Uç noktalar: /v1/options/summary, /v1/options/pcr, /v1/options/oi.
GET /v1/etf/*
Spot BTC & ETH ETF günlük net akışları ve fon bazında detaylar (herkese açık). Uç noktalar: /v1/etf/flows, /v1/etf/funds.
GET /v1/historical/*
Backtest için tarihsel fonlama, açık pozisyon, uzun/kısa oranı (Binance) ve OHLCV (CoinGecko). Uç noktalar: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.
GET /v1/dex/*
DexScreener destekli trend çiftleri, token arama ve çift detayları (herkese açık, kimlik doğrulama gerekmez). Uç noktalar: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.
GET /v1/news/*
Haber istihbaratı: politika/jeopolitik/kripto haberleri etki kategorilerine ayrılmıştır, artı Korku & Açgözlülük (herkese açık, kimlik doğrulama gerekmez). Uç noktalar: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.
GET /whales
Balina cüzdan konsensüs verilerini döndürür: uzun/kısa dağılım, toplam nominal maruz kalma, ilk 10 pozisyon (yalnızca Pro) ve cüzdan sayısı.
GET /signals
İzlenen tüm varlıklar arasında en son YÜKSEK/ORTA sinyallerin bir akışını döndürür. Fırsat tarama için kullanışlıdır.
GET /v1/strategies/*
Smart Money sinyalleri üzerinde çalışan otomatik ticaret stratejileri için şeffaf, salt okunur performans kaydı — dahil olmak üzere deriv40 SmartMoney Copytrade stratejisi (account=9). Tüm uç noktalar bir ?account=<id> sorgu parametresi alır ve JSON döndürür. Kimlik doğrulama gerekmez (herkese açık performans kaydı).
Uç Noktalar
GET /v1/strategies/stats?account=9— başlık metrikleri:total_trades,win_rate,profit_factor,total_pnl_usdt,account_growth_percent,initial_equity,current_equity,max_drawdown_portfolio,max_drawdown_trade.GET /v1/strategies/equity?account=9— grafik için eğri eğrisi:{ initial_equity, curve: [{ time, equity }] }.GET /v1/strategies/trades?account=9&limit=500— kapatılan işlem defteri: dizisi (veya{trades:[…]})symbol,direction,entry_price,exit_price,pnl_usdt,pnl_percent,pnl_percent_net.GET /v1/strategies/active?account=9— şu anda açık pozisyonlar: dizisi (veya{positions:[…]})symbol,side/direction,entry_price,unrealized_pnl.GET /v1/strategies/signals— stratejilere beslenen sinyal tipi dağılımı (sinyal tipi başına sayı / kazançlar / kazanma oranı / ortalama kâr).
Geçmiş performans gelecekteki sonuçların göstergesi değildir. Rakamlar tek bir ~3 aylık rejim üzerinden geri doldurulmuş ve canlı işlemlerle birlikte gösterilmiştir, ücretler öncesi olarak belirtilmiştir.
GET /export
Backtest için tarihsel sinyal verilerini CSV olarak indirin. Parametreler: symbol, from (unix ts), to (unix ts).
GET /health
Sistem sağlık kontrolü. Her kaynak için veri tazeliğini ve genel API durumunu döndürür. Kimlik doğrulama gerekmez.
"status": "ok",
"uptime_s": 1209600,
"sources": {
"bybit": { "lag_s": 42, "ok": true },
"binance": { "lag_s": 38, "ok": true },
"hyperliquid": { "lag_s": 61, "ok": true },
"onchain": { "lag_s": 290, "ok": true }
}
}
GET /usage
Mevcut API kullanım istatistiklerinizi döndürür: bugünkü çağrılar, aylık toplamlar, kota limitleri ve sıfırlama zamanları.
POST /webhooks
İzlenen varlıklarınızda bir sinyal tetiklendiğinde gerçek zamanlı imzalı etkinlik itmeleri almak için bir HTTPS URL'si kaydedin. Teslimatlar bir X-SmartMoney-Event başlığı ve bir HMAC-SHA256 imzası taşır X-SmartMoney-Signature, ve 3 kez geri çekilme ile yeniden dener.
İstek Gövdesi
| Alan | Tür | Açıklama |
|---|---|---|
| urlgerekli | string | Olayları POST etmek için HTTPS uç noktası (şununla başlamalıdır https://) |
| eventsgerekli | array | Olay adları, örneğin ["HIGH","MEDIUM","VETO"] veya ["*"] |
| symbolsgerekli | array | Filtrelemek için semboller, örneğin ["BTC","ETH"] veya ["*"] |
| secretgerekli | string | İmza sırrınız, ≥ 16 karakter (hashlenmiş olarak saklanır) |
İmzayı doğrulama
HMAC anahtarı, kayıtlı sırrınızın SHA-256 hex özetidir. Ham istek gövdesinin HMAC-SHA256'sını bu anahtarla hesaplayın ve (sabit zamanlı) karşılaştırın X-SmartMoney-SignatureGörüntüle Webhook Uygulama Kılavuzu.
İstihbarat
GET /analysis
AI destekli piyasa rejimi sınıflandırmasını sinyal çatışma tespiti ile döndürür. Çapraz sinyal uyumunu analiz eder, türevler, on-chain ve balina verileri arasındaki farklılıkları belirler ve ileriye dönük risk faktörleri ile zaman aralıklı bir öneri içeren doğal dilde bir özet üretir.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| sembolzorunlu | string | Varlık sembolü: BTC, ETH, veya SOL |
Örnek Yanıt
"ts": 1710940821,
"symbol": "BTC",
"regime": "late_cycle_divergence",
"regime_label": "Geç Döngü — Sinyal Farklılığı",
"summary": "BTC, on-chain gücün türevlerdeki aşırı uzamayla çeliştiği geç boğa döngüsü evresinde. Balinalar pozisyonlarını azaltırken perakende LSR yükseliyor.",
"signal_conflicts": [
"Balina skoru düşüş yönlü iken onchain skoru yükseliş yönlü",
"Finansman oranı 3 aylık zirvede — potansiyel sıkıştırma riski"
],
"risk_factors": ["Yüksek finansman", "OI farklılığı", "Balina azalması"],
"recommendation": "Uzun pozisyonları azaltın, stopları sıkın. Mevcut fiyatın üzerinde yeni uzun pozisyonlardan kaçının.",
"time_horizon": "4h–12h"
}
GET /liquidations
Döndürür iki tamamlayıcı görünüm: (1) kaldıraç-projeksiyonlu levels — bir tahmin nerede likidasyon kümeleri oturur; ve (2) bir realized_heatmap — GERÇEKLEŞEN zorunlu likidasyon yoğunluğu (fiyat × zaman), halka açık borsa WebSocket beslemelerinden canlı olarak toplanır: Binance, OKX, Bybit, Bitget, BitMEX. Isı haritası, sembol için veri akışı olduğunda mevcuttur (çok sakin bir piyasada veya yeni başlatıldığında yoktur).
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| sembolisteğe bağlı | string | Varlık sembolü (varsayılan BTC). Gerçek ısı haritası aktif olarak işlem gören perp sembollerini kapsar. |
Örnek Yanıt
"symbol": "BTC",
"cascade_risk": "YÜKSEK",
"nearest_long_liq_pct": -3.2,
"nearest_short_liq_pct": 4.1,
// GERÇEKLEŞEN likidasyonlar — 5 borsadan canlı
"realized_heatmap": {
"window_minutes": 240, "price_min": 91000.0, "price_max": 99000.0,
"clusters": [ { "price": 93250.0, "notional": 4820000.0, "count": 37, "dominant_side": "long" } ],
"by_side": { "long": 6100000.0, "short": 2400000.0 },
"totals": { "total_notional": 8500000.0, "count": 214 },
"exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 }
}
}
cascade_risk, en yakın mesafeler ve gerçekleşen toplamlar/taraf. Pro planı: tam projeksiyon levels artı tam realized_heatmap (matrisler, fiyat başına kümeler, borsa başına sayılar). Projeksiyon tahmini "stoplar nerede" sorusunu yanıtlar; gerçekleşen ısı haritası "gerçekte ne likide edildi"yi gösterir.GET /liquidations/heatmap
Herkese açık fiyat seviyesi likidasyon ısı haritası. Coinglass tarzı bir fiyat × zaman matrisi döndürür GERÇEKLEŞEN zorunlu likidasyonlar, her likidasyonun gerçekleştiği fiyata göre gruplanır — halka açık borsa WebSocket beslemelerinden canlı olarak toplanır: Binance, OKX, Bybit, Bitget, BitMEX. clusters dizi pratik çıktıdır: likide edilen nominal değere göre sıralanmış fiyat grupları, her biri baskın tarafıyla etiketlenmiştir. Veriler canlı akışa bağlıdır — çok sessiz bir sembol veya yeni yeniden başlatılmış bir ağ geçidi, iyi biçimlendirilmiş boş yapıyı ve dürüst bir notedöndürür. Gösterilen seviyeler her zaman gerçek likidasyonlardır, tahminler değil.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| symboloptional | string | Varlık sembolü (varsayılan BTC). |
| window_minutesoptional | int | Dakika cinsinden geriye dönük pencere (varsayılan 240, 5–1440 arasında sınırlandırılmıştır). |
| price_bucketsoptional | int | Fiyat sepeti sayısı (varsayılan 50, 5–100 arasında sınırlandırılmıştır). |
Örnek Yanıt
"symbol": "BTC", "window_minutes": 240, "price_buckets": 50,
"price_min": 91000.0, "price_max": 99000.0, "price_bucket_size": 160.0,
"price_levels": [ 91080.0, 91240.0, … ], "time_buckets": [ … ],
"matrix": [ [ … ] ], "long_matrix": [ [ … ] ], "short_matrix": [ [ … ] ],
"clusters": [
{ "price": 93250.0, "notional": 4820000.0, "long_notional": 4100000.0,
"short_notional": 720000.0, "count": 37, "dominant_side": "long" }
],
"by_side": { "long": 6100000.0, "short": 2400000.0 },
"totals": { "long_liq_notional": 6100000.0, "short_liq_notional": 2400000.0, "total_notional": 8500000.0, "count": 214 },
"exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 },
"generated_at": 1710940200, "public": true
}
totals.count is 0, clusters boştur ve bir note alan nedenini açıklar. Bu, gerçekleşmiş likidasyonların bir kaydıdır — bir tahmin değil. Tahmini "stoplar nerede" tahmini için, kimlik doğrulamalı /liquidations endpoint'ini kullanın.GET /liquidations/onchain
Gerçekleşmiş on-chain DeFi borç likidasyonları kendi yerel BSC + Avalanche tam düğümlerimizden doğrudan yakalanmıştır — herhangi bir trading botundan bağımsızdır. BSC'de Venus/Cream ve Moolah'ı, Avalanche'da ise AAVE V3/V2, Benqi, BankerJoe, Granary ve Vinium'u kapsar. Pro seviyesi ayrıca at_risk pozisyonları döndürür (bot bağımlıdır, eksik olabilir).
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| chainoptional | string | bsc veya avax. Tüm zincirler için boş bırakın. |
| limitoptional | integer | Maksimum satır sayısı (varsayılan 100, maksimum 500). Yeniden eskiye doğru. |
Örnek Yanıt
"chain": "bsc", "count": 2,
"liquidations": [
{ "chain": "bsc", "protocol": "Venus", "borrower": "0x2be6…8dfa",
"debt_symbol": "DAI", "repay_usd": 426.15,
"collateral_symbol": "WBNB", "tx_hash": "0x718c…7c0e", "block": 89170816, "ts": 1710940200 }
],
"summary": {
"window_hours": 24, "enabled": true,
"by_protocol": { "bsc:Venus": { "count": 61, repay_usd_known: 148230.55 } },
nodes: { bsc: { reachable: True, head_block: 89173010, events_total: 61 } }
}
}
GET /smart-stop
Mevcut likidasyon ısı haritası, volatilite bantları ve piyasa yapısına dayalı olarak akıllı stop-loss seviyelerini hesaplar. Giriş fiyatınıza ve risk toleransınıza göre ayarlanmış kademeli stop önerileri ve kar alma önerileri sunar.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| symbolrequired | string | Varlık sembolü: BTC, ETH, veya SOL |
| directionrequired | string | Pozisyon yönü: long veya short |
| entry_priceoptional | float | Giriş fiyatınız. Atlanırsa mevcut piyasa fiyatı kullanılır. |
| risk_pctoptional | float | Hesabın % olarak maksimum kabul edilebilir riski. Varsayılan: 2.0 |
Örnek Yanıt
symbol: BTC,
direction: long,
entry_price: 96420,
stops: {
tight: { price: 95100, note: 1h yapısının altında. Scalp işlemler için en iyisi. },
recommended: { price: 93800, note: 94K$'daki büyük likidasyon kümesinin altında. Standart swing stop. },
wide: { price: 91200, note: 4h talep bölgesinin altında. Pozisyon ticareti stopu. }
},
avoid_zones: [
{ low: 94200, high: 94800, reason: Yoğun likidasyon kümesi — yüksek slippage riski }
],
take_profit_suggestions: [
{ tp1: 98500, tp2: 101000, tp3: 104200 }
]
}
recommended stop döndürür. Pro planı: Üç stop seviyesi, avoid_zones, ve tam kar alma önerileri.GET /funding-arb
Borsalar arası fonlama oranı arbitraj fırsatlarını gerçek zamanlı olarak tespit eder. Tahmini yıllık getiri, optimal borsa çifti ve spreadi yakalamak için gereken hedge eylemi ile sıralanmış fırsatları döndürür.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| min_spreadoptional | float | Dahil edilecek minimum fonlama oranı spreadi (ondalık olarak). Varsayılan: 0.01 |
| symboloptional | string | Belirli bir varlığa filtrele. Tüm desteklenen varlıkları taramak için boş bırakın. |
Örnek Yanıt
ts: 1710940821,
opportunities: [
{
symbol: BTC,
spread: 0.032,
apr: 84.2,
long_exchange: hyperliquid,
short_exchange: bybit,
action: HYPE'da Long / BYBIT'te Short,
estimated_profit_8h_usd: 26.4
}
]
}
Ücretsiz genel versiyon No auth
Anahtarsız bir genel endpoint, gömme veya hızlı kontroller için ideal olan, en iyi 10 fırsatı canlı borsalar arası tarayıcı ile döndürür. Varlık başına spread geçmişini ve ağır alanları atlar ve 120 saniyelik önbellekten sunulur. Tazelik penceresinde borsalar arası fonlama spreadi yoksa, asla uydurulmamış veri ile opportunities boş bir dizi ve note döndürür.
opportunities: [
{
sembol: OGN,
yüzde_spread: 0.297667,
yıllık_apr: 325.95,
uzun_vadeli_borsa: bybit,
kısa_vadeli_borsa: hyperliquid,
10k_başına_tahmini_kar: 29.77,
risk_notları: Düşük spread — arbitraj marjını tüketmemesi için ücretleri kontrol edin.
}
],
taranan_semboller: 222,
ts: 1783268753,
halka_açık: True,
sınırlı: True
}
GET /smart-money/flow
Kalite ağırlıklı balina yön endeksi sembol başına, puanlanmış -100 (balina paraları kısa eğilimli) ile +100 (uzun eğilimli). Binlerce takip edilen Hyperliquid balina cüzdanından oluşturulmuştur — her biri kendi geçmiş kazanma oranı ve PnL ile ağırlıklandırılmış ve yeniliğe göre azaltılmıştır. Bu bir pozisyon endeksidir, al/sat sinyali veya fiyat tahmini değildir. Az katkı sağlayan cüzdanlara sahip semboller thin olarak etiketlenir ve dürüstçe puanlanır. Canlı sayfa: smart-money-flow.html.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| sembolopsiyonel | string | Tek sembol (ör. BTC). Tüm takip edilen sembolleri |puan|'a göre sıralamak için boş bırakın. |
| window_hoursopsiyonel | int | Puanlama penceresi, sınırlı 1..168. Varsayılan 24. |
Örnek Yanıt
semboller: [
{
sembol: SPX,
puan: -90.93,
yön: güçlü_kısa,
n_cüzdan: 26,
uzun_usd: 184200.0, kısa_usd: 2410000.0,
kalite_ağırlıklı: True,
örnek_kalite: zengin,
en_iyi_katkı_sağlayanlar: [ { cüzdan: 0x31ca…974b, yön: kısa, değer_usd: 5338.25, ağırlık: 0.4948 } ]
}
],
window_hours: 24,
kalite_ağırlıklı: True,
ts: 1783270000,
not: Kalite ağırlıklı balina yön pozisyon endeksi (-100..+100). Fiyat tahmini veya al/sat sinyali değildir.
}
top_contributors. Cüzdan ağırlıkları [0.25,1.0]ile sınırlıdır; PnL, en son pozisyon anlık görüntülerinden elde edilen gerçekleşmemiş bir vekildir.GET /v1/whales/crowding
Birleşik balina pozisyonu & yoğunluk bağlamı sembol başına, birleştirilmiş Hyperliquid + GMX v2 + Jupiter Perps. Brüt/net notional, yön eğilimi, cüzdan & platform sayıları, pozisyon yoğunluğu (ilk-3 pay + HHI), ağırlıklı ortalama kaldıraç ve likidasyon-yakınlık_sepetleri (notional USD'nin tahmini likidasyon fiyatının %5 ve %10 içinde olan kısmı, uzun/kısa ayrılmış). Bu bir bağlamdır, yön sinyali değildir. Türetilemeyen alanlar null olarak işaretlenir ve — olarak gösterilir — örn. lev_wavg/crowding_index hiçbir pozisyon kaldıraç taşımadığında. Likidasyon mesafeleri izole marj tahminidir (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), değil borsa bildirilen likidasyon fiyatları.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| min_notionalopsiyonel | float | Dahil edilecek sembol için minimum birleşik brüt notional (USD). Varsayılan: 1000000. |
Örnek İstek
Örnek Yanıt
"ok": True, "ts": 1783423500, min_notional: 1000000, n_symbols: 92,
semboller: [
{
sembol: BTC,
brüt_usd: 2447900000.0, net_usd: -51000000.0, çarpıklık: -0.021,
n_balinalar: 414, n_platformlar: 3,
platformlar: {
hl: { brüt: 1900000000.0, net: -40000000.0, n_balinalar: 272 },
gmx: { brüt: 320000000.0, net: -6000000.0, n_balinalar: 59 },
jupiter: { brüt: 227900000.0, net: -5000000.0, n_balinalar: 83 }
},
conc_top3: 0.159, hhi: 0.011, lev_wavg: 19.1,
liq_within_5pct: { uzun: 621700000.0, kısa: 665600000.0 },
liq_within_10pct: { uzun: 840000000.0, kısa: 910000000.0 },
crowding_index: 0.003
}
],
uyarılar: [ Likitasyon mesafeleri izole marj tahminleridir, borsa tarafından bildirilmemiştir. ]
}
skew is net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1). Yalnızca gerçekte bulunan platformlar görünür venues. Kaldıraçsız pozisyonlar, varsayılmak yerine likitasyon gruplarından çıkarılır. Anonim arayanlar brüt değere göre ilk 10 sembolü alır ( gated: true); Trader+ tam listeyi alır.GET /v1/options/gex
Dealer gamma maruziyeti (GEX) analitikleri BTC & ETH, Deribit opsiyon zincirinden canlı hesaplanır (kimlik doğrulama yok). Her grev için net satıcı GEX'ini döndürür (SpotGamma satıcı-kısa kuralı), gamma dönüş seviyesi (toplam net GEX'in sıfırı geçtiği grev), IV vade yapısı (vadeye kalan güne göre ATM örtülü oynaklık) ve bir ön vade IV çarpıklığı (25Δ-proxy risk reversal). GEX rejimi positive (satıcılar uzun gamma → oynaklık bastırıcı) veya negative (oynaklık artırıcı). Tamamen bağımsız — her çağrıda yeniden hesaplanır, depolanmış DB bağımlılığı yoktur.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| sembolopsiyonel | string | BTC veya ETH sadece. Varsayılan: BTC. |
Örnek İstek
Örnek Yanıt
"sembol": "BTC", "mevcut": true, "spot": 63203.0,
"net_gex": 18240000.0, "rejim": "pozitif",
"gamma_flip": 64919.82, "gamma_flip_pct": 2.72,
"call_gex": 31200000.0, "put_gex": -12960000.0,
"by_strike": [
{ "strike": 60000, "net_gex": -2100000.0 },
{ "strike": 65000, "net_gex": 4800000.0 }
],
"term_structure": [
{ "vade": "8JUL26", "dte": 0.76, "atm_iv": 62.1 },
{ "vade": "27MAR26", "dte": 14.2, "atm_iv": 58.4 }
],
"çarpıklık": {
"vade": "8JUL26", "dte": 0.76,
"put_iv": 69.69, "atm_iv": 62.1, "call_iv": 55.34,
"risk_reversal": 14.35, "eğilim": "aşağı_yönlü_korku"
}
}
available: false boş panellerle döner — asla uydurma GEX dönmez. IV çarpıklığı, 25Δ için sabit ±10% grev vekili kullanır (gerçek 25-delta her grev için delta çözümü gerektirir); görüntüleme için yeterli, bir yaklaşım olarak belgelenmiştir.GET /v1/liquidations/simulate
Etkileşimli likidasyon kademesi stres testi. Varsayılan bir fiyat hareketi verildiğinde, likide edilecek kaldıraçlı pozisyonların tahmini, fiyat seviyesi / taraf / borsa tarafından zorlanan hacim ve bir kademe-derinlik okuması döndürülür. Aşağı yönlü bir hareket, likidasyon fiyatı hedefin üzerinde/üzerinde olan uzun pozisyonları likide eder; yukarı yönlü bir hareket, likidasyon fiyatı hedefin altında/altında olan kısa pozisyonları likide eder. İki bağımsız yöntem birleştirilir: takip edilen Hyperliquid balinalarının gerçek kaldıraç/girişinden kesin likidasyon fiyatları, artı borsa başına istatistiksel OI-band kümeleri (finansmandan çıkarılan kalabalık kaldıraç). Her şey açıkça etiketlenmiştir estimated: true — hesap başına marjı, çapraz vs izole, eklenen marjı veya ADL'yi bilemez.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| sembolisteğe bağlı | string | Varlık sembolü. Varsayılan: BTC. |
| move_pctisteğe bağlı | float | Varsayılan bir fiyat hareketi yüzde olarak (negatif = aşağı, pozitif = yukarı). Varsayılan: -5. |
Örnek İstek
Örnek Yanıt
"ok": true, "estimated": true, "symbol": "BTC",
"ref_price": 63000.0, "move_pct": -5.0, "target_price": 59850.0,
"triggered_notional_usd": 380000000.0,
"cascade_depth": 0.029, "cascade_bucket": "low",
"by_exchange": { "hyperliquid": 260000000.0, "binance": 80000000.0, "bybit": 40000000.0 },
"by_side": { "long": 380000000.0, "short": 0.0 },
"clusters": [
{ "price": 60100.0, "side": "long", "notional_usd": 42000000.0, "whale_usd": 18000000.0, "oi_usd": 24000000.0 }
],
"whale_positions_used": 272, "exchanges": 3,
"realized_context": { "available": true, "coverage_hours": 17.8, "by_side_24h": { "long": 6100000.0, "short": 2400000.0 } },
"methodology": { "disclaimer": "Tahmini — hesap başına marjı, çapraz vs izole, eklenen marjı veya ADL'yi bilemez." }
}
ok: true, empty: true sahte çubuklar değil, düz bir İngilizce mesajla döner. realized_context canlı zorunlu likidasyon akışından genç, büyüyen bir örnektir, yalnızca bağlam olarak sunulur — projeksiyonu "gerçekleşmiş" yapmaz.GET /v1/wallet/{addr}/profile
Çapraz mekan cüzdan profili tamamen canlı takip edilen balina pozisyon anlık görüntülerinden oluşturulmuştur. Takip edilen bir Hyperliquid balinası için, mevcut açık pozisyonlar, gerçekleşmemiş-PnL / maruz kalma / pozisyon sayısı zaman serisi, bir AÇ/KAPA/ÇEVİR aktivite zaman çizelgesi (ardışık anlık görüntüleri farklayarak yeniden oluşturulmuştur), çözülmüş HL-lider tablosu etiketi ve açık kitap özeti döndürülür. Canlı sayfa: wallet-profiler.html.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| addrgerekli | string | Cüzdan adresi (yol segmenti), örn. /v1/wallet/0x3bcae23e…/profile. |
| daysisteğe bağlı | integer | Seri ve zaman çizelgesi için geriye dönük pencere. Varsayılan: 30. |
Örnek İstek
Örnek Yanıt
"ok": true, "wallet": "0x3bcae23e…", "tracked": true,
"first_seen_ts": 1782827733, "latest_snapshot_ts": 1783418468, "as_of": 1783418468,
"hyperliquid": {
"label": { "name": "Andre is back", "score": 74,
"window_pnl_usd": 1307000, kazanma_oranı_yüzde: 71, işlemler: 42 },
pozisyonlar: [
{ platform: hyperliquid, sembol: ETH, yön: kısa,
boyut: 1200.0, giriş_fiyatı: 1800.0, gerçekleşmemiş_kar_zarar: 34800.0,
kaldıraç: 20.0, değer_usd: 2160000.0 }
],
seri: [ { zaman_damgası: 1783330000, gerçekleşmemiş_kar_zarar: 42000.0, maruz_kalma_usd: 18400000.0, pozisyonlar: 5 } ],
zaman_çizelgesi: [ { zaman_damgası: 1783400000, olay: tersine_çevirme, sembol: ETH,
yön: kısa, önceki_yön: uzun, değer_usd: 2160000.0 } ],
özet: {
açık_pozisyonlar: 5, kârda: 3, zararda: 2, uzunlar: 0, kısalar: 5,
toplam_gerçekleşmemiş_kar_zarar: -12000.0, toplam_maruz_kalma_usd: 21000000.0, harmanlanmış_kaldıraç: 19.9,
pencere_gün: 30, penceredeki_anlık_görüntüler: 474,
gerçekleşmiş_kar_zarar: None, gerçekleşmiş_kar_zarar_notu: Türetilemez — yalnızca açık anlık görüntüler görülür, kapanış işlemleri asla görülmez.
}
}
}
pnl HL'nin kendi gerçekleşmemiş piyasa değeri, value_usd açık nominal değerdir. Round-trip başına gerçekleşmiş K&Z mevcut değil (yalnızca açık anlık görüntüler görürüz, kapanış işlemleri asla görülmez) ve şu şekilde gösterilir: null / —; zaman çizelgesi KAPATMA olayları herhangi bir K&Z iddiası taşımaz. Geçerli ancak izlenmeyen bir adres notla döner; tracked: false geçersiz bir adres şunu döndürür: ok: false, error: "invalid_address" (HTTP 400). HL-liderlik etiketi, HL'nin keşif anındaki kendi pencere durumudur, bizim tarafımızdan hesaplanmaz.GET /flows
BTC, ETH ve SOL arasındaki dönüşüm modellerini gösteren çoklu varlık sermaye akış verilerini döndürür. Hangi varlığın sermaye biriktirdiğini ve hangisinin dağıtıldığını belirlemek için kullanışlıdır.
Örnek Yanıt
zaman_damgası: 1710940821,
akışlar: {
BTC: { 1s: 142000000, 4s: 380000000, 12s: -90000000, 24s: 220000000 },
ETH: { 1s: -38000000, 4s: -110000000, 12s: 55000000, 24s: -80000000 },
SOL: { 1s: 12000000, 4s: 29000000, 12s: 18000000, 24s: 44000000 }
},
tespit_edilen_dönüşümler: [
4 saatlik pencerede ETH'den BTC'ye sermaye dönüşümü,
Tüm pencerelerde tutarlı SOL birikimi
]
}
GET /whale-events
Belirtilen geriye dönük pencere içinde izlenen cüzdanlar ve zincir üstü adreslerde tespit edilen önemli balina pozisyon değişikliklerini — açılışları, kapanışları ve yön değişimlerini — döndürür.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| sembolopsiyonel | string | Varlığa göre filtrele. Tüm izlenen varlıklar için boş bırakın. |
| önemopsiyonel | string | Olay önemine göre filtrele: high, medium, veya all. Varsayılan: all |
| saatopsiyonel | integer | Geriye dönük pencere saat cinsinden. Varsayılan: 24 |
Örnek Yanıt
sembol: BTC,
özet: {
uzuna_dönüşümler: 3,
kısaya_dönüşümler: 1,
yeni_açılışlar: 7,
kapanışlar: 2
},
olaylar: [
{
tür: flip_long,
cüzdan: 0xWhale...a4f2,
yön: long,
size_usd: 4200000,
ts: 1710938400
}
]
}
summary nesnesini döndürür. Pro planı: Tam events cüzdan tanımlayıcıları, boyutları ve zaman damgalarıyla besleme.GET /regimes/history
Belirli bir varlık için geçmiş rejim sınıflandırma verilerini döndürür. Bunu, belirli rejim türlerinin tarihsel performansını, her rejim türünün tipik olarak ne kadar sürdüğünü ve rejim geçişlerinin zaman içinde nasıl gerçekleştiğini test etmek için kullanın.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| symbolopsiyonel | string | Varlık sembolü. Varsayılan: BTC |
| regimeopsiyonel | string | Belirli bir rejim türüne filtrele, örn. late_cycle_divergence. Tüm rejimler için boş bırakın. |
| daysopsiyonel | integer | Gün cinsinden geriye dönük pencere. Varsayılan: 30. Maksimum: 365 |
Örnek Yanıt
"symbol": "BTC",
"current_regime": "late_cycle_divergence",
"regime_summary": {
"late_cycle_divergence": { "occurrences": 4, "avg_duration_h": 38, "avg_return_pct": -2.1 },
"accumulation": { "occurrences": 6, "avg_duration_h": 72, "avg_return_pct": 5.4 },
"breakout": { "occurrences": 3, "avg_duration_h": 18, "avg_return_pct": 9.2 }
},
"transitions": [
{ "from": "accumulation", "to": "breakout", "ts": 1710850000 },
{ "from": "breakout", "to": "late_cycle_divergence", "ts": 1710915000 }
]
}
/analysis ile birleştirin.GET /exchange-health
İzlenen tüm borsalar için borsa başına gecikme, hata oranları ve veri eskime göstergeleri dahil gerçek zamanlı sağlık durumunu döndürür. Kimlik doğrulama gerekmez — herkese açık endpoint.
Örnek Yanıt
"overall_status": "ok",
"ts": 1710940821,
"exchanges": {
"bybit": { "status": "ok", "latency_ms": 42, "error_rate_1h": 0.0, "last_data_age_s": 18 },
"binance": { "status": "ok", "latency_ms": 38, "error_rate_1h": 0.0, "last_data_age_s": 22 },
"hyperliquid": { "status": "degraded", "latency_ms": 310, "error_rate_1h": 0.04, "last_data_age_s": 95 },
"okx": { "status": "ok", "latency_ms": 55, "error_rate_1h": 0.0, "last_data_age_s": 30 }
}
}
GET /sentiment
Türev sentimantı, balina aktivitesi, oynaklık ve sosyal sinyallerden hesaplanan gerçek zamanlı Korku & Açgözlülük indeksini (0-100) döndürür. Trend analizi için bileşen ayrıştırma ve 24 saatlik geçmiş içerir.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| symbolopsiyonel | string | Varlık sembolü. Varsayılan: BTC |
Örnek Yanıt
"symbol": "BTC",
"score": 72,
"label": "Açgözlülük",
"components": {
"volatilite": 65,
"momentum": 78,
"türevler": 70,
"balina_aktivitesi": 75,
"sosyal": 68
},
"history_24h": [
{ "ts": 1710940800, "score": 68, "label": "Açgözlülük" },
{ "ts": 1710937200, "score": 65, "label": "Açgözlülük" }
],
"ts": 1710940821
}
Entegrasyonlar
GET /tradingview/setup
Kişiselleştirilmiş TradingView entegrasyon ayarlarınızı döndürür: webhook URL'si, doğrulama için gizli anahtar ve Smart Money API'ye doğrudan bağlanan hazır Pine Script göstergeleri. Sinyallerimizi herhangi bir grafiğin üzerine yerleştirmek için Pine Script'i TradingView'e kopyalayıp yapıştırın.
Örnek Yanıt
"webhook_url": "https://api.smartmoneyapi.com/v1/tradingview/webhook",
"webhook_secret": "tvs_a1b2c3...",
"pine_scripts": {
"composite_indicator": "// Smart Money Composite v1 //@version=5 indicator(...)...",
"whale_activity": "// Whale Activity Overlay v1 ...",
"funding_dashboard": "// Funding Rate + LSR Dashboard v1 ..."
}
}
POST /tradingview/webhook
Bir TradingView uyarısını alır, işler /confirm, ve onayı döndürür. TradingView özel başlık gönderemez, bu nedenle kimlik doğrulama için webhook'unuzu secret JSON gövdesine ekleyin (bu endpoint X-API-Key kullanmaz). Yanıt, onayı sarar ve üst düzey bir action ekler CONFIRMED (daemon güven YÜKSEK/ORTA) veya VETOED.
İstek Gövdesi
"secret": "your_webhook_secret",
"symbol": "BTC",
"direction": "long",
"timeframe": "1h",
"strategy": "EMA crossover",
"price": 67500.0
}
Gerekli: secret, symbol, direction (long|short). Opsiyonel: source, timeframe, strategy, price.
Kişiselleştirme
GET /preferences
Varsayılan işlem parametreleri, risk profili, izleme listesi ve bildirim tercihleri dahil olmak üzere mevcut kişiselleştirme ayarlarınızı döndürür.
Aşağıdaki alanların herhangi bir alt kümesini içeren bir JSON gövdesi göndererek tercihleri güncelleyin. Atlanan alanlar mevcut değerlerini korur.
Tercih Alanları
| Alan | Tür | Açıklama |
|---|---|---|
| default_trade_size_usd | float | Kelly ve akıllı-stop hesaplamaları için varsayılan pozisyon büyüklüğü (USD cinsinden) |
| risk_tolerance | string | conservative, moderate, veya aggressive |
| default_risk_pct | float | Hesabın %'si olarak varsayılan işlem başına risk. Şu durumda kullanılır: /smart-stop ne zaman risk_pct atlanmış |
| watchlist | array | Varlık sembollerinin sıralı listesi, örn. ["BTC","ETH","SOL"] |
| notification_email | string | Uyarıların gönderileceği e-posta adresi |
| timezone | string | IANA zaman dilimi dizesi, örn. America/New_York |
"default_trade_size_usd": 5000,
"risk_tolerance": "moderate",
"default_risk_pct": 1.5,
"watchlist": ["BTC", "ETH", "SOL"]
}
GET /watchlist
Yapılandırılmış izleme listenizdeki tüm semboller için bir onay durumu anlık görüntüsü ve temel risk metriklerini döndürür. Her sembol için ayrı ayrı çağrı yapmadan çoklu varlık genel bakışı sağlar. /confirm ayrı ayrı her sembol için.
Örnek Yanıt
"ts": 1710940821,
"watchlist": [
{
"symbol": "BTC",
"confidence": "HIGH",
"action": "CONFIRM",
"regime": "accumulation",
"cascade_risk": "LOW"
},
{
"symbol": "ETH",
"confidence": "MEDIUM",
"action": "REDUCE",
"regime": "late_cycle_divergence",
"cascade_risk": "HIGH"
},
{
"symbol": "SOL",
"confidence": "HIGH",
"action": "CONFIRM",
"regime": "breakout",
"cascade_risk": "MEDIUM"
}
]
}
Gerçek Zamanlı Akış (Canlı Takaslar)
Kendi BSC ve Avalanche düğümlerimizden gerçek zamanlı olarak tespit edilen ≥ $500 DEX takaslarını akışla aktarın. İki taşıma yöntemi mevcuttur: ücretsiz/tarayıcı istemcileri için bir genel Sunucu Tarafından Gönderilen Olaylar (SSE) akışı ve ücretli kullanıcılar için düşük gecikmeli bir WebSocket firehose. Olaylar, bir bloğa dahil edildikten saniyeler içinde yayınlanır.
Genel SSE Akışı (Ücretsiz)
Kimlik doğrulama gerekmez. Tüm modern tarayıcılarda yerel EventSource destek vardır. Sunucu, bağlantıyı canlı tutmak için swap olaylar ve periyodik sinyaller gönderir.
es.addEventListener("swap", e => {
const swap = JSON.parse(e.data);
console.log(swap.chain, swap.pair, swap.amount_usd);
});
WebSocket Firehose (Ücretli)
Kimlik Doğrulama (tavsiye edilir): uzun ömürlü anahtarınızı asla URL'ye koymayın — proxy'ler tarafından kaydedilir ve tarayıcı geçmişinde saklanır. Bunun yerine anahtarınızı POST edin /v1/ws/ticket güvenli X-API-Key başlığını kullanarak, ardından döndürülen tek kullanımlık ticket (geçerlilik ~60s, bir kez kullanılır). Başlık ayarlayabilen sunucu tarafı istemciler, doğrudan el sıkışmasında X-API-Key iletebilir. Ücretsiz kademe anahtarları bir 402 payment_required yanıtı alır. Bağlantı sırasında bir hello çerçevesi, kademeniz ve yayın eşiği ile birlikte gönderilir.
const r = await fetch("https://api.smartmoneyapi.com/v1/ws/ticket", {
method: "POST", headers: { "X-API-Key": "sm_xxx" }
});
const { ticket } = await r.json();
// 2. Open the socket with the single-use ticket
const ws = new WebSocket(`wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=${ticket}`);
ws.onmessage = e => {
const swap = JSON.parse(e.data);
eğer (swap.type === "swap") console.log(swap);
};
WebSocket kimlik doğrulaması (biletler)
Neden: API anahtarınızı asla bir WebSocket URL'sine koymayın — sorgu dizeleri vekil sunucular, yük dengeleyiciler tarafından kaydedilir ve tarayıcı geçmişinde saklanır. Bunun yerine, anahtarınızı normal bir kimlik doğrulamalı POST ile kısa ömürlü, tek kullanımlık bir bilet ile değiştirin, ardından bu biletle bağlantı kurun.
Akış: POST isteği gönderin /v1/ws/ticket başlığınızla X-API-Key → alın { "ticket": "…", "expires_in": 60 }. Ardından açın wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>. Bilet tek kullanımlık ve süresi doluyor ~60 saniye. İstek başlıklarını ayarlayabilen sunucu tarafı istemciler, bunun yerine X-API-Key doğrudan WebSocket el sıkışmasında iletebilir — bilete gerek yok.
Kimliği doğrulanmış bir WebSocket el sıkışması için tek kullanımlık bir bilet oluşturur. Kimlik doğrulama için X-API-Key başlığını kullanın (anahtarınız asla istek başlıklarından ayrılmaz). Döndürülen bilet, süresi dolmadan önce /v1/ws/live-swaps üzerinde bir kez kullanılabilir.
"https://api.smartmoneyapi.com/v1/ws/ticket"
Örnek Yanıt
"ticket": "wst_9f3c1a8e4b2d…",
"expires_in": 60
}
Yanıt Alanları
| Alan | Tür | Açıklama |
|---|---|---|
| ticket | string | Tek kullanımlık token, WebSocket URL'sine ?ticket= olarak eklenir. Bir kez kullanılır, ardından geçersiz kılınır. |
| expires_in | number | Biletin süresinin dolmasına kalan saniye (~60). Her bağlantı denemesi için yeni bir bilet oluşturun. |
Not: eski ?key= sorgu parametresi kimlik doğrulaması artık kabul edilmiyor WebSocket uç noktalarında güvenlik nedenleriyle. Bir bilet (tarayıcı istemcileri) veya X-API-Key el sıkışma başlığını (sunucu tarafı istemciler) kullanın.
REST Anlık Görüntü
Dönen tampondan son yayınlanan N takası döndürür. Akış bağlantısı açılmadan önce panolar için ilk görüntülemede kullanışlıdır. Ayrıca mevcut: /v1/live-swaps/status yayıncı istatistikleri için.
Olay Şeması
| Alan | Tür | Açıklama |
|---|---|---|
| chain | string | bsc veya avalanche |
| dex | string | Router adı (ör. pancakeswap_v2, traderjoe) veya unknown_dex |
| swapper | string | Takası gerçekleştiren cüzdanın tam 0x adresi |
| swapper_short | string | Görüntüleme için kısaltılmış form (ör. 0xb300…028d) |
| swapper_url | string | Swapper'a zincirin blok gezgininde doğrudan bağlantı |
| tx_hash | string | İşlem hash'i |
| explorer_url | string | İşleme BscScan / Snowtrace üzerinde doğrudan bağlantı |
| token_in | string | Satılan token sembolü (ör. USDT) |
| token_out | string | Alınan token sembolü |
| amount_usd | number | Takasın USD değeri (minimum: $500) |
| pair | string | Biçimlendirilmiş çift etiketi (ör. USDT → USDC) |
| block | number | Takasın işlendiği blok numarası |
| timestamp | number | Unix epoch saniyesi |
| significance | string | low / medium / high / critical USD boyutuna göre |
| seq | number | Monotonik yayın sıra numarası — boşluk tespiti için kullanın |
POST /alerts/conditions
Belirtilen bir metrik bir eşiği aştığında tetiklenen özel uyarı kuralları oluşturun. Uyarılar, tercihlerinize bağlı olarak webhook, e-posta veya pano bildirim beslemesi ile iletilir.
Yapılandırılmış tüm uyarı koşullarınızı ID'leri, tanımları ve mevcut durumlarıyla birlikte döndürür.
Bir uyarı koşulunu ID'sine göre kalıcı olarak kaldırır.
Zaman damgaları, eşleşen koşullar ve tetikleme anındaki metrik değeri ile son uyarı tetikleme olaylarını döndürür.
Uyarı Oluştur — İstek Gövdesi
| Alan | Tür | Açıklama |
|---|---|---|
| namerequired | string | Bu uyarı için insan tarafından okunabilir etiket (maks 64 karakter) |
| metricrequired | string | İzlenecek metrik. Aşağıdaki mevcut metrikler tablosuna bakın. |
| symboloptional | string | Varlık bağlamı. Sembol kapsamlı metrikler için gereklidir, örneğin funding_rate. |
| operatorrequired | string | Karşılaştırma operatörü: gt, lt, eq, crosses_above, crosses_below |
| thresholdrequired | float | Metrikle karşılaştırılacak sayısal değer |
| deliveryoptional | string | Teslimat kanalı, örneğin telegram (varsayılan) veya webhook |
| cooldown_minutesoptional | integer | Yeniden tetikleme arasındaki minimum dakika (varsayılan 60) |
Geçerli metrikler ve operatörlerin canlı listesi şu adresden döndürülür: GET /v1/alerts/conditions as available_metrics and available_operators.
Mevcut Metrikler
| Metric | Açıklama |
|---|---|
| funding_rate | Sembol için mevcut fonlama oranı (ondalık olarak) |
| global_lsr | Sembol için küresel uzun/kısa oranı |
| long_pct | Sembol için net uzun pozisyondaki hesapların yüzdesi |
| top_trader_lsr | Sembol için üst seviye trader uzun/kısa oranı |
| taker_ratio | Sembol için taker alış/satış oranı |
| mvrv | Piyasa Değerinin Gerçekleşmiş Değere Oranı (BTC/ETH) |
| sopr | Harcanan Çıktı Kâr Oranı (BTC/ETH) |
| exchange_net_flow | On-chain borsa net akış sinyali |
| accumulation | On-chain birikim sinyali |
| whale_long_pct | Sembol için takip edilen balina cüzdanlarının uzun pozisyon tutma yüzdesi |
| whale_n_wallets | Sembolde pozisyonu olan takip edilen balina cüzdanlarının sayısı |
| composite_long | Uzun yönde sorgulanan sembol için kompozit skor |
| composite_short | Kısa yönde sorgulanan sembol için kompozit skor |
| funding_spread | Sembol için çapraz platform fonlama spreadi |
"name": "BTC fonlama oranı artışı",
"metric": "funding_rate",
"symbol": "BTC",
"operator": "gt",
"threshold": 0.05
}
GET /kelly
Verilen sembol, güven seviyesi ve yön için tarihsel sinyal performansına göre kalibre edilmiş Kelly Kriteri pozisyon büyüklüğü önerilerini döndürür. Pozisyon büyüklüğünü ampirik kazanma oranlarına dayandırarak aşırı kaldıraç kullanımını önler.
Parametreler
| Parametre | Tip | Açıklama |
|---|---|---|
| symbolrequired | string | Varlık sembolü: BTC, ETH, veya SOL |
| confidenceoptional | string | Modellenecek sinyal güven seviyesi: HIGH, MEDIUM, veya LOW. Varsayılan: HIGH |
| directionoptional | string | İşlem yönü: long veya short. Varsayılan: long |
| account_sizeoptional | float | Hesaplama için hesap büyüklüğü USD cinsinden suggested_size_usd. Varsayılan: 10000 |
Örnek Yanıt
"symbol": "BTC",
"confidence": "YÜKSEK",
"direction": "long",
"win_rate": 0.68,
"avg_reward_risk_ratio": 2.1,
"kelly_fraction": 0.36,
"half_kelly": 0.18,
"suggested_size_usd": 1800,
"samples": 142,
"note": "Tahmin hatasını hesaba katmak için canlı işlemlerde Half-Kelly önerilir."
}
GET /performance
API tarafından verilen sinyallerin tarihsel doğruluk istatistiklerini güven düzeyine göre ayrıştırarak döndürür. Sermaye taahhüt etmeden önce sinyal güvenilirliğini anlamak için faydalıdır.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| sembolisteğe bağlı | string | Varlığa göre filtrele. Tüm semboller için toplu istatistikler için boş bırakın. |
| günleristeğe bağlı | integer | Geriye dönük bakış penceresi gün cinsinden. Varsayılan: 30 |
Örnek Yanıt
"sembol": "BTC",
"period_days": 30,
"by_confidence": {
"HIGH": { "win_rate": 0.71, "samples": 58, "avg_return_pct": 3.4 },
"MEDIUM": { "win_rate": 0.54, "samples": 84, "avg_return_pct": 1.2 }
}
}
İstatistikler ve Sinyaller
GET /v1/stats
Site genelinde dürüst performans istatistikleri kaynağı smart_money_confirm farklı çağrı sonuçları. YÜKSEK ve ORTA güven düzeylerindeki kazanma oranlarını, genel doğruluk, kâr faktörünü ve sembol bazında bir ayrıştırmayı döndürür. Tüm rakamlar puanlama penceresi içinde örneklenmiştir; bağlam ve ileriye dönük tutma metodolojisi için calibration.html adresine danışın.
Örnek Yanıt
"high_winrate": 0.714,
"high_winrate_n": 14,
"medium_winrate": 0.530,
"medium_winrate_n": 34,
"overall_accuracy": 0.613,
"overall_accuracy_n": 48,
"profit_factor": 1.77,
"avg_win_pct": 4.2,
"winrate_horizon": "24h",
"winrate_basis": "farklı onay çağrıları, 24 saatte çözülen sonuçlar",
"winrate_by_symbol": {
"BTC": { "win_rate": 0.68, "n": 22 },
"ETH": { "win_rate": 0.55, "n": 18 },
"SOL": { "win_rate": 0.60, "n": 8 }
},
"forward_holdout": {
"win_rate": 0.59,
"high_win_rate": 0.70,
"high_n": 10,
"is_distinct_from_insample": false
}
}
forward_holdout nesnesi, puanlayıcının hiç görmediği veriler üzerinde biriken tek sayıdır — zamanla büyümesini izleyin. Tam metodoloji ve örnek içi / ileriye dönük test sınırı için calibration.html adresine bakın.GET /v1/signals/performance
Birden fazla çözünürlük ufku (4h, 12h, 24h, 72h) üzerinde sinyal sonuçlarını takip eder. Her ufuk için isabet oranlarını, toplam sinyal sayılarını ve sinyal türüne göre bir ayrıştırmayı döndürür.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| günleristeğe bağlı | integer | Geriye dönük bakış penceresi gün cinsinden. Varsayılan: 30 |
| sinyal_türüisteğe bağlı | string | Türe göre filtrele, örneğin smart_money_confirm veya regime_flip. Tüm türler için boş bırakın. |
| sembolisteğe bağlı | string | Varlık sembolüne göre filtrele, örneğin BTC. Tüm semboller için toplu istatistikler için boş bırakın. |
Örnek Yanıt
"sinyal_türü": "smart_money_confirm",
"sembol": "BTC",
"günler": 30,
"total_signals": 48,
ufuklar: {
4s: { isabet_oranı: 0.65, çözüldü: 46 },
12s: { isabet_oranı: 0.61, çözüldü: 44 },
24s: { isabet_oranı: 0.58, çözüldü: 40 },
72s: { isabet_oranı: 0.54, çözüldü: 32 }
},
tür_dağılımı: {
akıllı_para_onayı: { sayı: 35, isabet_oranı_24s: 0.61 },
rejim_değişimi: { sayı: 13, isabet_oranı_24s: 0.47 }
}
}
GET /v1/signals/recent
İzlenen tüm sembollerde yayınlanan YÜKSEK ve ORTA sinyallerin son akışı. Her giriş, sinyal türünü, güven seviyesini, yönünü ve mevcut olduğunda çözüm durumunu içerir.
Örnek Yanıt
sinyaller: [
{
id: 1042,
sembol: BTC,
yön: long,
sinyal_türü: akıllı_para_onayı,
güven: YÜKSEK,
kompozit: 0.74,
ts: 1710940821,
çözüldü: true,
sonuç_24s: kazanç
}
],
sayı: 50
}
GET /v1/signals/{id}/outcome
Sayısal ID'ye göre tek bir sinyalin çözülmüş sonucu. Her çözüm ufukunda (4s, 12s, 24s, 72s) isabet/kaçırma ile sinyal zamanındaki ve çözümdeki fiyatı döndürür.
Parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| idgerekli | tamsayı | Sinyal ID'si (yol segmenti), örn. /v1/signals/1042/outcome |
Örnek Yanıt
id: 1042,
sembol: BTC,
yön: long,
güven: YÜKSEK,
giriş_fiyatı: 63200.0,
ts: 1710940821,
sonuçlar: {
4s: { sonuç: kazanç, fiyat: 64100.0, yüzde: 1.41 },
12s: { sonuç: kazanç, fiyat: 65200.0, yüzde: 3.16 },
24s: { sonuç: kazanç, fiyat: 65800.0, yüzde: 4.11 },
72s: { sonuç: beklemede, fiyat: null, yüzde: null }
}
}
GET /v1/confirm-winrate
Kimliği doğrulanmış kullanıcının kendi API anahtarı için onay-sinyal kazanma oranı dağılımı. Her güven seviyesinde ayrı çağrı kazanma oranlarını, kâr faktörünü ve sembol başına rakamları döndürür. Geçerli bir X-API-Key başlık gerektirir.
Örnek İstek
"https://api.smartmoneyapi.com/v1/confirm-winrate"
Örnek Yanıt
yüksek_kazanma_oranı: 0.714,
yüksek_n: 14,
orta_kazanma_oranı: 0.530,
medium_n: 34,
overall_accuracy: 0.613,
overall_n: 48,
profit_factor: 1.77,
winrate_horizon: 24h,
by_symbol: {
BTC: { win_rate: 0.68, n: 22 },
ETH: { win_rate: 0.55, n: 18 }
}
}
Shadow Gate
An immutable, append-only personal decision ledger. Submit your trade decisions before or after executing them; the system computes a confirm score against the Smart Money engine and appends a permanent row. Use it to build an honest, timestamped track record of how well the API's signal aligned with your own entries — entirely independent of the global win-rate pool. Free and Trader tier responses have evidence fields stripped; Pro returns the full breakdown. A tier delay applies to Free tier data.
Submit a decision. Idempotent on the Idempotency-Key request header — re-submitting the same key returns the existing row without creating a duplicate. The system immediately calls the confirm engine and appends the result as an immutable ledger row.
Request Body
| Field | Type | Description |
|---|---|---|
| symbolrequired | string | Asset symbol, e.g. BTC |
| siderequired | string | Trade direction: long or short |
| strategy_idoptional | string | Caller-defined strategy label (max 64 chars). Stored as-is for grouping and filtering. |
Example Request
-H "X-API-Key: sm_your_key" \
-H "Idempotency-Key: my-signal-20260701-001" \
-H "Content-Type: application/json" \
-d '{"symbol":"BTC","side":"long","strategy_id":"ema_crossover"}' \
"https://api.smartmoneyapi.com/v1/shadow-gate/decisions"
Example Response
"id": 318,
"symbol": "BTC",
"side": "long",
"strategy_id": "ema_crossover",
"decision": "CONFIRM",
"confidence": "HIGH",
"composite": 0.74,
"size_mult": 1.5,
"ts": 1710940821,
"resolved": false
}
factors / adjustments evidence fields. Pro returns the full confirm breakdown. A tier delay applies to Free — the row is written immediately but the confirm score may reflect cached data up to 60 seconds old.List your own shadow-gate decisions, newest first. Owner-scoped — only decisions submitted by your API key are returned.
Parameters
| Parameter | Type | Description |
|---|---|---|
| limitoptional | integer | Maximum rows to return. Default: 50, max: 200 |
| cursoroptional | string | Opaque pagination cursor from a previous response's next_cursor field. Omit for the first page. |
Example Response
"decisions": [
{ "id": 318, "symbol": "BTC", "side": "long", "decision": "CONFIRM", "confidence": "HIGH", "composite": 0.74, "size_mult": 1.5, "ts": 1710940821, "resolved": false },
{ "id": 317, "symbol": "ETH", "side": "short", "decision": "SKIP", "confidence": "LOW", "composite": -0.12, "size_mult": 0.0, "ts": 1710937000, "resolved": true }
],
"count": 2,
"next_cursor": null
}
ID'ye göre tek bir karar, Pro seviyesi için tam onay kanıtı dahil. Ücretsiz ve Trader seviyesi yanıtlarında factors ve adjustments kaldırılmıştır. Döndürür 403 eğer karar farklı bir API anahtarına aitse.
Örnek Yanıt (Pro)
"id": 318,
"symbol": "BTC",
"side": "long",
"strategy_id": "ema_crossover",
"decision": "CONFIRM",
"confidence": "HIGH",
"composite": 0.74,
"size_mult": 1.5,
"factors": {
"derivatives": { "score": 0.81, "weight": 0.40, "weighted": 0.324 },
"onchain": { "score": 0.68, "weight": 0.35, "weighted": 0.238 },
"whale": { "score": 0.73, "weight": 0.25, "weighted": 0.183 }
},
"ts": 1710940821,
"resolved": false,
"outcome": null
}
Bir kararın sonucunu manuel olarak çözün. Bu işlemi, işlemi kapattıktan sonra nihai sonucu defter satırına kaydetmek için çağırın. Bir kez çözüldüğünde, satır değiştirilemez ve tekrar değiştirilemez.
İstek Gövdesi
| Alan | Tür | Açıklama |
|---|---|---|
| outcomerequired | string | İşlem sonucu: win veya loss |
| exit_priceoptional | float | İşlem için çıkış fiyatı. Referans için saklanır; sağlanırsa P&L % hesaplamak için kullanılır. |
| pnl_pctoptional | float | Gerçekleşen P&L, pozisyon büyüklüğünün yüzdesi olarak, örneğin 3.5 veya -1.2 |
Örnek Yanıt
"id": 318,
"resolved": true,
"outcome": "win",
"exit_price": 65800.0,
"pnl_pct": 4.1,
"resolved_at": 1711027200
}
Hata Kodları
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | invalid_params | Eksik veya geçersiz sorgu parametreleri |
| 401 | unauthorized | Eksik veya geçersiz API anahtarı |
| 403 | plan_restriction | Mevcut planınızda bu uç nokta kullanılamıyor |
| 429 | rate_limit_exceeded | Günlük veya ani limit aşıldı |
| 500 | internal_error | Sunucu hatası — kaynak durumu için /health'i kontrol edin |
| 503 | data_stale | Veri kaynağı kullanılamıyor; son bilinen verilerle döndürüldü |
Kod Örnekleri
Python
r = requests.get(
"https://api.smartmoneyapi.com/v1/confirm",
params={"symbol": "BTC", "direction": "long"},
headers={X-API-Key: sm_your_key}
)
data = r.json()
print(data["confidence"]) # HIGH / MEDIUM
print(data["size_mult"]) # 1.5 / 1.0
API_KEY = "sm_your_key"
BASE_URL = "https://api.smartmoneyapi.com/v1"
def confirm_trade(symbol, direction):
resp = requests.get(
f"{BASE_URL}/confirm",
params={"symbol": symbol, "direction": direction},
headers={"X-API-Key": API_KEY},
timeout=5
)
resp.raise_for_status()
return resp.json()
# İşlem döngünüzde:
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
print("Atlanıyor — yetersiz güven")
else:
size = base_size * signal["size_mult"]
place_order(symbol, direction, size)
JavaScript / Node.js
async function confirmTrade(symbol, direction) {
const params = new URLSearchParams({ symbol, direction });
const res = await fetch(
`https://api.smartmoneyapi.com/v1/confirm?${params}`,
{ headers: { 'X-API-Key': API_KEY } }
);
if (!resok) throw new Error(`API hatası: ${resstatus}`);
return res.json();
}
// Kullanım
confirmTrade('BTC', 'long').then(data => {
console.log(data.confidence, data.size_mult);
});
cURL
curl -X GET \
-H "X-API-Key: sm_your_key" \
"https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"
# Balina verilerini al
curl -X GET \
-H "X-API-Key: sm_your_key" \
"https://api.smartmoneyapi.com/v1/whales?symbol=BTC"
# Kullanımı kontrol et
curl -X GET \
-H X-API-Key: sm_your_key \
https://api.smartmoneyapi.com/v1/usage
Freqtrade Entegrasyonu
Herhangi bir Freqtrade stratejisine Smart Money onayı eklemek için confirm_trade_entry metodunu geçersiz kılın.
from freqtrade.strategy import IStrategy
class SmartMoneyStrategy(IStrategy):
SM_API_KEY = "sm_your_key"
SM_BASE = "https://api.smartmoneyapi.com/v1"
def confirm_trade_entry(self, pair, order_type,
amount, rate, time_in_force,
current_time, entry_tag, **kwargs):
symbol = pair.split("/")[0]
if symbol not in ["BTC", "ETH", "SOL"]:
return True # Desteklenmeyenler için kontrolü atla
try:
r = requests.get(
f"{self.SM_BASE}/confirm",
params={"symbol": symbol, "direction": "long"},
headers={"X-API-Key": self.SM_API_KEY},
timeout=3
).json()
return r.get("confidence") in ["HIGH", "MEDIUM"]
except:
return True # API hatasında açık bırak
CCXT + Smart Money
exchange = ccxt.bybit({
"apiKey": "YOUR_BYBIT_KEY",
"secret": "YOUR_BYBIT_SECRET"
})
SM_KEY = "sm_your_key"
def smart_trade(symbol, side, amount):
# Önce onayı kontrol et
conf = requests.get(
"https://api.smartmoneyapi.com/v1/confirm",
params={"symbol": symbol, "direction": side},
headers={"X-API-Key": SM_KEY}
).json()
if conf["confidence"] not in ["HIGH", "MEDIUM"]:
print(f"{symbol} {side} atlanıyor — yeterli güven yok.")
return None
adj_amount = amount * conf["size_mult"]
order = exchange.create_market_order(
f"{symbol}/USDT", side, adj_amount
)
print(f"Sipariş verildi: {adj_amount} {symbol} {side}")
return order
Şunu kontrol edin: API durum sayfası gerçek zamanlı sistem durumu bilgileri için veya iletişim formumuzu.