Kısa cevap: TradingView webhook, bir alarm tetiklendiğinde alarm mesajının belirlenen bir internet adresine HTTP POST isteğiyle gönderilmesidir. Bu adresi dinleyen bir köprü servisi mesajı doğrulayıp borsa API'si üzerinden emre dönüştürür; TradingView emri doğrudan borsaya göndermez.
Webhook, bir olay gerçekleştiğinde bir sistemin başka bir sisteme otomatik olarak HTTP isteği göndermesidir. TradingView'da bir alarm tetiklendiğinde alarmın mesajı, belirlenen bir internet adresine (webhook URL) POST isteği olarak gönderilir. Bu adresi dinleyen bir servis mesajı okuyup borsa API'si üzerinden emre dönüştürdüğünde, grafikte görülen sinyal ile borsadaki işlem arasındaki manuel adım ortadan kalkar.
Akış nasıl işler?
- Alarm koşulu: Bir indikatörde veya Pine Script stratejisinde tanımlı koşul gerçekleşir.
- Webhook isteği: TradingView, alarm mesajını belirlenen adrese gönderir.
- Köprü servisi: Mesajı alan servis isteğin doğruluğunu kontrol eder, mesajı çözümler ve risk kurallarını uygular.
- Borsa API'si: Kontroller geçilirse emir borsaya iletilir; sonuç kaydedilir ve bildirilir.
TradingView emri doğrudan borsaya göndermez. Aradaki köprü servisi, kullanıcının ya da hizmet aldığı tarafın sunucusunda çalışır.
Alarm mesajı ve JSON şablonu
Köprü servisinin mesajı güvenle okuyabilmesi için alarm mesajı genellikle JSON biçiminde yazılır. TradingView mesaj içinde yer tutucular kullanılmasına izin verir; alarm tetiklendiğinde bu alanlar o anki değerlerle doldurulur.
{
"secret": "gizli-anahtar",
"symbol": "{{ticker}}",
"side": "{{strategy.order.action}}",
"price": "{{close}}"
}Bu örnekte {{ticker}} sembolü, {{close}} alarm anındaki kapanış fiyatını, {{strategy.order.action}} ise strateji alarmlarında "buy" veya "sell" değerini verir. Mesajın biçimi, köprü servisinin beklediği şablonla birebir uyumlu olmalıdır.
Güvenlik önlemleri
- Gizli anahtar: Webhook adresi herkese açık bir adrestir. Mesaja eklenen ve yalnızca kullanıcının bildiği gizli bir değer, sahte isteklerin ayırt edilmesini sağlar.
- Kaynak IP kontrolü: TradingView webhook isteklerini, yardım sayfasında yayımladığı dört IP adresinden gönderir. Sunucunun yalnızca bu adreslerden gelen istekleri kabul etmesi ek bir koruma katmanıdır.
- API anahtarı yetkileri: Köprü servisinin kullandığı borsa API anahtarında yalnızca okuma ve işlem yetkisi açık olmalı, para çekme yetkisi kapalı tutulmalıdır. Borsa destekliyorsa anahtar, köprü sunucusunun IP adresiyle sınırlandırılmalıdır.
- Tekrarlanan alarmlar: Aynı alarmın kısa sürede birden fazla gelmesi mükerrer emre yol açabilir; servis aynı sinyali ikinci kez işlememelidir.
Teknik sınırlar
- TradingView webhook isteklerini yalnızca 80 ve 443 numaralı portlara gönderir; IPv6 adresleri desteklenmez.
- Sunucu isteği üç saniye içinde yanıtlamazsa istek iptal edilir. Bu yüzden servis isteği hemen kabul edip borsa işlemini arka planda yürütmelidir.
- Webhook istekleri zaman zaman hedefe ulaşmayabilir. TradingView'ın alarm günlüğündeki webhook durumu ve köprü servisinin kendi kayıtları düzenli kontrol edilmelidir.
- Webhook özelliği ücretli TradingView planlarında sunulur. Güncel plan koşulları ve hesap güvenliği gereklilikleri TradingView'ın yardım sayfalarından kontrol edilmelidir.
Webhook mi, doğrudan borsa API'si mi?
Alarm ile emir arasında birkaç saniyelik gecikme oluşabilir. Saatlik veya günlük grafiklerde çalışan stratejilerde bu gecikme çoğunlukla önemsizdir; saniyeler içinde karar veren stratejilerde ise sorun yaratır. Bu tür stratejiler için piyasa verisini doğrudan borsa API'sinden alan bir algoritmik işlem sistemi daha uygundur. İki yöntemde de stratejinin önce backtest ile sınanması gerekir.
Otomasyon emirleri hızlandırır ama riski ortadan kaldırmaz: hatalı bir alarm koşulu ya da yanlış ayarlanmış miktar, aynı hızla gerçek emre dönüşür. Bu nedenle sistem canlıya geçmeden önce küçük tutarlarla veya borsanın test ortamında denenmelidir.
Sık sorulan sorular
TradingView webhook ücretsiz mi?
Webhook özelliği ücretli TradingView planlarında sunulur. Güncel plan koşulları TradingView'ın yardım sayfalarından kontrol edilmelidir.
TradingView doğrudan borsaya emir gönderir mi?
Hayır. TradingView yalnızca alarm mesajını webhook adresine iletir. Emri borsaya gönderen, kullanıcının ya da hizmet aldığı tarafın sunucusunda çalışan köprü servisidir.
Webhook alarm mesajı nasıl yazılır?
Genellikle JSON biçiminde yazılır; ticker, close ve strategy.order.action gibi yer tutucular alarm anındaki değerlerle doldurulur. Mesaj, köprü servisinin beklediği şablonla birebir uyumlu olmalı ve yalnızca kullanıcının bildiği bir gizli anahtar içermelidir.
Webhook ile emir arasında gecikme olur mu?
Birkaç saniyelik gecikme oluşabilir. Saatlik ve günlük grafiklerde çalışan stratejilerde bu çoğunlukla önemsizdir; saniyeler içinde karar veren stratejilerde piyasa verisini doğrudan borsa API'sinden alan bir sistem daha uygundur.
Kaynaklar
Bu yazı genel bilgilendirme amaçlıdır ve yatırım tavsiyesi niteliği taşımaz. Örneklerdeki rakamlar varsayımsaldır; belirli bir fon veya hisse için öneri değildir.