Kısa cevap: Kripto API, bir yazılımın kripto varlık fiyatlarını okumasını veya bir platform hesabına bağlanıp emir göndermesini sağlayan programlama arayüzüdür. İki ana türü vardır: birçok kaynağı derleyen veri API'leri yalnızca veri sunar; platform API'leri ise herkese açık piyasa verisinin yanında anahtarla imzalanan hesap ve emir işlemlerini içerir.
Kripto API kavramı tek bir ürünü anlatmaz: fiyat ekranı besleyen bir veri servisi de bir platform hesabına emir gönderen arayüz de aynı adla anılır. Riskler bu ikisi arasında çok farklıdır; biri yalnızca veri okur, diğeri hesaba erişir. Bu yazı farkı, kimlik doğrulamayı, kotayı ve resmi dokümanın okunma sırasını anlatır.
Yazı genel eğitim amaçlıdır; platform, varlık, strateji veya ayar önermez. Doküman örnekleri alfabetik sırayla verilir ve bir sıralama değildir. Teknik bilgiler 3 Kasım 2026'da resmi dokümanlardan kontrol edilmiştir.
Kripto API ne demek? Veri API'si ve platform API'si farkı
Veri API'si ile platform API'si arasındaki temel fark, birincisinin yalnızca okuma sunması, ikincisinin bir hesaba bağlanabilmesidir. API (application programming interface), iki yazılımın önceden tanımlanmış kurallarla konuşmasını sağlayan arayüz demektir.
| Özellik | Veri (toplayıcı) API'si | Platform API'si |
|---|---|---|
| Ne sunar? | Birçok kaynaktan derlenmiş fiyat, hacim ve piyasa bilgisi | O platformun emir defteri ve işlemleri; hesap ve emir işlemleri |
| Hesap gerekir mi? | Plana göre anahtar istenebilir | Piyasa verisi çoğunlukla anahtarsız; hesap ve emir için anahtar ve imza |
| Emir gönderir mi? | Hayır | Evet, anahtara bu izin verilmişse |
| Fiyat neyi gösterir? | Derlenmiş bir değer | O platformda oluşan fiyat |
| Başlıca risk | Eski veya hatalı veriye dayanmak | Anahtarın sızması, hatalı emir, kota aşımı |
CoinGecko'nun 3 Kasım 2026'da okunan dokümanı, hizmeti bağımsız bir kripto veri toplayıcısı olarak tanımlar ve giriş sayfasında emir iletiminden söz etmez. Toplayıcı fiyatı tek bir emir defterinde oluşmadığı için bir platformda emrin gerçekleşeceği fiyatla aynı olmak zorunda değildir.
Herkese açık ve özel uç nokta ne demek?
Herkese açık uç nokta anahtarsız okunur; özel uç nokta hesaba eriştiği için kimlik doğrulama ister. Uç nokta (endpoint), API'de belirli bir işi yapan adres demektir. Aşağıdaki tabloda herkese açık uç noktalar 3 Kasım 2026'da anahtar gönderilmeden denenmiştir; özel uç noktalara istek gönderilmemiş, bilgi dokümandan alınmıştır.
| Doküman | İstek | Tür | Sonuç veya doküman bilgisi |
|---|---|---|---|
| Binance TR | GET /open/v1/common/time | Herkese açık | Denendi: HTTP 200, gövdede code: 0 |
| Binance TR | GET /open/v1/account/spot | Özel | Doküman: SIGNED, geçerli anahtar ve imza ister |
| BtcTurk | GET /api/v2/ticker | Herkese açık | Denendi: HTTP 200, gövdede success: true |
| BtcTurk | GET /api/v1/users/balances | Özel | SSS: kimlik doğrulama ister, başlık eksikse 401 döner |
| Paribu | GET /market/ticker | Herkese açık | Denendi: HTTP 200, gövdede piyasa listesi |
HTTP durum kodu tek başına yeterli olmayabilir: Binance TR dokümanı, yanıt gövdesinde 0'ın başarı, diğer değerlerin hata anlamına geldiği bir code alanı tanımlar. Bu nedenle yazılım hem durum kodunu hem gövdedeki hata alanını kontrol eder. Bu yazıda yalnızca ilgili dokümanda geçen uç noktalar anılır; topluluk kaynaklarındaki eski adresler kullanılmaz.
Kripto API'de kimlik doğrulama nasıl çalışır?
Özel isteklerde anahtar hesabı tanıtır, gizli anahtarla üretilen imza ise isteğin anahtarın sahibinden geldiğini kanıtlar. Gizli anahtar istekle birlikte gönderilmez; yalnızca imzayı üretmekte kullanılır.
| Doküman | Taban adres | Yöntem ve başlıklar | İmzalanan içerik |
|---|---|---|---|
| Binance TR | https://www.binance.tr | HMAC SHA256; X-MBX-APIKEY | Sorgu metni ve istek gövdesi |
| BtcTurk | https://api.btcturk.com | HMAC-SHA256; X-PCK, X-Stamp, X-Signature | Genel anahtar ve zaman damgası |
| Paribu | https://api.paribu.com | HMAC-SHA256; Authorization, X-Signature, X-Timestamp | Zaman damgası, sorgu metni ve gövde |
Üç doküman adresi de platformların ana sitelerinden bağlantı alır: binance.tr kendi /apidocs sayfasına, kripto.btcturk.com docs.btcturk.com adresine, paribu.com docs.paribu.com/api adresine bağlantı verir. Bağlantılar 3 Kasım 2026'da kontrol edilmiştir. Anahtar ile gizli anahtar farkı, izin kapsamları ve saklama API anahtarı yazısında anlatılıyor. Platforma özgü teknik ayrıntılar Binance TR API ve BtcTurk API yazılarındadır.
API kotası nedir? IP, hesap ve kullanıcı bazlı limitler
Kota, belirli bir sürede gönderilebilecek istek miktarına konan sınır demektir ve aşıldığında platform isteği reddeder. Sınırın neye göre sayıldığı dokümandan dokümana değişir:
- Binance TR: Doküman, limitlerin API anahtarına değil IP adresine göre sayıldığını ve her uç noktanın bir ağırlığı olduğunu belirtir; emir sayacı ise hesap başınadır.
- BtcTurk: Limit tablosunda her uç nokta için süre, engel süresi ve IP veya hesap politikası yazılıdır.
- Paribu: Doküman, kullanıcı başına dakikalık bir ağırlık havuzu ve emir işlemleri için saniyelik ayrı bir sınır tarif eder.
Üç dokümanda da aşım 429 koduyla bildirilir ve Retry-After başlığı bekleme süresini gösterir. Bu başlık okunmadan tekrarlanan istekler sorunu büyütür; Binance TR dokümanına göre ısrar eden IP 418 koduyla 2 dakikadan 3 güne kadar engellenebilir.
Varsayımsal örnek: Dakikalık kotanın 1.200 ağırlık, fiyat sorgusunun 2 ağırlık olduğu bir API düşünülsün. Yazılım 10 sembolü saniyede bir sorgularsa dakikada 10 × 2 × 60 = 1.200 ağırlık harcar ve kotanın tamamı yalnızca fiyat okumaya gider. Emir ve bakiye istekleri için pay kalmaz. Rakamlar yalnızca hesabı göstermek içindir.
Sürekli değişen veri için akış kanalının neden tercih edildiği REST ve WebSocket farkı yazısında anlatılıyor.
Veri gecikmesi neden önemlidir?
Gecikme önemlidir, çünkü kararın dayandığı fiyat ile emrin gerçekleşeceği fiyat arasındaki farkı büyütür. REST yanıtı sorulduğu anın fotoğrafıdır; toplayıcı veri ise ek bir derleme adımından geçer. Bu yüzden iki kaynak aynı anda farklı değer gösterebilir.
- Yoklama aralığı: Bir fiyat 10 saniyede bir soruluyorsa bilgi en fazla 10 saniye eskidir; ağ ve işlem süresi buna eklenir.
- Sistem sorunları: BtcTurk dokümanına göre gerçek zamanlı emir defteri verisinde gecikme veya arıza olduğunda ilgili uç nokta yanlış veri vermemek için HTTP 503 döner. Binance TR dokümanı ise 5XX yanıtlarında işlemin durumunu bilinmeyen olarak ele almayı ister.
- Zaman biçimi: BtcTurk dokümanı zaman damgalarını milisaniye, OHLC grafik verisini saniye olarak tanımlar ve sunucuların UTC kullandığını yazar. Birim karıştığında tarih hesabı bozulur.
- Yenileme sıklığı: Paribu dokümanı işlem kuralları dosyası için 60 saniyede bir sorguyu önerir. Toplayıcı servislerde yenileme sıklığı uç nokta sayfasında aranır.
Kripto API dokümanı nasıl okunur?
Doküman, önce resmi olduğu doğrulanarak sonra aşağıdaki sırayla okunur.
| Bölüm | Aranacak bilgi | Neden gerekir? |
|---|---|---|
| Genel bilgiler | Taban adres, zaman birimi, yanıt biçimi | Yanlış adres ve birim hatalarını önler |
| Kimlik doğrulama | Başlıklar, imza metni, zaman toleransı | 401 hatalarının çoğu buradan çıkar |
| İzinler | Okuma, işlem ve çekim ayrımı | Anahtara gereğinden fazla yetki verilmez |
| Limitler | Süre, ağırlık, engel, başlıklar | Yazılımın istek hızını belirler |
| İşlem kuralları | Sembol yazımı, fiyat adımı, asgari tutar | Emirlerin reddedilmesini önler |
| Hata kodları | Tekrar denenebilecek ve denenmeyecek hatalar | Aynı emrin iki kez gitmesini önler |
| Değişiklik kaydı | Son tarih, kaldırılan uç noktalar | Kodun ne zaman güncelleneceğini gösterir |
| Kullanım koşulları | Otomatik işlem, üçüncü kişi kullanımı | Teknik olarak mümkün olan her şey sözleşmeye uygun olmayabilir |
Dört kontrol daha yapılır. Birincisi, doküman adresi platformun kendi sitesinden bulunur. İkincisi, güncellik okunur: 3 Kasım 2026 itibarıyla Binance TR değişiklik kaydının son girişi 28 Ağustos 2026, BtcTurk kaydının son girişi 6 Mayıs 2024 tarihlidir. Üçüncüsü, örnek yanıt canlı yanıtla karşılaştırılır: Binance TR dokümanındaki sunucu saati örneğinde data alanı yoktur, 3 Kasım 2026'daki canlı yanıtta ise değeri boş (null) bir data alanı vardı. Dördüncüsü, test ortamı aranır: aynı tarihte okunan Binance TR ve BtcTurk dokümanlarında test ortamı tarif edilmez. Kuraldan canlıya geçişin genel aşamaları otomatik al sat botu yazısında ele alınıyor.
Ücretsiz kripto API var mı?
Evet; platformların herkese açık piyasa verisi uç noktaları anahtarsız kullanılabilir, bazı veri servisleri de sınırlı uç nokta ve kotayla ücretsiz plan tanımlar. Ücretsiz olması sınırsız olduğu anlamına gelmez; kota, geçmiş veri derinliği ve yeniden yayım hakkı sağlayıcının koşullarına bağlıdır.
Veriyi bir uygulamada başkalarına göstermek, kişisel analizden farklı bir kullanımdır ve ayrıca sağlayıcının kullanım şartlarından okunur. Anahtar isteyen servislerde anahtarın sorgu metninde gönderilmesi, değerin sunucu kayıtlarına ve tarayıcı geçmişine düşmesi riskini taşır. Bu verinin kural tabanlı yazılımlarda nasıl kullanıldığı kripto botu yazısında anlatılıyor.
Türkiye'de platform API'si kullanılırken hangi kurallar bilinir?
Türkiye'de yerleşik kişilere hizmet sunan kuruluşlar SPK düzenlemelerine tabidir ve bir API'nin teknik olarak erişilebilir olması bu düzenlemeleri değiştirmez.
- Liste kontrolü: SPK'nın Faaliyette Bulunanlar Listesi geçici bir listedir; 3 Kasım 2026'da kontrol edildiğinde 49 satır içeriyordu (40 platform, 9 saklama başvurusu). SPK, listede yer almanın yetkilendirme anlamına gelmediğini belirtir. Binance Turkey, Btcturk ve Paribu unvanlı platformlar bu listededir. Ayrıntı kripto varlık hizmet sağlayıcı yazısında.
- Yurt dışı platformlar: 6362 sayılı Kanun'un 99/A maddesine göre yurt dışında yerleşik platformların Türkiye'de yerleşik kişilere yönelik faaliyeti 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.
- Kaldıraç: III-35/B.2 sayılı Tebliğ'in 14. maddesi, platformlarda listelenmiş kripto varlıkların kaldıraçlı alınıp satılamayacağını düzenler.
- Hesabı başkasına bırakmak: Aynı Tebliğ'in 15. maddesi, müşteri portföylerinin doğrudan veya dolaylı menfaat sağlamak üzere vekil sıfatıyla veya bu sonucu doğuracak şekilde sözlü yetkiye dayanarak yönetilmesini yasaklar. Anahtar paylaşımının riskleri anahtar yazısında anlatılıyor.
API bir kazanç aracı değil, iletişim kanalıdır; yazılımla gönderilen emirler de zararla sonuçlanabilir. Müşterinin yazılı olarak belirlediği kuralların yazılıma dönüştürülmesi işi borsa API entegrasyonu sayfasında anlatılıyor; Fincode strateji önermez, strateji ve yatırım kararları müşteriye aittir.
İlgili yazılar: API entegrasyonu nedir, Paribu API, Bitlo, Bitexen ve OKX TR API.
Sık sorulan sorular
Kripto API nedir, ne işe yarar?
Kripto API, bir yazılımın kripto varlık verisini okumasını veya bir platform hesabına bağlanmasını sağlayan arayüzdür. Fiyat ekranı, raporlama ve kullanıcının kendi kurallarıyla çalışan yazılımlar bu arayüzü kullanır.
Binance API nedir?
Bu ad iki ayrı yapı için kullanılabilir. Türkiye'deki Binance Turkey platformunun API'si binance.tr/apidocs adresinde belgelenir. 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.
CoinGecko API nedir?
CoinGecko'nun dokümanına göre CoinGecko API, kripto piyasa verisi sunan bir veri toplayıcı arayüzüdür; giriş sayfası emir iletiminden söz etmez. Bu yazıda yalnızca veri API'si türünü açıklamak için anılır ve bir öneri değildir.
Paribu API dokümanı nerede?
Paribu'nun sitesi docs.paribu.com/api adresine bağlantı verir. 3 Kasım 2026'da okunan dokümana göre taban adres api.paribu.com, özel isteklerde imza yöntemi HMAC-SHA256'dır. Bu bilgi bir platform önerisi değildir.
Kripto API kullanmak kazanç sağlar mı?
Hayır. API yalnızca veri okuma ve emir iletme yoludur; emirlerin sonucu piyasaya ve kullanıcının kurallarına bağlıdır. Yazılımla gönderilen emirler de zararla sonuçlanabilir.
Kaynaklar
- 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)
- Binance TR API dokümanı (yeni sekmede açılır)
- BtcTurk API dokümanı: General Information (yeni sekmede açılır)
- BtcTurk API dokümanı: Rate Limits (yeni sekmede açılır)
- BtcTurk API dokümanı: Get OrderBook (yeni sekmede açılır)
- Paribu API dokümanı: Introduction (yeni sekmede açılır)
- Paribu API dokümanı: Authentication and Signing (yeni sekmede açılır)
- Paribu API dokümanı: Rate Limiting (yeni sekmede açılır)
- Paribu API dokümanı: Exchange Config (yeni sekmede açılır)
- CoinGecko API dokümanı: Welcome to CoinGecko API (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.