İçeriğe geç

TradingView webhook ile Binance'e otomatik emir nasıl gönderilir?

Hasan Çelik Yayın: Güncelleme: Otomasyon & Sistemler 6 dakika okuma

TradingView alarmı, webhook URL'sine JSON gönderir; küçük bir sunucu bu isteği doğrular ve Binance API'sine emir olarak iletir. Kurulum dört parçadır: alarm mesajı şablonu, gizli parola (passphrase) ile doğrulanan webhook, emir gönderen kod ve çekim yetkisi kapalı API anahtarı. Bu yazı akışı Testnet üzerinde adım adım kurar; önce güvenlik kutusunu okumadan gerçek hesaba bağlamayın.

Webhook nedir, TradingView alarmı nasıl çalışır?

Webhook, bir uygulamada belirli bir olay gerçekleştiğinde önceden tanımlanmış bir URL adresine HTTP POST isteği gönderen otomatik bildirim mekanizmasıdır. TradingView alarmlarında webhook desteği sayesinde grafikteki fiyat bir seviyeye dokunduğunda veya bir indikatör koşulu sağlandığında platform, belirttiğiniz sunucu adresine özel bir JSON yükü iletir. Bu mekanizma, ekran başında beklemeden strateji kurallarının anlık tetiklenmesini sağlar ve grafik analizini yürütme katmanına bağlar.

2000 yılından bu yana yazılımda mimari kararlar alıyorum, 2019’dan bu yana day trading yapıyorum. Bu iki disiplinin kesiştiği Otomasyon & Sistemler alanında en sık gördüğüm hata, analizi yapan katman ile emri ileten katmanın birbirine kontrolsüzce bağlanmasıdır. TradingView doğrudan borsalara özel emir yönlendiremez; arada mutlaka istekleri doğrulayan, hataları yakalayan ve yetkilendirmeyi denetleyen bağımsız bir ara sunucu bulunmalıdır.

Çalışma akışı şu adımlarla ilerler:

  1. Grafikteki analiz koşulu (örneğin fiyatın belirli bir seviyeyi kırması veya geçersizlik eşiğine ulaşması) sağlanır.
  2. TradingView sunucusu, alarm ayarlarında tanımladığınız webhook URL’sine JSON formatında bir HTTP POST isteği atar.
  3. Ara sunucunuz (örneğin bir Cloudflare Worker veya Node.js servisi) gelen isteği karşılar, gizli anahtarı doğrular.
  4. İstek geçerliyse, ara sunucu Binance API formatına uygun imzalı bir istek oluşturarak emri borsaya iletir.

Alarm mesajı JSON şablonu nasıl yazılır?

TradingView alarm mesajında gönderilen JSON şablonu; sembolü, işlem yönünü, emir tipini ve doğrulama parolasını içeren sade bir veri yapısı olmalıdır. TradingView dinamik değişkenlerini (örneğin {{ticker}} veya {{close}}) kullanarak esnek mesajlar oluşturabilirsiniz. Şablondaki her alanın sunucu tarafında katı bir şema ile doğrulanması gerekir; gereksiz alanlar eklemekten kaçınılmalı ve tüm değerler açık, net tiplerle ifade edilmelidir.

İşte Testnet üzerinde çalışan güvenli ve sade bir JSON alarm mesajı örneği:

{
  "passphrase": "{{secret_key_buraya}}",
  "symbol": "BTCUSDT",
  "action": "BUY",
  "type": "LIMIT",
  "price": "{{close}}",
  "quantity": "0.001",
  "strategy": "breakout_test"
}

Bu şablonu kurgularken dikkat edilmesi gereken detaylar:

  • Gizli anahtar (passphrase): URL herkese açık olsa bile, gelen paketin içinde sadece sizin bildiğiniz bir parolanın yer alması gerekir.
  • Dinamik alanlar: Fiyat için {{close}} kullanıyorsanız, TradingView alarmın tetiklendiği andaki kapanış fiyatını metne otomatik olarak yerleştirir.
  • Format disiplini: JSON sentaksındaki tek bir virgül veya tırnak hatası sunucunun isteği ayrıştıramamasına (JSON.parse hatası) yol açar. Alarmı kurmadan önce JSON geçerliliğini mutlaka kontrol edin.

İsteği kim doğrular: gizli parola ve IP listesi

TradingView webhook isteklerinde kriptografik bir HMAC başlığı göndermez; aktarım bütünlüğü HTTPS katmanından gelir, isteğin gerçekten sizin alarmınızdan çıktığını doğrulamak içinse ara sunucuda iki kontrol birlikte uygulanır: TradingView’in yayımladığı dört kaynak IP adresinden oluşan izin listesi ve gövdedeki gizli parola. Herkese açık bir webhook adresine gelen her istek meşru sayılmaz; sunucu hem kaynak IP adresini hem de parolayı doğrulamadan Binance API’sine hiçbir istek iletmez.

Aşağıda TypeScript ile yazılmış minimal bir doğrulama ve yönlendirme mantığı yer almaktadır:

// Webhook doğrulama katmanı (Node.js 18+; Cloudflare Workers'ta nodejs_compat bayrağı gerekir)
import crypto from 'node:crypto';
import { sendTestnetOrder } from './binance';

const TRADINGVIEW_IPS = new Set([
  '52.89.214.238',
  '34.212.75.30',
  '54.218.53.128',
  '52.32.178.7',
]);

interface WebhookPayload {
  passphrase: string;
  symbol: string;
  action: 'BUY' | 'SELL';
  type: string;
  price: string;
  quantity: string;
}

interface Env {
  WEBHOOK_PASSPHRASE: string;
  BINANCE_TESTNET_API_KEY: string;
  BINANCE_TESTNET_API_SECRET: string;
}

export async function handleWebhook(request: Request, env: Env): Promise<Response> {
  if (request.method !== 'POST') {
    return new Response('Method Not Allowed', { status: 405 });
  }

  // 1. Kaynak IP izin listesi kontrolü (Cloudflare arkasında CF-Connecting-IP)
  const clientIp = request.headers.get('CF-Connecting-IP') ?? '';
  if (!TRADINGVIEW_IPS.has(clientIp)) {
    return new Response('Forbidden: Yetkisiz kaynak IP', { status: 403 });
  }

  let data: WebhookPayload;
  try {
    data = await request.json();
  } catch {
    return new Response('Bad Request: Hatalı JSON', { status: 400 });
  }

  // 2. Gizli parola kontrolü: önce uzunluk, sonra sabit zamanlı kıyaslama
  const gelen = Buffer.from(String(data.passphrase ?? ''));
  const beklenen = Buffer.from(env.WEBHOOK_PASSPHRASE);
  if (gelen.length !== beklenen.length || !crypto.timingSafeEqual(gelen, beklenen)) {
    return new Response('Unauthorized: Geçersiz parola', { status: 401 });
  }

  // 3. Doğrulandı: emri Binance Testnet'e ilet
  const sonuc = await sendTestnetOrder(
    { symbol: data.symbol, side: data.action, quantity: data.quantity, price: data.price },
    env.BINANCE_TESTNET_API_KEY,
    env.BINANCE_TESTNET_API_SECRET
  );
  return new Response(JSON.stringify(sonuc), { status: 200 });
}

Kodda timingSafeEqual kullanılması, parola karşılaştırmalarında milisaniyelik zamanlama farklarından kaynaklanabilecek sızıntıları önler; bu fonksiyon farklı uzunluktaki girdide hata fırlattığı için uzunluk önce kontrol edilir. Güvenlik, kodun her satırında bir refleks olmalıdır.

Binance Testnet’e emir nasıl gönderilir?

Binance Testnet’e emir göndermek, ara sunucunun doğrulanmış webhook verisini Binance REST API standartlarına dönüştürüp imzalı bir POST isteği yapmasıyla gerçekleşir. İstek; API anahtarı, zaman damgası ve gizli anahtarla oluşturulan HMAC-SHA256 imzasını taşımalıdır. Spot Testnet ortamının fiyatları ve emir defteri canlı piyasadan bağımsızdır; bu yüzden Testnet strateji kârlılığını değil, gerçek fonları riske atmadan imza üretimini, ağ gecikmelerini, emir türlerini ve hata senaryolarını denemek için kullanılır (canlı fiyat yansıması gerektiğinde Binance Demo Mode tercih edilir).

Binance API’si her istek için bir timestamp ve bu parametrelerin API Secret ile imzalanmış halini (signature) bekler:

// binance.ts — minimal Binance Spot Testnet emir gönderme (alıcıyla aynı çalışma zamanı)
import crypto from 'node:crypto';

const BASE_URL = 'https://testnet.binance.vision';

interface OrderInput {
  symbol: string;
  side: 'BUY' | 'SELL';
  quantity: string;
  price: string;
}

export async function sendTestnetOrder(order: OrderInput, apiKey: string, apiSecret: string): Promise<unknown> {
  const params = new URLSearchParams({
    symbol: order.symbol,
    side: order.side,
    type: 'LIMIT',
    timeInForce: 'GTC',
    quantity: order.quantity,
    price: order.price,
    timestamp: String(Date.now()),
  });

  const signature = crypto.createHmac('sha256', apiSecret).update(params.toString()).digest('hex');
  params.append('signature', signature);

  const response = await fetch(`${BASE_URL}/api/v3/order?${params.toString()}`, {
    method: 'POST',
    headers: { 'X-MBX-APIKEY': apiKey },
  });
  return response.json();
}

Bu kodu çalıştırırken API anahtarlarınızı asla dosya içerisine sabit olarak yazmayın. .env dosyası ve ortam değişkenleri kullanmak temel kuraldır.

Güvenlik kutusu: gerçek hesaba geçmeden önce hangi 7 kural?

Gerçek hesaba geçmeden önce uygulanması zorunlu 7 güvenlik kuralı; API çekim yetkisinin kapatılması, IP kısıtlaması, gizli anahtarların ortam değişkenlerinde saklanması, Testnet provası, minimum büyüklükle başlama, hata yakalama mekanizması ve manuel iptal hazırlığıdır. Bu kurallardan tek birinin bile ihmal edilmesi, otomasyon hatası veya yetkisiz erişim durumunda telafisi güç kayıplara yol açabilir.

Otomasyon & Sistemler yaklaşımında temel ilke nettir: otomasyon hız kazandırır ancak yetki sınırı ve acil durdurma kontrolü her zaman mühendiste kalır. Webhook alıcısının arkasına modüler bir risk filtresi ve yerel kayıt katmanı eklemek için Python ile Binance trading botu mimarisini inceleyebilirsiniz.

Kaynaklar

Anahtar çıkarımlar

  • Gövdedeki gizli parola doğrulanmadan hiçbir emir gönderilmez.
  • API anahtarında çekim yetkisi her zaman kapalıdır.
  • Önce Testnet, sonra küçük büyüklük, sonra gerçek hesap.

Sık sorulan sorular

Webhook için sunucu kiralamak gerekir mi?

Hayır. Cloudflare Workers gibi ücretsiz bir uç nokta ilk aşama için yeterlidir; istek hacmi düşüktür ve gizli anahtar ortam değişkeninde tutulur. Kendi sunucunuz varsa da aynı kod çalışır; önemli olan HTTPS ve parola doğrulamasıdır.

İş Birliği & Danışmanlık Açık kaynak projeler

Yasal uyarı

Bu sitede yer alan bilgi, yorum ve analizler yatırım danışmanlığı kapsamında değildir. Yatırım danışmanlığı hizmeti, yetkili kuruluşlar tarafından kişilerin risk ve getiri tercihleri dikkate alınarak kişiye özel sunulmaktadır. Burada yer alan içerik genel niteliktedir ve kişisel durumunuza uygun olmayabilir.

Analiz kayıtları, yayınlanmış bir senaryo analizini ve piyasanın o senaryoya verdiği yanıtı belgeler; hesap hareketi veya kişisel işlem beyanı değildir. Bir kayıt, analizin belirli bir tarihte yayınlandığını gösterir; geçmiş kayıtlar gelecekteki sonuçların göstergesi değildir. Kripto varlıklar yüksek fiyat oynaklığı taşır ve yatırılan tutarın tamamı kaybedilebilir.

Bu sitedeki hiçbir içerik alım, satım veya elde tutma çağrısı değildir. Yalnızca kendi araştırmanıza dayanarak ve gerekiyorsa yetkili bir danışmandan görüş alarak karar veriniz. Site sahibi, içeriğe dayanarak alınan kararlardan doğan sonuçlardan sorumlu değildir.

Yasal uyarının tamamı · metin sürümü 2026-09-28-v5