Risk Motoru & Webhook Referansı
AlgoVesta her sinyali yürütmeden önce nasıl doğrular ve TradingView veya herhangi bir webhook kaynağından gönderilecek tam JSON gövdesi. Alan adları birebirdir — olduğu gibi kopyalayın.
AlgoVesta üç tetikleyici kanaldan işlem yürütür: AI asistanları için bir MCP sunucusu, Telegram sinyalleri ve TradingView webhook'ları. Hangi kanal tetiklenirse tetiklensin, emir borsanıza veya MetaTrader 5 hesabınıza ulaşmadan önce aynı sunucu tarafı risk motoru tarafından doğrulanır. Bu sayfa üçü için de teknik referans merkezidir.
Bir işlemi tetiklemenin üç yolu
Her kanal aynı yürütme yolunda sona erer: doğrulama, boyutlandırma, emir, ardından stop-loss ve take-profit'in borsanın kendisinde yerleştirilmesi. Zaten çalışma şeklinize uyan kanalı seçin.
AI asistanları için MCP sunucusu
Claude, ChatGPT, Cursor veya MCP destekleyen herhangi bir istemciyi tek bir kimlik doğrulamalı bağlantı üzerinden yirmi yerleşik işlem aracına bağlayın. Her bağlantı $5,000 paper bakiyesiyle başlar ve canlı anahtarlar ikinci bir faktörle ayrıca oluşturulur. Kimlik doğrulama ya PKCE'li (S256) OAuth 2.1 ya da kullanıcıya özel gizli bir bağlantı ile yapılır.
Telegram sinyal kanalları
AlgoVesta'yı zaten takip ettiğiniz sinyal kanallarına yönlendirin. Mesajlar sembol, yön, giriş, stop-loss ve hedeflere ayrıştırılır, ardından borsanızda yürütülür veya MetaTrader 5'e iletilir. Belirsizlik olmadan ayrıştırılamayan sinyaller tahmin edilmek yerine reddedilir.
TradingView webhook'ları
Herhangi bir gösterge, çizim veya Pine stratejisinden özel webhook URL'nize bir alarm gönderin. Alarm gövdesi aşağıda belgelenen formatta geçerli JSON olmalıdır ve otomatik işlem yapılan her sinyalin kaynağı emir açılmadan önce doğrulanır.
Risk Motoru: bir sinyal nasıl doğrulanır
Bir sinyal asla körü körüne yürütülmez. Herhangi bir emir açılmadan önce, canlı piyasa koşullarına ve belirlediğiniz limitlere karşı kontrol eden çok modüllü bir doğrulama katmanından geçer. Kesin bir kural başarısız olursa sinyal reddedilir — küçültülmez.
Kesin modül seti ve eşikler platform ayarlandıkça değişir. İlke sabittir: kurallarınız ve risk limitleriniz, bir emir borsanıza ulaşmadan önce her zaman uygulanır.
Günlük zarar & drawdown koruması
Sinyal-başı kontrollerin ötesinde, hesap düzeyinde iki koruma sürekli çalışır.
Webhook gövde referansı
AlgoVesta webhook URL'nize JSON gövdeli bir HTTP POST gönderin. TradingView'de bunu alarm mesaj kutusuna yapıştırın. Alan adları birebir eşleşmelidir.
| Alan | Zorunlu | Açıklama |
|---|---|---|
symbol | Evet | Borsa işlem çifti, örn. BTCUSDT. |
side / action | Evet | Emir yönü: buy veya sell. |
price | Opsiyonel | Giriş referans fiyatı; market giriş için boş bırakın. |
stop_loss | Opsiyonel | Stop-loss fiyatı. Her sinyalde önerilir. |
take_profit | Opsiyonel | Take-profit fiyatı. Uygulama içinde çoklu hedef ayarlanabilir. |
market | Opsiyonel | Hedef piyasa: crypto (varsayılan) veya forex. forex olarak ayarlandığında MetaTrader 5'e gönderilir. Asla sembolden çıkarılmaz. |
lots | Opsiyonel | Sadece forex — lot cinsinden pozisyon büyüklüğü. Yapılandırdığın lot/risk modunu kullanmak için boş bırak. |
leverage | Opsiyonel | Sadece kripto — o sembol için borsanızın limiti geçerlidir. |
amount_usd | Opsiyonel | Sadece kripto — marj, nominal değer değil. Nominal değer = marj × kaldıraç. |
risk_percent | Opsiyonel | Sadece kripto — risk edilecek bakiye yüzdesi (0,1–50). |
quantity | Opsiyonel | Sadece kripto — tam kontrat miktarı. qty, size ve contracts takma ad olarak kabul edilir. |
take_profits | Opsiyonel | Birden fazla hedef: [{"price":…, "close_pct":…}]. tpN_close ile birlikte tp1…tp5 de çalışır. |
trailing | Opsiyonel | {"trigger_pct":…, "distance_pct":…} — takip eden stop (trailing stop). |
breakeven | Opsiyonel | true veya {"trigger_pct":…} — kâra geçince stop'u giriş fiyatına taşır. |
Borsa önekleri temizlenir; BINANCE:BTCUSDT ile BTCUSDT aynı şekilde çalışır. Yön alanında direction ve type, action'ın takma adı olarak kabul edilir ve close geçerli bir değerdir.
Pozisyon büyüklüğü, kaldıraç ve sinyal başına risk panelinizden veya payload'dan gelebilir — payload'daki bir değer önceliklidir. Webhook URL'sinin bir sır olmasının nedeni budur: AlgoVesta'nın yalnızca kaynağını doğrulayabildiği sinyalleri otomatik işleme alması için bir IP izin listesi ekleyin.
Bir pozisyonu kapatma
Sembolle birlikte "action": "close" gönder. O sembole ait pozisyonun tamamı kapatılır — kısmi kapatma desteklenmez; kısmi kapatma istesen bile pozisyonun tamamı kapatılır ve panel bunu belirtir.
Pine strateji uyarıları — çıkışlar otomatiktir
Uyarıyı “Order fills only” seçili bir Pine strategy()'den oluşturuyorsan, action'ı tek başına gönderme: {{strategy.order.action}} bir çıkışta da sell döndürür, bu da kapatmak yerine bir short pozisyon açar. Pozisyon durumu alanlarını dahil et, AlgoVesta giriş, çıkış ve tersine dönüşü senin için hesaplasın.
| Dolumdan sonraki pozisyon | AlgoVesta ne yapar |
|---|---|
flat (or position_size = 0) | Pozisyonu kapatır. Ters yönde emir açılmaz. |
| Önceki duruma zıt | Ters dönüş — önce kapatır, sonra yeni yönde açar. Kapatma başarısız olursa hiçbir şey açılmaz. |
| Öncekiyle aynı yön | O yönde bir giriş olarak değerlendirilir. |
Mesaj JSON olmak zorundadır. TradingView, geçerli bir JSON değilse uyarı gövdesini düz metin olarak gönderir — varsayılan mesajı (ör. “BTCUSDT Crossing 1.00”) yön bilgisi taşımaz ve reddedilir. Belirsiz metin üzerinde asla tahmin yürütmeyiz; bir sinyali reddetmek, yanlış yönde emir açmaktan daha güvenlidir. Ayrıca TradingView, 3 dakika içinde 15 kez tetiklenen uyarıları otomatik olarak durdurur.
Yön, take-profit / stop-loss (tek veya çok seviyeli), kaldıraç, pozisyon büyüklüğü, trailing ve breakeven'i basit anahtarlarla ayarlayın. AlgoVesta tam TradingView alarm mesajını üretir — kopyalayıp alarmınıza yapıştırın.
Görsel oluşturucunun nasıl çalıştığını görün → Adım adım alarm kurulumu →Sıkça sorulan sorular
Üç kanal: AI asistanların kullandığı MCP sunucusu, Telegram sinyal kanalları ve TradingView webhook'ları. Bir işlem panelinizden manuel olarak da açılabilir. Her kanal aynı yürütme yoluna ve aynı risk kontrollerine yönlendirilir.
Evet. TradingView, alarm gövdesi geçerli JSON değilse onu düz metin olarak gönderir ve varsayılan alarm mesajı yön bilgisi taşımadığı için reddedilir. Yukarıdaki webhook payload referansında belgelenen formatı kullanın veya görsel olarak oluşturup sonucu alarmınıza yapıştırın.
Evet — her kanalda aynı sunucu tarafı kontroller çalışır. Emir bir borsaya ulaşmadan önce risk politikanız, zorunlu stop-loss şartı ve pozisyon/drawdown limitleriniz uygulanır; emir bir AI asistanından, bir Telegram sinyalinden veya bir TradingView alarmından gelmiş olsun fark etmez. Hiçbir prompt veya mesaj bunları gevşetemez.
MCP geliştirici referansı, tüm 20 aracı, üç yetki kapsamını, OAuth 2.1 ve gizli bağlantı kimlik doğrulamasını, hız limitlerini, hata kodlarını ve desteklenen 16 borsa ile MetaTrader 5'i belgeler.
Evet. Her MCP bağlantısı, gerçek piyasa fiyatlarıyla $5,000 sanal paper bakiyesiyle başlar ve hem TradingView hem de Telegram otomasyonunda sinyalden emre tüm akışı simüle eden bir demo modu vardır. Canlı işlem her zaman ayrı ve açıkça oluşturulmuş bir anahtar veya bağlantı gerektirir.