Kripto entegrasyonu "BTC fiyatını çek" cümlesiyle başlar, nadiren orada biter. Ürünün TRY paritesine mi ihtiyacı var, belirli bir borsanın emir defterine mi, yoksa kullanıcının cüzdanındaki bakiyeye mi? Bu üç soru birbirinden farklı sağlayıcılara çıkar ve yanlış seçim genelde entegrasyon bittikten sonra fark edilir.
Bu rehber API Deposu kataloğundaki CoinStats, BtcTurk, Genelpara Kripto, CoinPaprika ve Binance Spot kayıtlarını kullanım senaryosuna göre ayrıştırır. Üretim öncesinde kimlik doğrulama, limit ve ticari kullanım koşullarını sağlayıcının kendi dokümantasyonundan doğrulayın.
Hızlı karşılaştırma
| API | En uygun olduğu yer | Veri tipi | Üretim notu |
|---|---|---|---|
| CoinStats API | Piyasa + cüzdan + portföy gerektiren hepsi bir arada ürünler | Toplulaştırılmış piyasa verisi, cüzdan bakiyesi, DeFi pozisyonu | API anahtarı gerekir; maliyet endpoint'e göre değişir |
| BtcTurk API | TRY pariteli Türkiye odaklı ürünler | Borsa ticker, emir defteri, işlem verisi | Halka açık piyasa verisi ücretsiz; özel uçlar HMAC-SHA256 ister |
| Genelpara Kripto | Basit TRY fiyat kartları ve widget'lar | Sade JSON fiyat çıktısı | Küçük yüzey alanı; üretim öncesi davranışı kendiniz test edin |
| CoinPaprika API | Coin sayfaları ve piyasa özeti ekranları | Ticker, coin metadata, global metrikler | Yüksek hacimli yenilemeden önce limitleri kontrol edin |
| Binance Spot API | Borsaya özgü grafik ve derinlik ekranları | Fiyat, emir defteri, OHLCV mum verisi | Yanıtları önbellekleyin, borsaya özgü sembolleri kendi tarafınızda normalize edin |
1. CoinStats API
CoinStats, piyasa verisinin yanında cüzdan bakiyesi, DeFi pozisyonu ve portföy analitiği de gereken ürünlerde işe yarar — portföy takipçilerinin normalde birkaç sağlayıcıdan derlediği birleşim.
Şu durumlarda değerlendirin:
- Coin fiyatı, piyasa değeri, hacim ve tarihsel grafik verisine ihtiyacınız var.
- Ürününüz ayrıca cüzdan bakiyesi, portföy verisi veya DeFi pozisyonu gösteriyor.
- Kripto verisini MCP üzerinden bir yapay zekâ ajanına besliyorsunuz.
Kimlik doğrulama X-API-KEY header'ı ile yapılır; ücretsiz katman kredi bazlı ölçümlenir ve maliyet endpoint'e göre değişir, plan seçmeden önce fiyatlandırma ve limit sayfalarını okuyun. Borsa mikro yapısının yerini tutmaz: emir defteri ve borsaya özgü tick verisi için ilgili borsanın API'sini kullanın.
İlk istek şu şekilde görünür:
curl --request GET \
--url "https://api.coinstats.app/v1/coins?limit=20¤cy=USD" \
--header "X-API-KEY: API_ANAHTARINIZ"2. BtcTurk API
BtcTurk, TRY pariteli veriye doğrudan erişmek isteyen Türkiye odaklı ürünler için en yakın kaynaktır. Halka açık piyasa endpoint'leri ücretsizdir; hesap ve emir işlemleri HMAC-SHA256 imzalı istek gerektirir.
Şu durumlarda değerlendirin:
- Fiyatları çevirmeden doğrudan TRY cinsinden göstermek istiyorsunuz.
- Türkiye'deki bir borsanın ticker, emir defteri veya işlem verisine ihtiyacınız var.
- Kullanıcılarınız yerel borsa fiyatını referans alıyor.
Yalnızca piyasa verisi okuyacaksanız imzalı istek akışını kurmanıza gerek yoktur. Emir oluşturma veya bakiye okuma gibi hesap işlemlerine geçtiğinizde imza üretimi, zaman damgası toleransı ve anahtar saklama konularını ayrıca çözmeniz gerekir.
3. Genelpara Kripto API
Genelpara Kripto, kripto fiyatlarını sade JSON olarak sunar. Küçük fiyat kartları, dashboard köşesindeki widget'lar ve hızlı prototipler için pratiktir.
Şu durumlarda değerlendirin:
- Tek bir fiyat değerini az bakımla göstermek istiyorsunuz.
- Karmaşık bir kayıt akışı kurmadan hızlı bir prototip çıkarıyorsunuz.
- Küçük bir yüzey alanı sizin için yeterli.
Yüzey alanı sınırlı olduğu için ürün büyüdükçe yetmeyebilir. Üretime almadan önce yanıt biçimini, hata davranışını ve güncellenme sıklığını kendi ortamınızda ölçün.
4. CoinPaprika API
CoinPaprika, coin metadata'sı, ticker alanları ve global piyasa metrikleri isteyen ürünler için iyi bir orta yoldur. API anahtarı gerektirmeden başlanabilir.
Şu durumlarda değerlendirin:
- Fiyat, hacim, sıralama ve metadata içeren coin sayfaları kuruyorsunuz.
- Piyasa özeti ekranları için düz bir REST API istiyorsunuz.
- Yanıtları önbellekleyip trafiği büyütmeden önce limitleri doğrulayabiliyorsunuz.
Cüzdan veya portföy verisi sunmaz; ürününüz o tarafa geçtiğinde ikinci bir sağlayıcı gerekir.
5. Binance Spot API
Binance Spot, halka açık market data endpoint'leriyle fiyat, derinlik ve mum verisi sağlar. Borsanın kendisinin ürün deneyiminin parçası olduğu ekranlarda uygundur.
Şu durumlarda değerlendirin:
BTCUSDTgibi borsaya özgü semboller üzerinden çalışıyorsunuz.- Mum verisiyle beslenen grafik bileşenleri kuruyorsunuz.
- Emir defteri anlık görüntüsü gösteriyorsunuz.
Borsa API'lerinde yeniden deneme, geri çekilme ve önbellek davranışını kendi trafik deseninize göre kurun. Borsaya özgü sembolleri kendi varlık kimliklerinizden ayrı saklayın.
Nereden başlamalı
Ürün şekline göre karar verin:
- Portföy, cüzdan veya hepsi bir arada kripto ürünü: CoinStats ile başlayın.
- TRY pariteli Türkiye odaklı ekran: BtcTurk.
- Basit fiyat widget'ı: Genelpara Kripto.
- Coin sayfaları ve piyasa özeti: CoinPaprika.
- Borsaya özgü grafik ve derinlik: Binance Spot.
- Birden çok sağlayıcı kullanacaksanız her birini küçük bir adapter arkasına alın ve yalnızca arayüzün gerçekten kullandığı alanları normalize edin.
Uygulama kontrol listesi
- Kimlik doğrulama ve plan gereksinimlerini resmî dokümantasyondan doğrulayın.
- Fiyat ve piyasa yanıtlarını backend veya edge katmanında önbellekleyin.
- Sağlayıcı sembollerini kendi varlık kimliklerinizden ayrı tutun.
- TRY gösteriyorsanız kur kaynağını ve yuvarlama kuralını tek bir yerde tanımlayın.
- Bayat veri, bulunamayan sembol ve sağlayıcı hatası için geri düşüş durumları ekleyin.
- Yayın öncesi atıf, kullanım koşulları ve ticari kullanım gerekliliklerini gözden geçirin.
SSS
Kripto fiyatlarını TRY cinsinden göstermek için hangi API'yi kullanmalıyım?
Doğrudan TRY paritesi için BtcTurk'ün halka açık piyasa endpoint'leri ve Genelpara'nın kripto servisi pratik seçeneklerdir. Global bir API'den USD alıp kendi kurunuzla çevirmek de mümkündür, ancak o durumda kur kaynağını ve yuvarlama kuralını kendiniz tanımlamanız gerekir.
Cüzdan ve portföy verisi de gerekiyorsa ne yapmalıyım?
CoinStats bu listede piyasa verisiyle cüzdan bakiyesi, DeFi pozisyonu ve portföy analitiğini tek API'de birleştiren seçenektir. Alternatifi, ayrı bir piyasa verisi sağlayıcısı ile ayrı bir cüzdan indeksleyiciyi kendiniz birleştirmektir.
Bu API'ler ücretsiz mi?
BtcTurk, Genelpara, CoinPaprika ve Binance'in halka açık piyasa endpoint'leri ücretsiz kullanılabilir. CoinStats ücretsiz katman sunar ancak kullanım kredi bazlı ölçümlenir ve kredi maliyeti endpoint'e göre değişir. Üretim öncesi her sağlayıcının güncel fiyatlandırma ve limit sayfasını kontrol edin.
Borsa API'si mi yoksa toplulaştırılmış veri API'si mi seçmeliyim?
Ürününüzde belirli bir borsanın kendisi öne çıkıyorsa borsa API'si kullanın; emir defteri ve o borsaya özgü semboller oradan gelir. Varlık bazlı genel fiyat ve piyasa değeri gösteriyorsanız toplulaştırılmış bir API daha uygundur.
Frontend'den doğrudan kripto API'si çağırabilir miyim?
Üretimde önerilmez. Önbellekleme, hız sınırı yönetimi, hata normalizasyonu ve API anahtarının gizlenmesi için istekleri kendi backend'iniz veya edge katmanınız üzerinden geçirin.
İlgili API Deposu kayıtları
Kaynaklar
Sık Sorulan Sorular
›Kripto fiyatlarını TRY cinsinden göstermek için hangi API'yi kullanmalıyım?
Doğrudan TRY paritesi için BtcTurk'ün halka açık piyasa endpoint'leri ve Genelpara'nın kripto servisi pratik seçeneklerdir. Global bir API'den USD alıp kendi kurunuzla çevirmek de mümkündür, ancak o durumda kur kaynağını ve yuvarlama kuralını kendiniz tanımlamanız gerekir.
›Cüzdan ve portföy verisi de gerekiyorsa ne yapmalıyım?
CoinStats bu listede piyasa verisiyle cüzdan bakiyesi, DeFi pozisyonu ve portföy analitiğini tek API'de birleştiren seçenektir. Alternatifi, ayrı bir piyasa verisi sağlayıcısı ile ayrı bir cüzdan indeksleyiciyi kendiniz birleştirmektir.
›Bu API'ler ücretsiz mi?
BtcTurk, Genelpara, CoinPaprika ve Binance'in halka açık piyasa endpoint'leri ücretsiz kullanılabilir. CoinStats ücretsiz katman sunar ancak kullanım kredi bazlı ölçümlenir ve kredi maliyeti endpoint'e göre değişir. Üretim öncesi her sağlayıcının güncel fiyatlandırma ve limit sayfasını kontrol edin.
›Borsa API'si mi yoksa toplulaştırılmış veri API'si mi seçmeliyim?
Ürününüzde belirli bir borsanın kendisi öne çıkıyorsa borsa API'si kullanın; emir defteri ve o borsaya özgü semboller oradan gelir. Varlık bazlı genel fiyat ve piyasa değeri gösteriyorsanız toplulaştırılmış bir API daha uygundur.
›Frontend'den doğrudan kripto API'si çağırabilir miyim?
Üretimde önerilmez. Önbellekleme, hız sınırı yönetimi, hata normalizasyonu ve API anahtarının gizlenmesi için istekleri kendi backend'iniz veya edge katmanınız üzerinden geçirin.