API entegrasyonu nedir, nasıl yapılır? Borsa API örneği

Kısa cevap: API entegrasyonu, iki yazılımın önceden tanımlı kurallarla veri ve komut alışverişi yapacak şekilde birbirine bağlanması demektir. İş altı adımda yapılır: doküman okuma, kimlik doğrulama, kota, hata yönetimi, test ve izleme. Borsa API tarafında kripto platformları herkese açık veriyi çoğunlukla anahtarsız sunar, hesap ve emir işlemleri imza ister; Borsa İstanbul verisi ise lisansa tabidir, gösterimsiz kullanım için Veri Dağıtım Sözleşmesi gerekir.

API entegrasyonu aynı anda bir ödeme altyapısını, kargo takibini veya bir kripto platformu hesabını anlatabilir. Teknik adımlar büyük ölçüde aynıdır; değişen, hatanın bedelidir. Yanlış bir kargo sorgusu tekrar edilir, yinelenen bir emir ise gerçek para harcar.

Bu yazı genel eğitim amaçlıdır; platform, varlık, strateji veya ayar önermez. Kanal farkı REST ve WebSocket, anahtar güvenliği API anahtarı, veri ile platform API'si ayrımı kripto API yazısındadır. Teknik bilgiler 4 Kasım 2026'da kontrol edilmiştir.

API entegrasyonu nedir, ne işe yarar?

API entegrasyonu, bir yazılımın başka bir servisin işlevlerini ve verisini insan eli değmeden, tanımlı istek ve yanıtlarla kullanmasını sağlayan bağlantıdır. API (application programming interface), iki yazılımın konuşma kurallarını tanımlayan arayüz demektir; entegrasyon ise bu kuralları kendi sistemine bağlama işidir.

API tek başına bir adres listesidir. Entegrasyon ise kimlik bilgilerinin saklanması, hataların ele alınması, kayıt tutulması ve servis değiştiğinde kodun güncellenmesi gibi işleri de içerir. Bu yüzden ilk başarılı istek işin sonu değil başlangıcıdır.

Sık görülen API entegrasyonu türleri (genel örnekler)
Alan	Yazılımın yaptığı iş	Hatanın sonucu
E-ticaret ve ödeme	Tahsilat başlatır, sonucu okur	Çift tahsilat, eksik sipariş
Muhasebe	Fatura ve hareketleri aktarır	Kayıt farkı
Kargo	Gönderi durumunu okur	Eski bilgi gösterme
Borsa veya kripto platformu	Fiyat okur, bakiye sorar, emir gönderir	Yinelenen emir, kota engeli, hesap değerinde kayıp

API nedir, borsa API ne demek?

Borsa API (borsa apisi diye de aranır), bir yazılımın bir piyasadan veri almasını veya hesap üzerinden emir iletmesini sağlayan arayüzün genel adıdır; arkasında kim olduğu sınırları belirler. Aynı ifade üç farklı şeyi anlatabilir:

Borsa API ifadesinin üç anlamı, 4 Kasım 2026
Tür	Kimden alınır	Temel sınır
Kripto platformu API'si	Platformun kendi dokümanı	Platform koşulları, kota, SPK düzenlemeleri
Aracı kurum API'si	Hesabın bulunduğu aracı kurum	Kurumun sunduğu kanal ve sözleşmesi
Borsa İstanbul verisi	Yetkili veri dağıtıcıları veya Borsa İstanbul	Lisans ve kullanım türü

Borsa İstanbul'da bireysel emirler aracı kurum kanallarından iletilir; ayrıntı otomatik al sat botu yazısında yer alıyor. Kripto tarafında ise 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 sayılır. Bu yüzden örnekler yalnızca SPK'nın geçici Faaliyette Bulunanlar Listesi'ndeki kuruluşlardan verilir; SPK'ya göre listede yer almak yetkilendirme anlamına gelmez.

API entegrasyonu nasıl yapılır? Altı adım

API entegrasyonu, bir kod yazma işinden önce bir okuma ve karar işidir; altı adım sırayla izlendiğinde hatalar canlıya çıkmadan görünür.

API entegrasyonu adımları
Adım	Cevaplanan soru	Çıktı
1. Doküman ve koşullar	Adres, sürüm, kullanım hakkı ve sözleşme ne diyor?	Kapsam notu
2. Kimlik doğrulama	Anahtar nasıl alınır, imza nasıl üretilir, hangi izin gerekir?	Çalışan imzalı okuma isteği
3. Kota	Ne kadar istek gönderilebilir, sınır neye göre sayılır?	İstek hızı planı
4. Hata yönetimi	Hangi hata tekrar denenir, hangisi denenmez?	Hata tablosu
5. Test	Test ortamı var mı, yoksa risk nasıl sınırlanır?	Test kaydı
6. İzleme	Sorun kim tarafından, ne zaman fark edilir?	Kayıt ve uyarı

İlk adımda teknik sayfalar kadar sözleşme de okunur. Teknik olarak mümkün olan her iş, servis koşullarına uygun olmayabilir. Üçüncü taraf verisini doğrudan güvenilir saymamak da bu aşamada başlar: OWASP'ın API10:2023 başlığı, dış API yanıtlarının doğrulanmasını ve yönlendirmelerin körlemesine izlenmemesini ister; zaman aşımı konmamasını da zafiyet belirtileri arasında sayar. Veri çekmenin kod tarafı Python ile borsa verisi çekme yazısında anlatılıyor.

Kimlik doğrulama örneği: bir platform dokümanı nasıl okunur?

Kimlik doğrulama, isteğin hesabın sahibinden geldiğini kanıtlama işidir; aşağıdaki örnek SPK listesindeki bir platformun açık dokümanından bir okuma alıştırmasıdır ve bir öneri değildir. Bitlo Kripto Varlık Alım Satım Platformu AŞ, 28 Ekim 2026 tarihli geçici listededir; SPK'ya göre listede yer almak yetkilendirme anlamına gelmez.

Bitlo API dokümanı, 4 Kasım 2026
Dokümandaki bilgi	Entegrasyondaki karşılığı
`x-pubkey`	Hangi anahtarın kullanıldığını söyler
`x-nonce`	Milisaniye cinsinden zaman; sunucudan en çok ±2 dakika sapar
`x-signature`	Genel anahtar ve nonce birleşiminin HMAC-SHA256 değeri, küçük harfli onaltılık
Sunucu saati adresi	Saat farkı ölçülür, imza hatası ayıklanır
Hata biçimi	`code`, `message` ve `timestamp` alanları kayda yazılır

import hashlib, hmac, requests

# Uydurma değerler: gerçek bir hesaba ait değildir
genel = "ornek-genel-anahtar"
gizli = "ornek-gizli-anahtar"
nonce = 1700000000000

imza = hmac.new(gizli.encode(), f"{genel}{nonce}".encode(), hashlib.sha256).hexdigest()
print(imza)

# Anahtar gerektirmeyen tek istek: sunucu saati
saat = requests.get("https://api.bitlo.com/config/servertime", timeout=10)
saat.raise_for_status()
print(saat.status_code, sorted(saat.json().keys()))

Çıktı (kod 4 Kasım 2026'da çalıştırılmıştır; imza uydurma değerlerle üretilmiştir ve hiçbir hesaba istek gönderilmemiştir):

4d36809b49090d8d29b940b7049899767ad8c42a10a0068bcb73daf2aa14333a
200 ['serverTime']

Aynı örnek ilk adımın neden önemli olduğunu da gösterir. Bu platformun Çerçeve Sözleşmesi (sürüm 1.0.3) Platform tanımına API'leri dahil eder ve Madde 4.66'da botlarla alım satım işlemi gerçekleştirmeyi yasak sayar. Teknik doküman açık olsa bile otomatik kullanım için yazılı teyit gerekebilir. Birkaç platformun dokümanı Bitlo, Bitexen ve OKX TR API yazısında özetleniyor.

Kota ve hata yönetimi nasıl kurulur?

Kota ve hata yönetimi, servisin ne zaman "yavaşla" veya "bilmiyorum" dediğini okuyup buna göre davranmaktır. Kota, belirli sürede gönderilebilecek istek sınırı demektir. RFC 6585'e göre 429 kodu fazla istek anlamına gelir ve yanıt Retry-After başlığıyla bekleme süresini bildirebilir.

HTTP yanıtına göre genel davranış
Yanıt	Olası anlam	Yazılımın davranışı
400	İstek hatalı	Tekrar denenmez, kayda yazılır
401, 403	Kimlik veya izin sorunu	Tekrar denenmez, uyarı üretilir
429	Kota aşıldı	`Retry-After` kadar beklenir
5xx, zaman aşımı	Sunucu tarafı sorun, sonuç belirsiz olabilir	Okuma tekrar denenir; yazma önce sorgulanır

Ayrım HTTP'nin kendisinden gelir: RFC 9110'a göre PUT, DELETE ve güvenli yöntemler idempotenttir, yani aynı istek tekrarlandığında sunucudaki etki değişmez; POST bu listede yoktur. Emirler çoğunlukla POST ile gönderildiği için yanıtı belirsiz kalan emir körlemesine yinelenmez. Binance TR dokümanı da 5XX yanıtının başarısızlık sayılmamasını ister, çünkü işlem gerçekleşmiş olabilir.

Varsayımsal örnek: Bir okuma isteği zaman aşımına düşsün ve yazılım 1, 2, 4 ve 8 saniye bekleyerek dört kez daha denesin. Toplam bekleme 1 + 2 + 4 + 8 = 15 saniyedir ve istekler üst üste yığılmaz. Aynı yöntem 10.000 TL'lik bir emre uygulanır ve dört deneme de işlenirse ilk emirle birlikte 50.000 TL'lik emir oluşabilir. Tutarlar yalnızca farkı göstermek içindir.

API entegrasyonu nasıl test edilir ve izlenir?

Test, yazılımın doğru çalıştığını gösterir; izleme ise bir süre sonra bozulduğunda bunu fark ettirir. Test ortamı olmayan servislerde sıra daha da önemlidir: okunan kripto platformu dokümanlarının çoğunda test ortamı tarif edilmez.

Birim testi: İmza üretimi dokümandaki örnekle karşılaştırılır; ağ gerekmez.
Sahte sunucu: 429, 500 ve zaman aşımı yanıtları yerel olarak üretilir, yazılımın davranışı görülür.
Canlı okuma: Herkese açık uç noktalar ve emir göndermeyen imzalı okuma istekleri denenir. Örnek yanıt canlı yanıtla karşılaştırılır.
Sanal bakiye: Emir mantığı gerçek para kullanmadan sınanır; yöntem paper trading yazısında anlatılıyor.
Kayıt: Her istek zaman, yanıt kodu ve süreyle saklanır. Anahtar, gizli değer ve imza kayda yazılmaz.
Uyarı: Art arda hata, yükselen gecikme ve kota yaklaşımı için bildirim kurulur.
Sürüm takibi: Değişiklik kaydı düzenli okunur; kaldırılan uç noktalar kodu sessizce bozabilir.

Borsa API ücretsiz mi? BIST verisinde lisans sınırı

Kripto platformlarının herkese açık piyasa verisi uç noktaları çoğunlukla anahtarsız ve ücretsizdir; Borsa İstanbul verisinde ise teknik erişimden önce kullanım hakkı sorusu gelir.

Gösterimsiz kullanım: Borsa İstanbul'un sık sorulan soruları bunu verinin gösterimi yapılmaksızın erişilip kullanılması olarak tanımlar ve Borsa İstanbul ile Veri Dağıtım Sözleşmesi imzalanmasını şart koşar. Algoritmik sistemler bu kapsamda anılır.
Veri dağıtıcıları: Yetkili kuruluşlar Borsa İstanbul'un veri dağıtıcı kuruluşlar sayfasında listelenir.
Geçmiş veri: Borsa İstanbul geçmişe dönük veri ve bazı referans verileri DataStore üzerinden satar; kullanım koşulları satın alma sırasında okunur.
Yeniden yayım: Veriyi kişisel analizde kullanmak ile bir uygulamada başkalarına göstermek farklı kullanım türleridir.

Kripto tarafında da ücretsiz, sınırsız demek değildir; kota ve yeniden yayım hakkı sağlayıcının koşullarına bağlıdır. OKX TR API Sözleşmesi'nin Bölüm 9.4 hükmü gibi bazı metinler piyasa verisinin ticari kullanımını ve yeniden dağıtımını ayrıca sınırlar.

Borsa API key nasıl alınır, entegrasyonu kim yapar?

Borsa API key, hesabın bulunduğu platform veya aracı kurumun kendi ekranından ya da destek kanalından alınır; adımlar kuruma göre değişir ve hesap şifresi hiçbir yazılıma verilmez. Yalnızca gereken izinler tanınır; emir göndermek için çekim izni gerekmez. Anahtarın başkasına verilmesi hem güvenlik hem sözleşme sorusudur.

Entegrasyonu kişi kendisi yazabilir veya bir yazılımcıya yaptırabilir. İkinci durumda belirleyici soru kararı kimin verdiğidir: kural, hesap ve anahtar kişide kalmalıdır. III-35/B.2 sayılı Tebliğ'in 15/3 hükmü, müşteri portföylerinin menfaat sağlamak üzere vekil sıfatıyla veya bu sonucu doğuran sözlü yetkiyle yönetilmesini yasaklar; 15/1 hükmü ise platformların belli bir kişiye veya benzer bir gruba yönelik yönlendirici yorum ve tavsiyesini yatırım danışmanlığı olarak tanımlar. Sinyal ve hesap yönetimi teklifleri bu yüzden ayrıca dikkat ister.

Müşterinin yazılı olarak belirlediği kuralların, müşterinin hesabı ve anahtarıyla çalışan yazılıma dönüştürülmesi kapsamı borsa API entegrasyonu sayfasında anlatılıyor; Fincode strateji önermez, hesap yönetmez. API bir kazanç aracı değil iletişim kanalıdır; yazılımla gönderilen emirler de zararla sonuçlanabilir. Yazı hukuki görüş değildir.

Sık sorulan sorular

API entegrasyonu nedir?

API entegrasyonu, iki yazılımın önceden tanımlı istek ve yanıtlarla veri ve komut alışverişi yapacak şekilde bağlanmasıdır. Kimlik doğrulama, kota, hata yönetimi, test ve izleme işlerini de kapsar.

API entegrasyonu nasıl yapılır?

Önce doküman ve kullanım koşulları okunur, sonra kimlik doğrulama çalıştırılır, kota planlanır, hata davranışı yazılır, test edilir ve izleme kurulur. Yazma işlemleri belirsiz yanıtta körlemesine yinelenmez.

Borsa API ücretsiz mi?

Kripto platformlarının herkese açık veri uç noktaları çoğunlukla anahtarsız ve ücretsizdir, kota uygulanır. Borsa İstanbul verisi lisansa tabidir; gösterimsiz kullanım için Veri Dağıtım Sözleşmesi gerekir, yetkili dağıtıcılar Borsa İstanbul'un sayfasında listelenir.

Borsa API key nedir?

Borsa API key, bir yazılımın hesaba bağlanırken kendini tanıtmak için kullandığı değerdir ve genellikle bir gizli anahtarla birlikte verilir. Platform veya aracı kurumdan alınır, yalnızca gereken izinlerle kullanılır; yazılıma hesap şifresi yerine bu değer tanımlanır.

API entegrasyonu için test ortamı şart mı?

Test ortamı varsa kullanılır, ancak okunan kripto platformu dokümanlarının çoğunda tarif edilmez. Bu durumda imza ve hata davranışı yerelde, emir mantığı sanal bakiyeyle sınanır; gerçek hesapla yapılan her emir gerçek sonuç doğurur.

Kaynaklar

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.