Bitcoin API Rehberi
Geliştiriciler İçin 2026
Mempool.space, Bitcoin Core RPC, CoinGecko ve WebSocket entegrasyonu için kod örnekleriyle kapsamlı rehber. Python, JavaScript ve TypeScript.
API Kategorileri
Blok Zinciri Verisi
İşlemler, bloklar, adres bakiyeleri, UTXO setleri. Mempool.space, Blockstream.info.
Fiyat ve Piyasa
Bitcoin fiyatı, işlem hacmi, piyasa değeri. CoinGecko, CoinMarketCap, borsa API'leri.
Ağ Durumu
Mempool doluluğu, ücret önerileri, hash rate, zorluğu. Mempool.space, blockchain.info.
Düğüm RPC
Kendi Bitcoin Core düğümünüzle tam erişim. İşlem yayınlama, cüzdan sorguları.
Mempool.space API
Ücretsiz, kimlik doğrulama gerektirmeyen ve Bitcoin geliştiricileri arasında en yaygın kullanılan API. Ücret önerileri, blok verileri ve işlem sorgulama için ideal.
Python — Ücret önerileri
import requests
def get_fee_recommendations():
url = "https://mempool.space/api/v1/fees/recommended"
response = requests.get(url)
fees = response.json()
print(f"Hızlı: {fees['fastestFee']} sat/vbyte")
print(f"Yarım Saat: {fees['halfHourFee']} sat/vbyte")
print(f"Bir Saat: {fees['hourFee']} sat/vbyte")
return fees
fees = get_fee_recommendations()JavaScript — Adres bakiyesi
async function getAddressBalance(address) {
const res = await fetch(
`https://mempool.space/api/address/${address}`
);
const data = await res.json();
const balanceSats =
data.chain_stats.funded_txo_sum -
data.chain_stats.spent_txo_sum;
return balanceSats / 1e8; // BTC cinsinden
}
getAddressBalance('bc1q...').then(console.log);Bitcoin Core RPC
Kendi düğümünüzü çalıştırıyorsanız en güçlü seçenek. Tüm blok zinciri verilerine tam erişim, işlem yayınlama ve ham işlem oluşturma.
Python — bitcoin-rpc kütüphanesi
from bitcoinrpc.authproxy import AuthServiceProxy
rpc = AuthServiceProxy(
"http://kullanıcı:parola@127.0.0.1:8332"
)
# Blok bilgisi
block_count = rpc.getblockcount()
print(f"Güncel blok: {block_count}")
# Ücret tahmini (2 blok için)
fee = rpc.estimatesmartfee(2)
print(f"Tahmini ücret: {fee['feerate']} BTC/kB")Fiyat API'leri
TypeScript — CoinGecko fiyat sorgusu
interface BitcoinPrice {
bitcoin: { usd: number; try: number; eur: number };
}
async function getBitcoinPrice(): Promise<BitcoinPrice> {
const res = await fetch(
'https://api.coingecko.com/api/v3/simple/price' +
'?ids=bitcoin&vs_currencies=usd,try,eur'
);
return res.json();
}
const prices = await getBitcoinPrice();
console.log(`BTC/TRY: ₺${prices.bitcoin.try.toLocaleString()}`);WebSocket Gerçek Zamanlı
JavaScript — Mempool.space yeni blok bildirimi
const ws = new WebSocket('wss://mempool.space/api/v1/ws');
ws.onopen = () => {
ws.send(JSON.stringify({ action: 'want', data: ['blocks'] }));
};
ws.onmessage = (event) => {
const data = JSON.parse(event.data);
if (data.block) {
console.log('Yeni blok:', data.block.height);
console.log('Ücretler:', data.block.feeRange);
}
};API Sağlayıcı Karşılaştırması
| Sağlayıcı | Ücretsiz Katman | Auth Gerekli | Güçlü Yanı | Zayıf Yanı |
|---|---|---|---|---|
| Mempool.space | Sınırsız | Hayır | Ücretler, mempool | Fiyat verisi yok |
| Blockchain.info | Evet | Hayır | Adres verileri | Güncelliği değişken |
| CoinGecko | 10.000 çağrı/ay | Evet (ücretsiz) | Fiyat, hacim | Blok zinciri yok |
| Bitcoin Core RPC | Sınırsız (kendi) | Evet (lokal) | Tam erişim | Kendi düğüm gerekli |
| Blockstream.info | Evet | Hayır | Güvenilir blok verisi | Rate limit var |
Dile Göre Kütüphaneler
| Dil | Kütüphane | Kullanım |
|---|---|---|
| Python | bitcoin-rpc, bit, bitcoinlib | RPC, işlem oluşturma |
| JavaScript/TS | bitcoinjs-lib, @mempool/electrum-client | Tarayıcı ve Node.js |
| Rust | rust-bitcoin, bdk | Performans kritik uygulamalar |
| Go | btcd, lnd | Lightning Node entegrasyonu |
| Java | bitcoinj | Android uygulamaları |
Sıkça Sorulan Sorular
Bitcoin API entegrasyonu için nereden başlamalıyım?
Mempool.space API ile başlamanızı öneririz. Ücretsiz, kimlik doğrulama gerektirmiyor ve en önemli Bitcoin verilerini (ücretler, bloklar, işlemler) sunuyor. Fiyat verisi için CoinGecko ücretsiz katmanı yeterli.
Bitcoin Core RPC nedir?
Bitcoin Core RPC (Uzaktan Yordam Çağrısı), kendi çalıştırdığınız tam düğümle (full node) iletişim kurmanızı sağlar. JSON-RPC protokolü üzerinden blok zinciri verilerine tam erişim, işlem yayınlama ve cüzdan yönetimi sunar. En yüksek egemenlik ve güvenilirlik için idealdir.
En iyi ücretsiz Bitcoin API hangisi?
Mempool.space API (blok ve ücret verileri için), CoinGecko ücretsiz katmanı (fiyat için) ve Blockchain.com API (temel adres verileri için) en iyi ücretsiz seçenekler. Üretim uygulamaları için ücretli planlar veya kendi düğümünüz önerilir.
WebSocket veya REST API mi kullanmalıyım?
Gerçek zamanlı veriler (canlı fiyat, yeni bloklar, mempool değişiklikleri) için WebSocket. Tek seferlik veya periyodik sorgular için REST API. Uygulamanız canlı güncellemeler gerektirmiyorsa REST daha basit ve bakımı kolay.
Bitcoin fiyat verisi için hangi API kullanılır?
CoinGecko ve CoinMarketCap en yaygın fiyat API'leri. Her ikisi de birden fazla borsadaki ortalamayı hesaplıyor. Yüksek frekanslı veri için Kraken veya Bitstamp gibi borsa API'leri daha güncel. BtcTurk gibi Türk borsaları da kendi API'lerini sunuyor.
Kendi Bitcoin düğümümü çalıştırmalı mıyım?
Üretim uygulamaları ve maksimum güvenilirlik için evet. Üçüncü taraf API'lere bağımlı kalmak merkezi başarısızlık noktası oluşturur. Kendi Bitcoin Core düğümünüz sınırsız RPC erişimi, maksimum doğruluk ve üçüncü taraf servislerine sıfır bağımlılık sağlar.
Bitcoin API hata işleme nasıl yapılır?
Eksponansiyel geri çekilme ile yeniden deneme mantığı uygulayın. 429 (rate limit) hatalarını yakalayın ve sınır penceresini bekleyin. Kritik veriler için birden fazla sağlayıcıya yedekleme yapın. Yanıtları önbelleğe alın: Bitcoin ücret tahminleri 5-10 dakikada bir güncelleme yeterli.
Python'da Bitcoin API nasıl kullanılır?
requests kütüphanesiyle basit GET çağrısı yapılır: `import requests; resp = requests.get("https://mempool.space/api/v1/fees/recommended"); fees = resp.json()`. Daha gelişmiş kullanım için bitcoin-rpc veya bit kütüphanelerini inceleyin.
Bitcoin API'leri Türk borsalarıyla çalışır mı?
BtcTurk ve Paribu kendi REST API'lerini sunuyor. Fiyat ve order book verilerini bu API'lerle çekebilirsiniz. CoinGecko ve CoinMarketCap da BtcTurk verilerini kısmen barındırıyor. Entegrasyon için resmi API belgelerine başvurun.
Lightning Network için API var mı?
Evet. LND (Lightning Network Daemon) ve CLN (Core Lightning) REST ve gRPC API'leri sunuyor. Amboss.space ve Terminal.lightning.engineering gibi servisler Lightning ağı verilerini API ile erişilebilir hâle getiriyor. Lightining ödemeleri kabul etmek için Strike API ve OpenNode popüler seçenekler.
API rate limit nedir ve nasıl yönetilir?
Rate limit, API sağlayıcısının belirli bir zaman aralığında kabul ettiği maksimum istek sayısı. Aşıldığında 429 HTTP hatası döner. Çözüm: istekler arasına gecikme ekleyin, yanıtları önbelleğe alın ve gerekirse ücretli plan alın. Mempool.space ücretsiz kullanımda dakikada 10 istek destekler.
Bitcoin ile Geliştirmeye Başlayın
API entegrasyonunu tamamladıktan sonra Bitcoin işlemlerini ve ücretleri daha iyi anlayın.