Binance Vadeli İşlemler bir sorunu iki katmanda bildirir: hatanın türünü söyleyen bir HTTP durum kodu (400, 403, 418, 429 veya 503 gibi) ve tam olarak neyin yanlış olduğunu söyleyen bir Binance kodu (-2019 gibi negatif bir sayı). Bu sayfa, USDⓈ-M Vadeli İşlemlerde trader'ların ve botların en sık karşılaştığı kodları gruplar; her biri için Binance'in kendi ifadesini, çözümünü ve yeniden denemenin işe yarayıp yaramayacağını verir, sık görülenler için de ayrıntılı rehberlerimize bağlantı içerir.
Binance hatası nasıl okunur
HTTP durum kodu, sorunun kimin tarafında olduğunu söyler. Binance'in API dokümantasyonuna göre 4XX kodları "hatalı biçimlendirilmiş istekler için kullanılır; sorun gönderen taraftadır", 5XX kodları ise "dahili hatalar için kullanılır; sorun Binance tarafındadır". Bir 4XX yanıtında JSON gövdesi bir code ve bir msg taşır, örneğin {"code": -2019, "msg": "Margin is insufficient."}.
En çok parayı koruyan tek kural şu: reddedilen bir emir hiçbir şeyi değiştirmez. Yeniden denemeden önce, emrin başarılı olması için neyin değişmesi gerektiğini sorun. Hiçbir şey değişmediyse yeniden deneme de aynı şekilde başarısız olur.
Bağlantı, istek limitleri ve HTTP durum kodları
| Durum kodu veya hata kodu | Binance'in ifadesi | Ne yapmalı |
|---|---|---|
| HTTP 403 | "Web Application Firewall limit violated" | Yavaşlayın ve isteği kontrol edin; uç noktaya art arda yüklenmeyin |
| HTTP 408 | "Timeout waiting for the backend" | İstek işlenmiş de olabilir, işlenmemiş de: yeniden göndermeden önce emri sorgulayın |
| HTTP 429 / -1003 | "Request rate limit broken"; "Too many requests" | Geri çekilin; sürekli sorgulamak (polling) yerine websocket akışlarını kullanın |
| HTTP 418 | "IP auto-banned for continuing after 429" | Yasak bitene kadar tüm istekleri durdurun |
| HTTP 503 "Unknown error" | "Sent, but no response in time" | İşlem durumu bilinmiyor: yeniden denemeden önce kontrol edin |
| HTTP 503 "Service Unavailable" / "Internal error" | "A failed operation" | Daha sonra yeniden deneyin |
Binance'in dokümantasyonu ilk 503 türü konusunda açık: "Bunu başarısız bir işlem olarak DEĞERLENDİRMEMEK önemlidir; işlem durumu BİLİNMİYOR ve başarılı olmuş olabilir." Bu yanıttan sonra körü körüne yeniden gönderen bir bot aynı pozisyonu iki kez açabilir. Deterministik bir client order ID kullanın, emri bu ID ile sorgulayın ve yalnızca emir yoksa yeniden gönderin.
İstek ağırlıkları ve bunların altında nasıl kalınacağı, ticaret botlarını bozan Binance API istek limitleri üzerine hazırladığımız rehberde anlatılıyor.
Zaman damgaları, imzalar ve API anahtarları
| Kod | Binance'in ifadesi | Ne yapmalı |
|---|---|---|
| -1021 | "Timestamp for this request is outside of the recvWindow" | Saatinizi Binance sunucu saatiyle senkronize edin; recvWindow varsayılan olarak 5.000 ms'dir |
| -1022 | "Signature for this request is not valid" | Gizli anahtar (secret) yanlış ya da parametreler imzaladığınızdan farklı kodlanmış veya sıralanmış |
| -2014 | "API-key format invalid" | Anahtar eksik ya da fazladan karakterle yapıştırılmış |
| -2015 | "Invalid API-key, IP, or permissions for action" | Anahtarın var olduğunu, IP beyaz listesini ve vadeli işlem izninin açık olduğunu kontrol edin |
-1021 neredeyse her zaman Binance'ten değil, isteği gönderen makinedeki kayan bir saatten kaynaklanır; daha büyük bir recvWindow sorunu gizler ama düzeltmez.
-2015 tek bir mesajın arkasında üç farklı neden barındırır; Binance'te geçersiz API anahtarı, IP veya izin hatası üzerine hazırladığımız rehber bunları tek tek ele alıyor.
Emir kuralları: hassasiyet, büyüklük ve fiyat
| Kod | Binance'in ifadesi | Ne yapmalı |
|---|---|---|
| -1111 | "Precision is over the maximum defined for this asset" | Miktarı sembolün adım büyüklüğüne yuvarlayın |
| -4003 | "Quantity less than zero" | Bir boyutlandırma hatası sıfır ya da negatif miktar üretmiş |
| -4014 | "Price not increased by tick size" | Fiyatı sembolün tick büyüklüğüne yuvarlayın |
| -4164 | "Order's notional must be no smaller than 5.0 (unless you choose reduce only)" | Emrin değerini artırın; reduce-only emirler muaftır |
| -4131 | "The counterparty's best price does not meet the PERCENT_PRICE filter limit" | Sığ bir emir defterine piyasa emri gönderilmiş; bekleyin ya da limit emir kullanın |
| -2020 | "Unable to fill" | Hemen dolması gereken bir emir (fill-or-kill gibi) kendi fiyatında karşılık bulamadı |
| -2025 | "Reach max open order limit" | Yeni emir eklemeden önce eskimiş emirleri iptal edin |
Adım büyüklüğü, tick büyüklüğü ve minimum işlem değeri her sembol için exchangeInfo üzerinden gelir ve coinden coine değişir. Bunları başlangıçta okuyun ve her emri bunlara göre yuvarlayın. -4164'teki reduce-only muafiyeti çıkışlar için önemlidir: küçük bir kalan pozisyonu kapatan take-profit veya stop emri minimumun altında kalsa bile, reduce-only gönderildiği sürece kabul edilir; bu yüzden her çıkış emrini böyle işaretleyin.
Teminat ve bakiye
| Kod | Binance'in ifadesi | Ne yapmalı |
|---|---|---|
| -2018 | "Balance is insufficient" | Cüzdanın kendisinde yeterli bakiye yok; fon transfer edin |
| -2019 | "Margin is insufficient" | Emrin maliyeti, emirler için kullanılabilir bakiyeden fazla |
-2019, aynı anda birden fazla pozisyon taşıyan hesaplarda en sık görülen rettir. Emrin maliyetine Binance'in piyasa emirleri için ayırdığı tampon da dahildir; açık emirler, gerçekleşmemiş zararlar ve izole pozisyonlar da kullanılabilir tutarı azaltır. Margin is insufficient (-2019) rehberi yedi nedeni sırasıyla ele alıyor.
Stoplar, take-profitler ve çıkışlar
| Kod | Binance'in ifadesi | Ne yapmalı |
|---|---|---|
| -2021 | "Order would immediately trigger" | Tetik koşulu zaten sağlanmış; yönü ve fiyatı kontrol edin, sonra pozisyonu kapatmaya ya da emri yeniden yerleştirmeye karar verin |
| -2022 | "ReduceOnly Order is rejected" | Çıkış emri pozisyonla ya da mevcut emirlerle çakışıyor |
| -2024 | "Position is not sufficient" | Reduce-only miktarı pozisyondan büyük |
| -2011 | "CANCEL_REJECTED" | Emir iptal edilemedi; genellikle zaten dolduğu ya da iptal edildiği için |
| -2013 | "Order does not exist" | Emir ID'si yanlış ya da emir artık yok |
Bir stop emrinde alınan -2021 en kritik olanıdır: pozisyon, vermek istediğiniz koruma olmadan açık kalır. Order would immediately trigger (-2021) her yön için tetik kurallarını açıklıyor; -2022 ise başarısız reduce-only emirler üzerine hazırladığımız rehberde ele alınıyor.
Kaldıraç
| Kod | Binance'in ifadesi | Ne yapmalı |
|---|---|---|
| -4028 | "Invalid leverage" | Coinin azami kaldıracının üzerinde; coinin izin verdiği bir değer seçin |
| -4421 | "Subaccounts are restricted from using leverage greater than 5x" | Alt hesaplarda üst sınır 5x |
| -2027 | "Exceeded the maximum allowable position at current leverage" | Kaldıracı düşürün ya da pozisyonu küçültün |
| -2028 | "Leverage is smaller than permitted: insufficient margin balance" | Kaldıracı düşürmeye yetecek teminat yok |
| -4161 | "Leverage reduction is not supported in Isolated Margin Mode with open positions" | Kaldıracı düşürmeden önce pozisyonu kapatın |
-4421, Binance'in herkese açık hata listesinde yer almıyor; ancak Binance'in döndürdüğü mesaj bu ve SSS sayfası bunun arkasındaki 5x alt hesap kuralını açıkça belirtiyor. Binance vadeli kaldıraç limitleri kaldıraç kademelerini, alt hesap kuralını ve yeni hesaplardaki 20x sınırını anlatıyor.
Hesap modları: marjin türü, pozisyon modu, çoklu varlık modu
| Kod | Binance'in ifadesi | Ne yapmalı |
|---|---|---|
| -4046 | "No need to change margin type" | Zaten ayarlı; yapılacak bir şey yok |
| -4047 / -4048 | "Margin type cannot be changed if there exists open orders / position" | Önce o semboldeki emirleri iptal edin ya da pozisyonu kapatın |
| -4059 | "No need to change position side" | Hesap zaten o modda |
| -4061 | "Order's position side does not match user's setting" | Tek yönlü mod ile hedge modu uyuşmuyor |
| -4067 / -4068 | "Position side cannot be changed if there exists open orders / position" | COIN-M dahil hesaptaki tüm pozisyonları ve emirleri kapatın, sonra modu değiştirin |
| -4167 / -4168 | "Isolated margin and Multi-Assets mode cannot be combined" | Çapraz marjin kullanın ya da hesabı tek varlık moduna geçirin |
Pozisyon modu kodları positionSide nedir yazısında, -4167 ile -4172 arasındaki çoklu varlık modu kodları ise Binance çoklu varlık modu yazısında açıklanıyor.
Hangi hatalar güvenle yeniden denenebilir
Olduğu gibi yeniden denemeye değen yalnızca birkaç hata vardır: bir süre bekledikten sonra istek limitleri, 503 "Service Unavailable" ve "Internal error" türleri, bir de emrin gerçekleşmediğini kontrol ettikten sonra zaman aşımları. Geri kalan her şey isteğiniz ya da hesabınız hakkında bir tespittir ve aynı şeyi yeniden göndermek aynı yanıtı getirir. -2019, -2021 veya -4028'i döngü içinde yeniden denemek yalnızca istek ağırlığı harcar ve bir 429'u 418 yasağına çevirebilir.
Üyelerin hesaplarında gördüklerimiz
HafizeBot, bir üyenin emirlerini yerleştirirken Binance'in döndürdüğü her reddi kaydeder. 5 Ekim 2026'ya kadarki 30 günde başarısız emirlerin arkasındaki kodlar, en sıktan başlayarak şöyleydi: margin is insufficient (-2019) ve 5x alt hesap sınırı (-4421), her biri 13 kez; açık emirler yüzünden engellenen pozisyon modu değişiklikleri (-4067) ve geçersiz kaldıraç (-4028), her biri 5 kez; miktar hassasiyeti (-1111), 3 kez; çoklu varlık modundaki izole marjin reddi (-4168) ve pozisyon yönü uyuşmazlığı (-4061), her biri 2 kez; son olarak açık pozisyon yüzünden engellenen marjin türü değişikliği (-4048) ve Binance'in TradFi-Perps sözleşmesinin imzalanmasını istemesi (-4411), her biri birer kez. Bunların neredeyse hepsi bir yazılım hatası değil, üyenin hesabındaki bir ayar ya da imzalanmamış bir sözleşmedir; botun /lastsignals komutu her birini sade bir dille açıklar.
Binance Vadeli İşlemlerde bot çalıştırmadan önce
Birkaç kontrol, yukarıdaki kodların çoğunu daha ortaya çıkmadan ortadan kaldırır: vadeli işlem izni açık, çekim izni kapalı ve IP beyaz listesi tanımlı bir anahtar; bot bekliyorsa tek yönlü mod; izole marjin kullanılıyorsa tek varlık modu; USDⓈ-M Vadeli cüzdanında USDT; coinin ve hesabın sınırları içinde kalan bir kaldıraç; ve internet saatiyle senkronize bir saat. Anahtarın kendisi ticaret botunu Binance API anahtarıyla güvenle bağlama rehberinde anlatılıyor.
Sık sorulan sorular
Binance Vadeli hata kodları nedir? Binance'in bir API yanıtında, HTTP durum koduyla birlikte, bir isteğin neden reddedildiğini belirtmek için döndürdüğü negatif sayılardır. Binance bunları şöyle gruplar: -10xx sunucu veya ağ sorunları, -11xx istek sorunları, -20xx işleme sorunları (emirler, teminat, anahtarlar), -40xx filtreler ve diğer sorunlar (sembol kuralları, kaldıraç, hesap modları) ve -50xx emir gerçekleştirme sorunları.
Binance -2015 hatası ne anlama gelir? "Invalid API-key, IP, or permissions for action": anahtar yok ya da silinmiş, istek beyaz listede olmayan bir IP'den gelmiş ya da anahtarda vadeli işlem gibi gerekli izin yok.
Binance -1021 hatası nasıl düzeltilir?
İsteği gönderen makinenin saatini Binance sunucu saatiyle senkronize edin. Varsayılan recvWindow 5.000 ms'dir; bu değeri artırmak küçük kaymaları gizler ama yanlış ayarlanmış bir saati düzeltmez.
Binance'te HTTP 418 ne anlama gelir? IP adresiniz, 429 istek limiti yanıtları aldıktan sonra istek göndermeye devam ettiği için otomatik olarak yasaklanmıştır. İstek göndermeyi durdurun, yasağın bitmesini bekleyin ve kodunuza geri çekilme (back-off) ekleyin.
503 hatasından sonra Binance emrini yeniden denemek güvenli mi? Yalnızca kontrol ettikten sonra. Mesaj "Unknown error" ise Binance, işlem durumunun bilinmediğini ve emrin gerçekleşmiş olabileceğini söyler; önce emri client order ID'siyle sorgulayın.
Binance'te -4164 ne anlama gelir? Emrin değeri minimum işlem değerinin altındadır; Binance'in mesajı, gönderdiğiniz emir için bu sınırı 5.0 olarak verir. Reduce-only emirler muaftır.
Kısaca
Sorunun kimin tarafında olduğunu anlamak için HTTP durum kodunu, sorunun ne olduğunu anlamak için hata kodunu okuyun; kodun işaret ettiği şeyi değiştirin ve yalnızca bir şey değiştiğinde yeniden deneyin. Zaman aşımlarında ve 503 "Unknown error" yanıtında, yeniden göndermeden önce emri kontrol edin.
HafizeBot'un gönderdiği her sinyal, ıskalananlar dahil, sonucuyla birlikte performans sayfasında yayımlanır; aynı sinyaller VIP'ten 20 dakika sonra ücretsiz Telegram kanalına da düşer. Bu bir bilgilendirmedir, yatırım tavsiyesi değildir: kaldıraçlı vadeli işlemlerde beklediğinizden fazlasını kaybedebilirsiniz, bu yüzden yalnızca kaybetmeyi göze alabileceğiniz tutarla işlem yapın.