PancakeSwap API nedir? Belgeler ne diyor, ne arşivli
PancakeSwap, ölçtüğüm gün BNB Smart Chain DEX hacminin yüzde 91,8'ini taşıdı, ama belgelenmiş bir REST API'si yok. Dokümanların gerçekte ne sunduğunu ve en üst Google sonucunun neden bir 500 hatasına çıktığını anlatıyoruz.
Kısa cevap. PancakeSwap bir REST API belgelemiyor. Geliştirici dokümanlarının API'ler bölümünde tam olarak bir sayfa var, ve o sayfa subgraph'lar hakkında: iki barındırma sağlayıcısına bölünmüş 17 tanesi, bunların üçü işlem verisiyle ilgili.
İnsanların hatırladığı REST API, pancake-info-api idi. Kasım 2022'de arşivlendi. Sunucusu hâlâ ayakta ve hâlâ yanıt veriyor, ki bir öğleden sonranızı çalan kısım da bu.
PancakeSwap, DEX veri soruları arasında sıra dışı bir vaka, çünkü protokol neredeyse zincirin tamamı. 22 Eylül 2026'da BNB Smart Chain DEX hacminin %91,8'ini taşıdı. BSC üzerine ne inşa ediyor olursanız olun, çoğunlukla PancakeSwap üzerine inşa ediyorsunuz demektir.
Bu da onun genel veri yüzeyinin durumunu düzgün ortaya koymayı değerli kılıyor. Aşağıda dokümanların gerçekte neyi belgelediği, en üst Google sonuçlarının sizi nereye göndereceği, ve o gün BSC'nin nasıl göründüğü var. Yöntem en sonda.
PancakeSwap'ın belgelediği, ve belgelemediği
developer.pancakeswap.finance adresindeki geliştirici dokümanlarının bir API'ler menüsü var. Bir alt sayfası var, /apis/subgraph, ve ikinci bir girdi yok. REST referansı yok, OpenAPI belgesi yok, PancakeSwap'a ait barındırılan bir sorgu endpoint'i yok.
O sayfa 17 subgraph listeliyor. Çoğu işlemle ilgili değil:
Yani işe yarayan yüzey üç subgraph, ve her biri bir zincirdeki bir sürüme özgü. Exchange V2 ve V3, BSC, Ethereum, Arbitrum, zkSync, Linea, Base ve opBNB için ayrı ayrı listeleniyor. StableSwap yalnızca BSC ve Arbitrum için listeleniyor.
Nerede barındıklarında bir tuhaflık var. BSC ve opBNB, NodeReal'e işaret ediyor, geri kalan her şey The Graph'a. Tek bir protokol için iki sağlayıcı, iki farklı koşul seti, iki farklı hesap açma yeri. Dokümanlar ayrıca "Güncel sürüm için lütfen Github deposuna bakın" diye açılıyor, ki bu makul bir şey ve aynı zamanda gerçek doğruluk kaynağının nerede olduğunun bir işareti.
Dikkat çeken bir boşluk daha var. Dokümanların ön sayfası, PancakeSwap Infinity'yi borsanın bir sonraki sürümü olarak duyuruyor. Subgraph sayfası Infinity'den hiç bahsetmiyor.
Hâlâ sıralanan arşivlenmiş depo, ve götürdüğü 500 hatası
PancakeSwap API'yi arayın, github.com/pancakeswap/pancake-info-api Google'ın ilk sayfasında çıkar. 329 yıldızı var ve kendini "PancakeSwap zincir üstü veri sorgusu için sunucusuz API uygulaması" olarak tanımlıyor, ki tam olarak aradığınız şey gibi geliyor.
2022'den beri arşivlenmiş durumda. Son commit'i 13 Kasım 2022'de yapıldı.
İnsanlara zaman kaybettiren kısım burada. Belgelediği sunucu hâlâ çalışıyor. 22 Eylül 2026'da çağırmak:
curl "https://api.pancakeswap.info/api/v2/summary"
HTTP 500
{"error":{"code":500,"message":"Network error: request to
https://error.thegraph.com/apierror.json failed, reason:
getaddrinfo ENOTFOUND error.thegraph.com"}}
O hatayı okuyun. Bir 404 değil ve bir bakım sayfası değil. Kendi arka ucu, The Graph barındırılan subgraph'larını emekliye ayırdığında ortadan kaybolan, bir 500 içine sarılmış bir DNS hatası döndüren canlı bir servis. Buna entegrasyon sırasında rastlarsanız, her şey bunun geçici bir sorun olduğunu ve tekrar denemeye değdiğini düşündürür. Değil. Hiçbir şey geri gelmiyor.
PancakeSwap, 22 Eylül 2026'da BNB Smart Chain'in %91,8'iydi
O gün BSC'de on üç DEX hacim taşıdı. Üçü PancakeSwap'tı:
Kalan kısım için bağlam vermek gerekirse, PancakeSwap dışındaki en büyük mecra $75.247.512 ile Uniswap v3 oldu, hemen ardından $68.607.214 ile Uniswap v4 geldi. İkisi birlikte diğer %8,2'lik dilimin çoğunu oluşturuyor.
Tek bir sürüm yetmiyor, ve hangisi olduğu yazı turaya yakın
O gün V3, PancakeSwap'ın hacminin %51,5'ini aldı, V2 ise %48,5'ini. BSC'ye yalnızca V3'e bakan bir subgraph yöneltirseniz, protokolün yaklaşık yarısını okuyor olursunuz, ve hiçbir şeyin eksik olduğuna dair bir işaret gelmez.
Havuz sayıları diğer yöne çekiyor ve bir indeks planlamadan önce bilinmeye değer. V2, V3'ün 3.340'ına karşı 41.305 havuz tutuyor. V3, benzer bir hacmi on ikide bir kadar havuza sıkıştırıyor, yani yalnızca V2'ye bakan bir görünümde uzun kuyruk var, yalnızca V3'e bakan bir görünümde ise derinlik. İkisine de ihtiyacınız var, ki bu daha başlamadan zincir başına iki subgraph demek.
PancakeSwap havuzları için tek bir çağrı
Diğer yol, her sürümü zaten taşıyan bir indekse yapılan bir REST çağrısı. Anahtar yok, kayıt yok, GraphQL yok:
curl "https://api.dexpaprika.com/networks/bsc/pools/search?dex_name=pancakeswap_v3&limit=3"
Bu, HTTP 200 ve {results, has_next_page, next_cursor, query} şeklinde bir nesne döndürür. Satırlar id, dex_id, dex_name, chain, volume_usd_24h, volume_usd_7d, volume_usd_30d, liquidity_usd, transactions_24h, price_usd, fee, created_at, created_at_block_number, dört price_change_percentage_* penceresi ve bir tokens dizisi taşır.
pancakeswap_v3'ü pancakeswap_v2 veya pancakeswap_stable ile değiştirin, şekil değişmez. Görünen adı değil id'yi kullanın: dex_name tanımlayıcıyı alır, görünen ad bir hata yerine boş bir results ile 200 döndürür.
Bu havuzlardan herhangi biri için mumlar ve tekil swap'lar, /networks/bsc/pools/{address}/ohlcv ve /networks/bsc/pools/{address}/transactions'tan gelir, ki bu, bir subgraph'ın yalnızca birisi onun için varlığı (entity) yazdıysa size verdiği bir şey. Swap'lar endpoint'i, 30 Eylül 2026'dan beri api-pro.dexpaprika.com adresinde Dev ya da Pro planı gerektiriyor.
Havuz aramasını ve mumları denemek için anahtarsız çağrılar yeterli. console.dexpaprika.com adresinden ücretsiz bir anahtar hızı ve kotayı yükseltir, güncel rakamlar her katman için bu makalede değil fiyatlandırma sayfasında yer alıyor, çünkü sürekli değişiyorlar. Üzerine inşa etmeden önce bilmekte fayda var: ücretsiz katmandaki veri en fazla 60 saniye gecikmeli olabilir, ve gerçek zamanlı olan ücretli katman.
Sık sorulan sorular
PancakeSwap'ın bir API'si var mı?
Belgelediği bir REST API yok. Geliştirici dokümanlarının API'ler bölümünde tek bir sayfa var ve subgraph'ları kapsıyor. Piyasa verisi için The Graph üzerinde, ya da BSC ve opBNB için NodeReal üzerinde bir subgraph sorgularsınız, ya da PancakeSwap havuzlarını bunları zaten kapsayan bir indeksten okursunuz.
PancakeSwap API hız sınırları neler?
Alıntılanacak bir PancakeSwap hız sınırı yok, çünkü sınırlandırılacak PancakeSwap tarafından işletilen bir API yok. Sınırlarınız, sorguladığınız subgraph'ı barındıran tarafın, The Graph ya da NodeReal'in, kendi koşulları altında geliyor.
api.pancakeswap.info hâlâ çalışıyor mu?
Hayır. Yanıt veriyor, ki kafa karıştırıcı olan kısım bu, ama error.thegraph.com için bir DNS hatasıyla HTTP 500 yanıtı veriyor. Arkasındaki depo Kasım 2022'de arşivlendi.
PancakeSwap verisi için bir API anahtarına ihtiyacınız var mı?
Subgraph yolu için evet, zincire bağlı olarak The Graph'tan ya da NodeReal'den. PancakeSwap'ın kendisi hiçbir anahtar vermiyor.
Hangi PancakeSwap sürümünü indekslemeliyim?
22 Eylül 2026'nın kanıtına göre hem V2 hem V3'ü, o gün hacmi %51,5'e %48,5 paylaştıklarında. StableSwap, diğer ikisi kabaca $800 milyon civarındayken $291.276 ile BSC'de ihtiyaç duyana kadar bekletilecek kadar küçük.
PancakeSwap hangi zincirlerde çalışıyor?
Subgraph sayfası, hem Exchange V2 hem Exchange V3 için BSC, Ethereum, Arbitrum, zkSync, Linea, Base ve opBNB'yi, StableSwap için ise BSC artı Arbitrum'u listeliyor. Bu yazıdaki rakamlar yalnızca BSC için, ki hacmin olduğu yer de burası.
Bu rakamlar nasıl ölçüldü
Yukarıdaki her şey 22 Eylül 2026'da canlı bir kaynaktan okundu.
Subgraph envanteri ve zincir listeleri developer.pancakeswap.finance/apis/subgraph'tan geliyor, göz gezdirmek yerine ayrıştırılarak: 17 girdi, ve API'ler menüsünün bir alt sayfası olduğu iddiası, o sayfadaki her /apis/ bağlantısının bir kontrolü, ki tam olarak bir tane döndürüyor. Infinity boşluğu, aynı sayfada dokümanların ön sayfasındaki duyuruya karşı yapılan bir kelime sayımı.
pancakeswap/pancake-info-api'nin arşiv durumu, archived: true ve 13 Kasım 2022'lik bir son push bildiren GitHub API'sinden geliyor. 500 hatası gerçek bir çağrı, olduğu gibi alıntılandı, ve onu bir değil iki yola karşı çalıştırdım.
BSC tablosu, GET /networks/bsc/dexes'in api.dexpaprika.com'a karşı tek bir kez, anahtarsız çalıştırılmasından geliyor; her satır ve her iki toplam da sütunların toplamı tutsun diye aynı yanıttan. Havuz araması çalıştığı gibi alıntılandı ve 200 döndürdü.
Hacim rakamları, ölçüm anında kapanan 24 saatlik bir pencere ve hareket etmiş olacak. V2'ye karşı V3 bölünmesi, önümüzdeki ay farklı görünmesi en muhtemel rakam, ve bir şey planlamadan önce tekrar çalıştırmaya değer olan da bu.
Tam REST referansı docs.dexpaprika.com adresinde, ve BSC'de PancakeSwap için canlı swap akışı olan bir sayfa var.
Aynı soru iki başka DEX için: Uniswap API'sinin döndürdüğü şey, ve Raydium API'sinin Solana'da neyi kapsadığı.
Original CoinPaprika guide.