Kısa cevap: Binance TR API, Türkiye'deki Binance Turkey platformunun binance.tr/apidocs adresinde belgelediği REST ve WebSocket arayüzüdür. Piyasa verisi anahtarsız okunur; hesap ve emir uç noktaları X-MBX-APIKEY başlığı ile HMAC SHA256 imzası ister ve limitler IP bazlı ağırlıkla sayılır. Binance Turkey unvanlı platform, SPK'nın geçici Faaliyette Bulunanlar Listesi'nde yer alır (liste 3 Kasım 2026'da kontrol edildi: 49 satır, 40'ı platform); SPK'ya göre listede olmak yetkilendirme anlamına gelmez.
Bu yazı yalnızca Türkiye'deki platformun kendi API dokümanını ve sözleşmelerini özetleyen teknik bir rehberdir. Tanıtım veya platform, varlık, strateji ve ayar önerisi değildir; platformu başka bir kuruluşla karşılaştırmaz. Bilgiler 3 Kasım 2026'da kontrol edilmiştir.
Yurt dışında yerleşik platformların Türkiye'de yerleşik kişilere yönelik faaliyeti, 6362 sayılı Kanun'un 99/A maddesine göre izinsiz kripto varlık hizmet sağlayıcılığı sayılır; SPK bu faaliyetlerin sonlandırılması için 2 Ekim 2024 tarihini duyurmuştur. Bu nedenle yazı küresel platform için adres, anahtar adımı veya erişim yolu vermez ve erişim kısıtını aşma yöntemi anlatmaz. Sorunun markaya göre değil hizmeti sunan kuruluşa göre cevaplandığı kripto varlık hizmet sağlayıcı yazısında anlatılıyor.
Binance TR API docs neleri kapsar?
Binance TR API dokümanı genel kuralları, piyasa verisini, hesap ve emir işlemlerini, Travel Rule, kimlik ve cüzdan uç noktalarını ve WebSocket akışlarını kapsar. Doküman platformun kendi alan adındadır, binance.tr ana sayfası bu adrese bağlantı verir ve 3 Kasım 2026 itibarıyla değişiklik kaydının son girişi 28 Ağustos 2026 tarihlidir.
| Bölüm | İçerik |
|---|---|
| General endpoints | Sunucu saati, sembol listesi, işlem kuralları |
| Market Data | Emir defteri, işlemler, toplu işlemler, mum verisi |
| Account | Emir gönderme, sorgu, iptal, OCO, hesap bilgisi, işlem geçmişi |
| Travel Rule ve KYC | Transfer uyum akışı ve kimlik bilgisi listeleri |
| Wallet | Para ve kripto hareketleri |
| WebSocket ve User Data | Piyasa akışları ve hesap olayları |
| FAQs | Fiyat aralığı kuralı ve kendi emriyle eşleşmeyi önleme |
Binance TR API adresleri hangileridir?
Binance TR dokümanı ana REST adresi olarak https://www.binance.tr adresini verir; WebSocket için aynı alan adı altında ayrı adresler tanımlar.
| Adres | Dokümandaki kullanım |
|---|---|
https://www.binance.tr | Genel, hesap, emir, cüzdan, Travel Rule ve KYC uç noktaları |
wss://stream-cloud.binance.tr | Type 1 semboller için WebSocket piyasa akışları |
wss://ws-api.binance.tr:443/ws-api/v3 | Dinleme belirteciyle kullanıcı verisi aboneliği |
Doküman emir defteri, işlem, toplu işlem ve mum verisi uç noktaları için ayrı taban adresler de yazar. Bu adreslerin sahipliği platformun resmi sayfalarından ayrıca doğrulanamadığı için yazıda verilmez ve örnek kodda kullanılmaz; ilgili uç noktalar dokümanın Market Data bölümünden okunur. 3 Kasım 2026'da /open/v1/common/symbols yanıtındaki 309 sembolün tamamı type 1 idi ve tamamı TL karşılıklıydı; dokümandaki USDT'li örnekler bu nedenle yalnızca biçim gösterir. Sembol, genel uç noktalarda alt çizgiyle (XYZ_TRY, varsayımsal) yazılır; dokümana göre type 1 sembollerin piyasa verisi isteklerinde alt çizgi kaldırılır, WebSocket'te ayrıca küçük harfe çevrilir.
Kullanıcı verisi akışında değişiklik kaydı, 26 Mart 2026'dan itibaren POST /open/v1/user-listen-token yöntemine geçişi ister ve eski uç noktaların 30 Nisan 2026'da kapatılacağını duyurmuştu; bu tarih geçtiği için yeni kod bu yöntemle yazılmalıdır. Eski bölümde başka alan adları da geçtiği için bu yazı yalnızca yeni yöntemi anlatır. WebSocket bağlantısı 24 saat geçerlidir; akışın genel mantığı REST ve WebSocket yazısında yer alıyor.
Binance TR API key nasıl alınır?
API dokümanı anahtar oluşturma ekranının adımlarını anlatmaz; anahtar platform hesabının API yönetimi ayarlarından alınır. Binance TR'nin 7 Mart 2024 tarihli güvenlik yazısı, IP kısıtının hesaptaki API Yönetimi Ayarları üzerinden yapıldığını belirtir. Ekran adımları doğrulanamadığı için burada verilmez; başka platformlar için yazılmış adımlar da bu hesap için kaynak alınmaz.
Dokümandan anahtar hakkında şu kurallar okunur:
- Anahtarlar varsayılan olarak tüm güvenli yollara erişebilir ve belirli uç nokta türleriyle sınırlandırılabilir.
- API anahtarı ve gizli anahtar büyük-küçük harfe duyarlıdır.
- İmzalı Travel Rule uç noktaları
withdrawEnableizni ister. GET /open/v1/account/spotyanıtındakicanTrade,canWithdrawvecanDepositalanları hesabın durumunu gösterir.
İzin kapsamı, IP kısıtı ve saklama API anahtarı yazısında genel olarak anlatılıyor; burada ayar önerilmez. Dokümanda test ortamı tarif edilmez.
Binance TR API imzası nasıl üretilir?
İmzalı (SIGNED) uç noktalarda anahtar X-MBX-APIKEY başlığında gönderilir, parametreler gizli anahtarla HMAC SHA256 yöntemiyle imzalanır ve sonuç signature parametresine yazılır.
toplam_parametre = sorgu_metni + istek_govdesi
signature = HMAC-SHA256(secretKey, toplam_parametre) # onaltılık metintimestampzorunludur ve milisaniye cinsindendir.recvWindowvarsayılan 5.000 milisaniyedir, en fazla 60.000 olabilir. Doküman 5.000 veya altını önerir.- İstek
timestamp < sunucu + 1.000vesunucu − timestamp ≤ recvWindowkoşullarını sağlamazsa reddedilir. - POST parametreleri sorgu metninde, gövdede veya ikisinde gönderilebilir; ikisi karıştırılırsa imza metni de değişir.
Varsayımsal örnek: Sunucu saati 1.700.000.006.000 ms, timestamp 1.700.000.000.000 ms ve recvWindow varsayılan 5.000 ms olsun. Fark 6.000 ms olduğu için istek reddedilir. Yazılımın saati sunucudan 1.500 ms ileride olduğunda da timestamp, sunucu + 1.000 sınırını aştığı için istek reddedilir. Bu yüzden saat, /open/v1/common/time yanıtıyla karşılaştırılır.
Dokümandaki örnek komutta -hmac yanına API anahtarı yazılmış görünür, ama gösterilen imza gizli anahtarla üretilmiştir: değer 3 Kasım 2026'da iki anahtarla yeniden hesaplanmış, yalnızca gizli anahtarla eşleşmiştir. Dokümanın metni de gizli anahtarı ister. Örnekteki değerler hiçbir koda kopyalanmaz.
Binance TR API limitleri nasıl işler?
Binance TR API limitleri API anahtarına değil IP adresine göre sayılır; her uç noktanın bir ağırlığı vardır, emir sayacı ise hesap başınadır.
| Başlık veya kod | Anlamı |
|---|---|
X-MBX-USED-WEIGHT-(sayı)(birim) | IP'nin ilgili aralıkta kullandığı ağırlık |
X-MBX-ORDER-COUNT-(sayı)(birim) | Hesabın emir sayısı; reddedilen emirlerde gelmesi garanti değildir |
| HTTP 429 | Limit aşıldı; istekler durdurulur |
| HTTP 418 | 429'a rağmen devam eden IP otomatik engellendi; 2 dakikadan 3 güne kadar |
| HTTP 403 | Web uygulaması güvenlik duvarı limiti aşıldı |
| HTTP 5XX | Sunucu tarafı hata; işlem durumu bilinmez, başarısız sayılmaz |
Retry-After | 429 ve 418 yanıtlarında bekleme süresi (saniye) |
Dokümanın limit bölümü sayısal bir üst sınır yazmaz. 3 Kasım 2026'daki yanıtlarda tanımı dokümanda bulunmayan X-Mbx-Request-Weight-1m başlığı da görüldü; anlamı doğrulanamadığı için sınır olarak kullanılmamalıdır. Doküman veri için mümkün olduğunca WebSocket kullanılmasını önerir, çünkü bu kanal istek limitine sayılmaz. 5XX yanıtı alan bir emir, durumu sorgulanmadan yeniden gönderilmez; aksi hâlde aynı emir iki kez gidebilir.
Binance TR API Python ile nasıl denenir?
Herkese açık uç noktalar Python'da anahtarsız okunur. Aşağıdaki kod 3 Kasım 2026'da çalıştırılmıştır; varlık adı veya fiyat değil, yalnızca yanıtın yapısını yazdırır.
import requests
TABAN = "https://www.binance.tr"
saat = requests.get(f"{TABAN}/open/v1/common/time", timeout=10)
saat.raise_for_status()
govde = saat.json()
print(sorted(govde.keys()), govde["code"], saat.headers.get("X-MBX-USED-WEIGHT-1M") is not None)
semboller = requests.get(f"{TABAN}/open/v1/common/symbols", timeout=15)
semboller.raise_for_status()
liste = semboller.json()["data"]["list"]
print(sorted(liste[0].keys()))
print(sorted({s["type"] for s in liste}), sorted({s["quoteAsset"] for s in liste}))
print(sorted({f["filterType"] for f in liste[0]["filters"]}))Çıktı:
['code', 'data', 'msg', 'timestamp'] 0 True
['allowedSelfTradePreventionModes', 'baseAsset', 'basePrecision',
'defaultSelfTradePreventionMode', 'filters', 'icebergEnable',
'marginTradingEnable', 'ocoEnable', 'orderTypes', 'permissions', 'quoteAsset',
'quotePrecision', 'spotTradingEnable', 'symbol', 'type']
[1] ['TRY']
['ICEBERG_PARTS', 'LOT_SIZE', 'MARKET_LOT_SIZE', 'MAX_NUM_ALGO_ORDERS',
'MAX_NUM_ORDERS', 'MAX_NUM_ORDER_AMENDS', 'MAX_NUM_ORDER_LISTS', 'NOTIONAL',
'PERCENT_PRICE_BY_SIDE', 'PRICE_FILTER', 'TRAILING_DELTA']Çıktının ilk satırı önemli bir ayrıntı gösterir: dokümandaki sunucu saati örneğinde data alanı yoktur, canlı yanıtta ise değeri boş (null) bir data alanı vardı. Sembol yanıtında da dokümanın örneğinde bulunmayan permissions alanı görünür. Yazılım bu nedenle yalnızca örneğe göre değil, canlı yanıta göre sınanır ve beklenmeyen alanlarda durmaz.
Başarı kontrolü yalnızca HTTP durum koduna dayanmaz: dokümana göre yanıttaki code alanında 0 başarı, diğer değerler hata anlamına gelir. Hesap uç noktalarına istek gönderilmemiştir; bu uç noktaların davranışı için doküman esas alınır.
Sembol kuralları ve Self Trade Prevention ne anlama gelir?
Sembol filtreleri bir emrin kabul edilmesi için gereken fiyat, miktar ve tutar kurallarıdır; Self Trade Prevention ise bir hesabın kendi emirleriyle eşleşmesini önleyen mekanizmadır.
- Filtreler: 3 Kasım 2026 yanıtında
PRICE_FILTERfiyat adımını,LOT_SIZEmiktar adımını,NOTIONALasgari tutarı belirtir.PERCENT_PRICE_BY_SIDEdokümanda ayrıca tanımlanmaz; yanıtta alış ve satış yönü için çarpan alanları ve ortalama süresi görünür. Değerler canlı okunur, sabit yazılmaz. - Fiyat aralığı kuralı: Dokümana göre işlemler referans fiyat çevresindeki bir aralıkta gerçekleşebilir. FAQ'teki değerler kurmacadır.
- STP kipleri:
selfTradePreventionModeparametresi 19 Mayıs 2026'da eklendi; kiplerNONE,EXPIRE_TAKER,EXPIRE_MAKER,EXPIRE_BOTH,DECREMENTveTRANSFERadlarını taşır. Davranışı genellikle alıcı (taker) emrin kipi belirler; bir kip önerilmez. - Komisyon alanları: Hesap yanıtındaki komisyon alanlarının okunması kripto komisyon yazısında anlatılıyor.
Sembol yanıtındaki marginTradingEnable alanı 3 Kasım 2026'da 309 sembolün tamamında 0 idi; III-35/B.2 sayılı Tebliğ'in 14. maddesi de platformlarda listelenen varlıklarda kaldıraçlı işlemi yasaklar.
Binance TR sözleşmesi bot ve üçüncü taraf hakkında ne diyor?
Binance Türkiye Çerçeve Müşteri Sözleşmesi'nde API ve bot kelimeleri geçmez; ayrı bir API kullanım koşulları metni de bulunamamıştır. Sözleşmede tarih veya sürüm bilgisi yoktur; metin 3 Kasım 2026'da okunmuştur. Yine de hesabın kullanımına ilişkin hükümler anahtar paylaşımını doğrudan ilgilendirebilir.
| Kaynak | Özet |
|---|---|
| Sözleşme 8.1 | Hesap onaysız satılamaz, devredilemez, kiralanamaz ve üçüncü kişilere kullandırılamaz. |
| Sözleşme 8.2 | Müşteri kendi hesabına hareket eder; başkası hesabına hareket edecekse işlemden önce bildirir. |
| Sözleşme 8.3 | Temsilci için noter vekaletnamesi ve platformun ön izni gerekir. |
| Sözleşme 10.1, 10.4 | Hesaptan yapılan tüm işlemlerin sorumluluğu müşteridedir. |
| Sözleşme 10.2 | Emirlerin site, mobil uygulama veya Online Platform üzerinden alınması esastır; API bu maddede anılmaz. |
| Dönüştür Kullanım Koşulları A.10 (Versiyon: 1 Nisan 2023) | Yalnızca Dönüştür hizmeti için: API bağlantısı olduğu gibi sunulur, riskler kullanıcıdadır ve platform bağlantıyı kısıtlayabilir veya sonlandırabilir. |
| İçerik üreticileri rehberi (25 Eylül 2024) | Yalnızca o program için: botlarla tekrarlı otomatik işlem katılımı geçersiz kılabilir. |
Son iki satır belirli ürün ve programlara özgüdür; genel API kuralı olarak okunmaz. Bu metinlerden otomatik işlemin genel olarak serbest ya da yasak olduğu sonucu çıkarılamaz. Kullanım öncesinde platformun destek kanalından yazılı teyit alınması en açık yoldur. Kural tabanlı yazılımlarda platform koşullarının genel çerçevesi otomatik al sat botu yazısında anlatılıyor; listenin anlamı ise kripto varlık hizmet sağlayıcı yazısında. Yazılımla gönderilen emirler de zararla sonuçlanabilir. Yazı hukuki görüş değildir.
İlgili yazılar: Binance TR bot.
Sık sorulan sorular
Binance TR API docs nerede?
Doküman binance.tr/apidocs adresindedir. 3 Kasım 2026 itibarıyla değişiklik kaydının son girişi 28 Ağustos 2026 tarihlidir.
Binance TR API key nasıl alınır?
Anahtar platform hesabının API yönetimi ayarlarından alınır. API dokümanı ekran adımlarını anlatmaz; dokümana göre anahtarlar varsayılan olarak tüm güvenli yollara erişebilir ve sınırlandırılabilir.
Küresel platform için yazılmış kod Binance TR'de çalışır mı?
Bu doküman kendi adresini, yollarını, sembol yazımını ve yanıt biçimini tanımlar; başka platform için yazılmış kod buna göre kontrol edilmeden kullanılmaz. Yurt dışında yerleşik platformların Türkiye'de yerleşik kişilere yönelik faaliyeti ise 6362 sayılı Kanun'un 99/A maddesine göre izinsiz sayılır.
Binance TR API limitleri neye göre sayılır?
Dokümana göre istek limitleri IP adresine ve uç nokta ağırlığına göre, emir sayacı hesaba göre sayılır. Limit aşıldığında 429, ısrar edildiğinde 418 kodu döner ve engel 2 dakikadan 3 güne kadar sürebilir.
Binance TR'de bot kullanımı serbest mi?
Çerçeve sözleşmede API ve bot kelimeleri geçmez, bu nedenle metinden genel bir serbestlik veya yasak sonucu çıkarılamaz. Hesap üçüncü kişilere kullandırılamaz ve hesaptan yapılan işlemlerin sorumluluğu müşteridedir. Platformdan yazılı teyit alınması en açık yoldur.
Kaynaklar
- Binance TR API dokümanı (yeni sekmede açılır)
- Binance Türkiye Çerçeve Müşteri Sözleşmesi (yeni sekmede açılır)
- Binance TR: Hesabınızı 5 Basit Adımda Güvenceye Alın (7 Mart 2024) (yeni sekmede açılır)
- Binance TR: Dönüştür Kullanım Koşulları (Versiyon: 1 Nisan 2023) (yeni sekmede açılır)
- Binance TR: İçerik Üreticileri Program Rehberi (25 Eylül 2024) (yeni sekmede açılır)
- SPK: Faaliyette Bulunanlar Listesi (Geçici Liste, 3 Kasım 2026'da kontrol edildi) (yeni sekmede açılır)
- SPK: Kripto varlık hizmet sağlayıcılara ilişkin duyuru (2 Temmuz 2024) (yeni sekmede açılır)
- 6362 sayılı Sermaye Piyasası Kanunu (yeni sekmede açılır)
- III-35/B.2 sayılı Tebliğ, Resmî Gazete 13 Mart 2025, 32840 (yeni sekmede açılır)
Burada yer alan yatırım bilgi, yorum ve tavsiyeleri 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 yorum ve tavsiyeler ise genel niteliktedir. Bu tavsiyeler mali durumunuz ile risk ve getiri tercihlerinize uygun olmayabilir. Bu nedenle, sadece burada yer alan bilgilere dayanılarak yatırım kararı verilmesi beklentilerinize uygun sonuçlar doğurmayabilir.