TradingView Webhook Bot Kurulum Rehberi

TradingView'da tam da işleme girmek isteyeceğiniz anda tetiklenen bir uyarı kurdunuz. Sorun şu: uyarı sadece bir bildirimdir. Siz görüp emri verene kadar fiyat çoktan hareket etmiş olur, ya da uyuyordunuz ve fırsatı tamamen kaçırdınız.

Bir TradingView webhook botu bu boşluğu kapatır. Uyarı sizi bilgilendirmek yerine bir webhook URL'sini bilgilendirir: botunuza ait özel bir web adresi. Freya'nın sinyal botu bu adresi dinler ve uyarınız tetiklendiği an işlemi borsanızda otomatik olarak açar. Grafik mantığınız TradingView'da kalır, çalıştırma işini Freya üstlenir.

Bu rehber; kavramları, adım adım kurulumu ve bağlantıyı işiniz kritik olduğunda ayakta tutan güvenilirlik, güvenlik ve sorun giderme bilgilerini kapsar.

TradingView Uyarıları ve Webhook'lar Nasıl Çalışır?

Zinciri üç parça oluşturur.

Uyarı, bir TradingView grafiğinde tanımladığınız bir koşuldur: fiyatın bir seviyeyi geçmesi, bir göstergenin yön değiştirmesi, özel bir betiğin tetiklenmesi. Kendi başına ekranda belirebilir, size e-posta gönderebilir veya telefonunuza bildirim atabilir, ama bunların hepsi yine sizin harekete geçmenizi gerektirir.

Webhook, otomasyon seçeneğidir. Etkinleştirdiğinizde TradingView, uyarı tetiklendiği an seçtiğiniz bir URL'ye internet üzerinden küçük bir mesaj gönderir; uyarı size not bırakmak yerine telefon açar.

Bot, mesajı alan taraftır. Freya'nın sinyal botu özel bir webhook URL'si sunar; mesaj ulaştığında bot, bağlı borsa hesabınızda yapılandırıldığı işlemi gerçekleştirir.

Zincirin tamamı:

1. TradingView'da grafik koşulunuz doğru hale gelir
2. Uyarı tetiklenir ve TradingView botunuzun webhook URL'sini çağırır
3. Freya sinyali alır ve botunuz emri borsanızda verir
4. Ardından botunuz pozisyonu kendi ayarlarına göre yönetir

Temel zihinsel model şudur: stratejiniz TradingView'da yaşar; Freya çalıştırma katmanıdır. Zamanlama mantığı tamamen sizin uyarınızın içindedir.

Freya'nın Webhook Tetikleyicisi Ne Yapar?

Freya'da webhook çalıştırma işini sinyal botu üstlenir: bot oluşturma akışında "Webhook sinyallerine göre işlem yapın" olarak tanımlanan bot türü. Gösterge tabanlı bir tetikleyicinin (RSI, EMA vb.) aksine webhook tetikleyicisinin Freya içinde yapılandırılmış zaman dilimi veya koşulu yoktur. Ne zaman tetikleneceği kararı tamamen sizin TradingView uyarınıza aittir. Freya'nın işi bundan sonra ne olacağıdır.

İki webhook modu vardır ve bir bot ya birini ya diğerini kullanır, ikisi birlikte kullanılamaz:

• TradingView Webhook (Özel Sinyal modu). Botunuz iki URL alır: bir Açma Webhook URL'si ve bir Kapatma Webhook URL'si. Açma URL'sine gelen bir mesaj, Freya'da yapılandırdığınız emir ayarlarını kullanarak bir pozisyon açar: işlem tutarı ile kâr al ve zarar durdur seviyeleriniz. Kapatma URL'sine gelen bir mesaj ise pozisyonu kapatır.

• Risk Oranı modu. Botunuz tek bir URL alır. Uyarı mesajı, kâr al ve zarar durdur fiyatlarınızı taşıyan küçük bir JSON yüküdür; giriş, sinyal ulaştığında piyasadan alınır. Bir işlem tutarı belirlemek yerine sabit bir risk tutarı ayarlarsınız (zarar durdurmaya, isteğe bağlı olarak da kâr almaya sabitlenir) ve Freya, giriş ile stop arasındaki mesafeden pozisyonu otomatik boyutlandırır. Kapatma URL'si yoktur çünkü çıkışlar kendi kendini halleder: kâr al, sinyalinizdeki tam fiyattan bir limit emri olarak yerleştirilir, zarar durdur ise tetiklendiğinde bir piyasa emri olarak çalışır.

Adım Adım: TradingView'ı Botunuza Bağlayın

Adım 1: Sinyal Botu Oluşturun

Freya'nın Bot Oluştur akışında Sinyal Botu türünü seçin, ardından borsa hesabınızı, işlem çiftinizi ve yönü belirleyin: tıpkı diğer botlarda olduğu gibi. Freya Finance'te Nasıl Sinyal Botu Oluşturulur rehberindeki tam anlatım her ekranı ayrıntılı olarak ele alır.

Adım 2: Sinyal Modunuzu Seçin

İşlem tutarını, kâr al ve zarar durdur seviyelerini Freya içinde yapılandırmak ve uyarılarınızın yalnızca "şimdi aç" ve "şimdi kapat" demesini istiyorsanız Özel Sinyal modunu seçin. Stratejiniz işlem başına bir kâr al ve zarar durdur üretiyorsa ve boyutlandırmanın sabit bir risk tutarından otomatik yapılmasını istiyorsanız Risk Oranı modunu seçin.

Adım 3: Webhook URL'lerinizi Kopyalayın

Strateji adımında Freya webhook URL'lerinizi oluşturur. Kopyalama düğmesini kullanın; eksik tek bir karakter URL'yi işe yaramaz hale getirir. Herhangi bir URL'yi daha sonra yeniden oluşturabilirsiniz; bu, taze bir URL yaratır ve eskisini anında geçersiz kılar.

Adım 4: TradingView Uyarısını Oluşturun

TradingView grafiğinizde, girişinizi temsil eden koşulla bir uyarı oluşturun. Uyarının bildirim ayarlarında Webhook URL seçeneğini etkinleştirin ve botunuzun URL'sini yapıştırın: Özel Sinyal modunda Açma URL'si, Risk Oranı modunda ise tek URL. Özel Sinyal modunda uyarı tabanlı çıkışlar için, çıkış koşulunuza bir ikinci uyarı oluşturun ve onu Kapatma URL'sine yönlendirin.

Adım 5: Uyarı Mesajını Ayarlayın

Uyarı mesajı, TradingView'ın botunuza ilettiği yüktür. Botunuzun kurulum ekranının sağladığı formatı birebir kullanın: Risk Oranı modunda Freya, tek tıkla kopyalama düğmesi olan bir JSON Gövde Şablonu gösterir; uyarınız bu yapıyı, kâr al ve zarar durdur değerleriniz doldurulmuş halde göndermelidir. Doğaçlama yapmayın: mesaj botun beklediğiyle eşleşmezse sinyal tahmin edilmez, yok sayılır.

Adım 6: Canlıya Geçmeden Önce Test Edin

Bir webhook'u bağlayıp çekip gitmeyin. Küçük bir tutarla en az bir tam gidiş dönüş çalıştırın:

1. Hızla tetikleneceğini bildiğiniz bir uyarı koşulu ayarlayın (fiyatın az sonra dokunacağı bir seviyeyi geçmesi)
2. Tetiklenmesine izin verin, sonra botunuzun aktivite kaydından gelen sinyal olayını kontrol edin
3. Pozisyonun borsanızda beklediğiniz büyüklükle açıldığını doğrulayın
4. Kapatmayı tetikleyin (Kapatma URL'si sinyali veya Risk Oranı modunda kâr al/zarar durdur) ve pozisyonun gerçekten kapandığını doğrulayın

Ancak temiz bir gidiş dönüşten sonra gerçek stratejinizi ve gerçek büyüklüğünüzü bağlamalısınız.

Çalışılmış Bir Örnek: Risk Oranı Boyutlandırması

Diyelim ki işlem başına 20$ sabit risk belirlediniz ve bunu zarar durdurmaya sabitlediniz. TradingView uyarınız BTC 100.000$'dayken tetikleniyor ve mesajında 98.000$ zarar durdur ile 104.000$ kâr al taşıyor.

• Giriş: piyasa, 100.000$'dan gerçekleşti
• Zarar durdurmaya mesafe: BTC başına 2.000$ (%2)
• Pozisyon büyüklüğü: 20$ risk ÷ BTC başına 2.000$ = 0,01 BTC (yaklaşık 1.000$'lık maruziyet)
• Kâr al: 104.000$'da limit emri. Gerçekleşirse kâr 0,01 × 4.000$ = 40$, riske ettiğiniz 20$ için 2:1 getiri
• Zarar durdur: 98.000$ tetiklenirse piyasa emri. Kabaca seçtiğiniz 20$, artı ücretler ve hızlı bir harekette biraz daha fazlası olabilir çünkü tetiklenen bir stop piyasadan gerçekleşir

Stop'unuz ister %1 ister %5 uzakta olsun, riske edilen dolar tutarı 20$ olarak kalır çünkü büyüklük ayarlanır. Bu tutarlılık, Risk Oranı modunun bütün amacıdır.

Güvenilirlik: Neye Güvenebilir, Neye Güvenemezsiniz?

Otomasyon ancak en zayıf halkası kadar güvenilirdir ve webhook botlarında bu halka genellikle Freya'nın dışındadır.

TradingView plan gereksinimleri. Webhook bildirimleri her TradingView planına dahil değildir ve uyarı limitleri ile sona erme süreleri de kademeye göre değişir. Webhook gönderemeyen bir uyarı, botun bakış açısından sessizce başarısız olur. Kurulumunuzu uyarılar üzerine inşa etmeden önce planınızın uyarı seçeneklerini kontrol edin.

Gecikmeler ve kesintiler olur. Freya'nın pazaryeri, webhook tabanlı stratejileri harici sinyal uyarısıyla etiketler: işlemler TradingView veya webhook sinyalleriyle tetiklenir ve kaynaktaki gecikmeler veya kesintiler mümkündür. TradingView'da bir sorun yaşanırsa uyarınız hiç tetiklenmez ve bot, doğru şekilde, hiçbir şey yapmaz. Freya kendisine ulaşanı çalıştırır; hiç ulaşmayanı çalıştıramaz.

Kaçırılan kapatma sinyalleri en keskin kenardır. Özel Sinyal modunda açma sinyaliniz gelir ama kapatma sinyaliniz hiç gelmezse pozisyon açık kalır. Botunuzun emir ayarlarında yapılandırılmış bir zarar durdur, ikinci bir webhook'un gelmesine bağlı olmayan bir emniyet ağıdır ve çoğu kurulumda bulundurmaya değer.

Tek seferlik uyarılar tetiklenmeyi durdurur. "Yalnızca Bir Kez" tetiklenecek şekilde ayarlanmış bir TradingView uyarısı, siz onu yeniden oluşturana kadar tek sinyalden sonra biter. Tekrar eden bir strateji için tekrarlayan bir tetikleme seçeneği belirleyin ve uyarının sona erme tarihini kontrol edin.

Güvenlik: Webhook URL'niz Bir Sırdır

Bir webhook URL'si, botunuzu tetiklemenin anahtarıdır. Üzerinde ayrıca bir parola yoktur; URL'ye sahip olmanın kendisi kimlik bilgisidir:

• Bir webhook URL'sini asla paylaşmayın veya yayınlamayın: uyarı ayarlarının ekran görüntüsünde, paylaşılan bir grafik düzeninde veya yardım istediğiniz bir sohbet mesajında bile. Önce bulanıklaştırın ya da kırpın.
• Yalnızca kontrol ettiğiniz araçlara yapıştırın, kendi TradingView uyarılarınız gibi.
• Bir sızıntıdan şüphelenirseniz hemen yeniden oluşturun: eski URL anında çalışmayı durdurur. Ardından uyarılarınızı taze URL ile güncelleyin.

Sorun Giderme: Uyarı Tetiklendi Ama Hiçbir İşlem Olmadı

Neden neredeyse her zaman kısa bir listeden biridir; sırayla üzerinden geçin:

1. Bot çalışıyor mu? Duraklatılmış veya durdurulmuş bir bot gelen sinyalleri yok sayar: en sık görülen suçlu.
2. Doğru URL, doğru yuva mı? Kapatma URL'sine yönlendirilmiş bir giriş uyarısı asla pozisyon açmaz. Açma ve Kapatma ayrımını doğrulayın ve URL'nin eksiksiz yapıştırıldığını teyit edin.
3. Son zamanlarda yeniden oluşturdunuz mu? Yeniden oluşturmak eski URL'yi anında geçersiz kılar. Uyarınız hâlâ eskisini tutuyorsa mesajları hiçbir yere gitmez.
4. Mesaj formatı eşleşiyor mu? Özellikle Risk Oranı modunda mesaj, botunuzun kurulum ekranındaki JSON yapısıyla eşleşmelidir. Hatalı biçimli bir mesaj yok sayılır.
5. TradingView planınız webhook gönderebiliyor mu? Gönderemiyorsa uyarı görsel olarak tetiklenir ama mesaj gönderilmez. Ayrıca uyarının sona erip ermediğini ya da "Yalnızca Bir Kez" olarak ayarlanıp ayarlanmadığını kontrol edin.
6. Borsa minimumları. Yapılandırdığınız tutar (ya da otomatik hesaplanan Risk Oranı büyüklüğü) çiftin minimum emir büyüklüğünün altına düşerse borsa emri reddeder.

Webhook'ların ötesindeki bot durumu sorunları için bkz. Botum Neden İşlem Yapmıyor?

Sıkça Sorulan Sorular

Webhook botları kullanmak için ücretli bir TradingView planına ihtiyacım var mı?

Sinyal kaynağınız TradingView ise plan kademesi önemlidir: webhook bildirimleri her planın parçası değildir ve ücretsiz kademe uyarılarının limitleri ile sona erme kuralları daha sıkıdır. Otomasyonunuzu uyarılar üzerine inşa etmeden önce TradingView'ın plan karşılaştırmasını açın ve webhook bildirimlerinin sizinkine dahil olduğunu doğrulayın; birden fazla çift çalıştırıyorsanız uyarı kotanızı da kontrol edin. Bununla birlikte bot tarafı, mesajı kimin gönderdiğiyle ilgilenmez. Freya'nın sinyal botu herhangi bir kaynaktan gelen webhook çağrılarına yanıt verir: farklı bir grafik platformu, kendi betiğiniz veya webhook gönderebilen herhangi bir araç. Yani ücretli bir TradingView planı, Freya'nın değil, TradingView'ın webhook özelliğinin bir gereksinimidir. Planınız webhook içermiyorsa alternatifleriniz; yükseltmek, sinyal kaynağını değiştirmek ya da harici sinyaller yerine gösterge tabanlı tetikleyicilerle mantığı Freya içinde kurmaktır.

Açma ve Kapatma webhook URL'leri arasındaki fark nedir?

Özel Sinyal modunda botunuz, iki farklı işi olan iki ayrı URL sunar. Açma Webhook URL'sine gelen bir mesaj, Freya'da yapılandırdığınız emir ayarlarını kullanarak bir pozisyon açar: işlem tutarı, artı belirlediğiniz kâr al ve zarar durdur. Kapatma Webhook URL'sine gelen bir mesaj, botun açık olan pozisyonunu kapatır. Bunlar birbirinin yerine kullanılamaz: Kapatma URL'sine yönlendirilmiş bir giriş uyarısı asla işlem açmaz. Risk Oranı modu farklı çalışır: yalnızca bir URL vardır, giriş sinyali için kullanılır ve Kapatma URL'si yoktur çünkü çıkış, webhook mesajında taşınan kâr al ve zarar durdur tarafından otomatik yönetilir. Her iki URL de bağımsız olarak kopyalanıp yeniden oluşturulabilir; yeniden oluşturmak taze bir URL yaratır ve eskisini anında geçersiz kılar, bu yüzden ilgili TradingView uyarısını sonrasında güncelleyin.

TradingView uyarım kâr al ve zarar durdur seviyelerini belirleyebilir mi?

Evet, Risk Oranı modu tam da bunun içindir. Bu modda uyarı mesajınız, kâr al ve zarar durdur fiyatlarını taşıyan küçük bir JSON yüküdür ve Freya'nın kurulum ekranı, uyarınıza kopyalamanız için JSON Gövde Şablonunu sunar. Sinyal ulaştığında giriş piyasa fiyatından alınır ve çıkışlar sinyalinizin değerlerinden yerleştirilir: kâr al, gönderdiğiniz tam fiyattan bir limit emri olarak, zarar durdur ise tetikleme fiyatına ulaşıldığında bir piyasa emri olarak. Stop piyasadan gerçekleştiği için hızlı bir harekette kayma yaşayabilir, tıpkı her stop emri gibi. Özel Sinyal modunda webhook çıkış seviyelerini belirleyemez; kâr al ve zarar durdur, Freya içinde yapılandırdığınız emir ayarlarından gelir ve uyarılarınız yalnızca ne zaman açılacağını ve ne zaman kapatılacağını söylemekle sınırlıdır.

Webhook URL'mi TradingView'a yapıştırmak güvenli mi?

URL'yi kendi TradingView uyarınıza yapıştırmak, amaçlanan kullanımdır: entegrasyonun tasarlandığı gibi çalışmasıdır. Asıl risk, yapıştırmanın kendisi değil, açığa çıkmasıdır. Bir webhook URL'sinin üzerinde parola yoktur: URL'yi elinde tutan botunuzda o işlemi tetikleyebilir. Yaygın sızıntı yolları sıradandır: sohbette paylaşılan bir uyarı ayarları ekran görüntüsü, yardım isteyen açık bir gönderi ya da paylaşılan bir grafik düzeni. Her URL'ye parola gibi davranın: ekran görüntülerinden uzak tutun, kimseyle paylaşmayın ve yalnızca bizzat kontrol ettiğiniz araçlara yapıştırın. Bir URL'nin başkası tarafından görülmüş olabileceğinden şüphelenirseniz hemen yeniden oluşturun: yeni URL yaratıldığı an eski URL çalışmayı durdurur. Sonra bir sonraki sinyaliniz tetiklenmeden önce uyarınızı yenisiyle güncelleyin.

Uyarım tetiklendi ama neden işlem olmadı?

Botun kendisiyle başlayın: duraklatılmış veya durdurulmuş bir bot sinyalleri tamamen yok sayar, en sık görülen neden budur. Sonra tesisatı doğrulayın: uyarı, doğru ve eksiksiz URL'yi tutmalıdır (girişler için Açma, Kapatma değil) ve son zamanlarda yeniden oluşturduysanız uyarı hâlâ ölü olana işaret ediyor olabilir. Ardından mesajı kontrol edin: özellikle Risk Oranı modunda yük, botunuzun kurulum ekranındaki JSON şablonuyla eşleşmelidir, yoksa sinyal yok sayılır. TradingView tarafında planınızın gerçekten webhook gönderdiğini ve uyarının sona ermediğini veya tek seferlik "Yalnızca Bir Kez" atışını yapmadığını doğrulayın. Son olarak tutarınız (ya da otomatik hesaplanan Risk Oranı büyüklüğü) çift için borsanın minimumunun altındaysa emir reddedilir. Botunuzun aktivite kaydı hangi tarafın başarısız olduğunu söyler: kaydedilmiş bir sinyal çalıştırma sorununu, hiç kayıt olmaması sinyalin hiç ulaşmadığını gösterir.

Sinyallerimin TradingView'dan gelmesi zorunlu mu?

Hayır. TradingView en popüler kaynaktır çünkü uyarı sistemi esnek ve grafik odaklıdır, ama Freya'nın sinyal botu kaynağı ne olursa olsun webhook çağrılarına yanıt verir. Webhook gönderebilen her araç işe yarar: başka bir grafik platformu, özel bir betik, webhook bildirimli bir tarayıcı ya da kurum içi bir sinyal sistemi. Sözleşme her durumda aynıdır: Özel Sinyal modunda Açma veya Kapatma URL'sini çağırın, Risk Oranı modunda ise kâr al ve zarar durdur değerlerini taşıyan beklenen JSON yükünü tek URL'ye gönderin. Her kaynak için iki uyarı geçerlidir. Birincisi, güvenilirlik sorusu ortadan kalkmaz: botunuz yalnızca gerçekten ulaşan sinyalleri çalıştırabilir, bu yüzden kaynağınızın çalışma süresi stratejinizin çalışma süresidir. İkincisi, güvenlik kuralı evrenseldir: hangi aracı kullanırsanız kullanın, webhook URL'si yalnızca kontrol ettiğiniz ve güvendiğiniz sistemlere girer.

Sırada Nereye Gitmeli?

Bir webhook botu, onu besleyen strateji kadar iyidir. Sinyal mantığınızı geçmişe karşı sınamak için Kripto İşlem Stratejinizi Nasıl Geriye Dönük Test Edersiniz rehberini okuyun ve herhangi bir kurulum ayrıntısını atladıysanız Freya Finance'te Nasıl Sinyal Botu Oluşturulur rehberindeki tam anlatıma göz atın. Giriş mantığını bunun yerine Freya içinde kurmayı tercih ederseniz, DCA Bot Strateji Rehberi bu yaklaşımı derinlemesine ele alır. Saklama ve API anahtarı izinleriyle ilgili sorular için ise bkz. Param Freya Finance'te Güvende mi?