Uniswap API nedir? Piyasa verisi ve geçmiş nereden geliyor

Uniswap API'yi arayın, karşınıza çıkan her sonuç swap yapmakla ilgili olacak. Resmi dokümantasyon, routing-api deposu, uygulamanın kendisi. Hepsi Uniswap üzerinden nasıl işlem yapılacağı sorusunu yanıtlıyor, hiçbiri ise çoğu insanın gerçekte sorduğu soruyu, yani fiyatların ve geçmiş verilerin nereden geldiğini yanıtlamıyor.

Bunlar sahipleri farklı iki ayrı ürün. Aşağıda her birinin neyi kapsadığını, veri yolunun maliyetini ve Uniswap'ın farklı dağıtımlarında 22 Eylül 2026'da ölçtüğüm üç şeyi bulacaksınız. Yöntem en sonda.

Uniswap API'si gerçekte ne yapıyor

Uniswap'ın API dediği ürün Swapping API ve developers.uniswap.org adresinde belgeleniyor. Dört belgelenmiş endpoint'i var ve hepsi bir işlem yapma sürecinin adımları.

Çağrılar anahtarınızı bir x-api-key başlığında taşır. Desteklenen zincirler sayfası 21 mainnet listeliyor: Ethereum, OP Mainnet, BNB Smart Chain, Unichain, Polygon, Monad, X Layer, zkSync, World Chain, Soneium, Tempo, MegaETH, Robinhood Chain, Arc, Base, Arbitrum, Celo, Avalanche, Ink, Linea ve Zora, artı üç testnet.

/quote'un bir fiyat akışıyla karıştırılan endpoint olduğunu söylemek gerek, ve neden öyle olmadığını netleştirmekte fayda var. Bu endpoint bir işlemin fiyatını verir: bu kadar bu token'dan, şu token'a, şu anda, bu rota üzerinden, bu kayma (slippage) ile. Aynı soruyu farklı büyüklüklerle iki kere sorun, farklı sayılar alırsınız, çünkü bir fiyat teklifinin işi tam olarak budur. Size havuzun dün ne yaptığını, ne kadar derin olduğunu ya da bu sabah kaç kişinin işlem yaptığını söylemez.

Uniswap sizi piyasa verisi için nereye yönlendiriyor

Uniswap'ın veri sorusuna cevabı subgraph'lar, ve kendi dokümantasyonu bunların durumu konusunda oldukça açık sözlü. İki cümleyi doğrudan alıntılamakta fayda var.

O ikinci cümleyi bir daha okuyun, çünkü insanları şaşırtan kısım orası. Bu anahtar bir Uniswap anahtarı değil ve faturalandırma bir Uniswap faturası değil. İkisi de The Graph'a ait. Oraya kayıt olursunuz, oraya ödeme yaparsınız, ve Uniswap işlemin hiçbir yerinde yer almaz.

Uniswap ayrıca listelediği dağıtımlara bir uyarı ekliyor: bunların "resmi dağıtımlar olmadığını ve Uniswap Labs tarafından aktif olarak bakımının yapılmayabileceğini" söylüyor ve üretimde bunu kullanan herkese kendi subgraph'ını kendisinin dağıtmasını öneriyor. Bu dürüst bir uyarı ve olduğu gibi kabul edilmeli: bağımlı olmak üzere olduğunuz şey, Uniswap'ın bakımını yapmadığını size zaten söylediği, topluluk tarafından işletilen bir altyapı.

The Graph'ın maliyeti ne kadar, ve maliyet neden sorun değil

The Graph'ın kendi fiyatlandırma sayfasından 22 Eylül 2026'da okunan rakamlar: ayda 100.000 sorgu ücretsiz, sonrasında her 100.000 sorgu için $2, kart veya GRT ile ödenebilir.

Bu, ne olduğu düşünüldüğünde düşük bir fiyat, ve buna saldırmaya çalışan herhangi bir yazı hem yanlış hem de kolayca çürütülür olurdu. Uniswap verisiyle aranızdaki tek şey fatura olsaydı, burada yazılacak hiçbir şey olmazdı.

Sürtünme şekil ve bakımdan kaynaklanıyor. Bir subgraph tek bir zincirdeki tek bir protokol sürümüne özgü, yani Uniswap'ı düzgün kapsamak sürüm başına ve zincir başına bir endpoint demek, her birinin kendi şema tuhaflıkları, kendi senkronizasyon durumu ve kendi bakımcısı var. Her biri için ayrı GraphQL yazıyorsunuz, hangisinin geride kaldığını ayrı ayrı öğreniyorsunuz, ve Uniswap size bunları canlı tutan taraf olmadığını zaten söylemiş durumda.

v4, Eylül 2026'da Ethereum'da v3'ü geçti

Sürüm bazlı bu meselenin eskisinden daha önemli olmasının nedeni burada. Uniswap'ın Ethereum'daki üç aktif sürümü, 24 saatlik hacim, 22 Eylül 2026'da ölçüldü:

v4 artık Ethereum'da ikisinin büyüğü. Bir yıl önce tamamen mantıklı olan, hâlâ sadece v3'e bakan bir subgraph'ı Ethereum'a yönlendiren biri, piyasanın küçük yarısını okuyor ve bir token'ın gerçek hacmini olduğundan kabaca yarı yarıya az görüyor demektir. Hiçbir şey bozulmuyor, hiçbir hata verilmiyor, sayılar sadece fark edilmesi zor bir yönde yanlış oluyor.

Fiyatlandırma sayfasının size göstermediği bakım maliyeti bu. $2 değil. Bölünmenin ne zaman kaydığını bilmek demek.

Robinhood Chain'deki her DEX Uniswap

Ölçüm sırasında ortaya çıkan ikinci şey. Robinhood Chain'deki tüm DEX'leri isteyin, üç satır dönüyor. Üçü de Uniswap.

Yanıtta rakip hiçbir protokol görünmüyor. Yayınlamadan önce çağrıyı tekrar çalıştırdım, çünkü bu kadar temiz bir sonuç genelde bir yerde açık kalmış bir filtre anlamına gelir. Öyle değildi.

Bunun sürüm sorusuna ne yaptığına dikkat edin. Robinhood Chain'de yalnızca v3'e bakan bir subgraph $672 milyonu yakalar ama v4 ve v2 üzerinden akan, zincirin kabaca %45'ine denk gelen $541 milyonu kaçırırdı. v4 havuzları aynı zamanda uzun kuyruğun yaşadığı yer: zincirin 24.263 havuzunun 20.536'sı v4'te, 2.920'si v3'te.

Uniswap havuzlarını subgraph olmadan okumak

Diğer yol, her sürümü her zincirde zaten kapsayan bir indekse yapılan bir REST çağrısı. DexPaprika'nın yaptığı da bu, ve aşağıdaki çağrı ne anahtar, ne kayıt ne de GraphQL gerektiriyor:

Bu, {results, has_next_page, next_cursor, query} şeklinde bir nesneyle HTTP 200 döndürür. Her satır 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_* penceresini ve bir tokens dizisini taşır.

uniswap_v4'ü uniswap_v3 veya uniswap_v2 ile değiştirin, şekil değişmez, asıl mesele de bu: her biri için ayrı bir subgraph yerine sürümler ve zincirler arasında tek bir şema.

Bunu denemek için anahtarsız çağrılar yeterli. console.dexpaprika.com adresinden alacağınız ücretsiz bir anahtar hızı ve kotayı yükseltir, ve her katman için güncel rakamlar bu makalede değil fiyatlandırma sayfasında yer alıyor, çünkü sürekli değişiyorlar. Üzerine bir şey inşa etmeden önce bilmekte fayda var: ücretsiz katmandaki veri en fazla 60 saniye gecikmeli olabilir. Gerçek zamanlı olan, ücretli katman.

Hangi zincirler hangi Uniswap sürümlerini taşıyor

Uniswap'ın işlem API'si 21 mainnet'i destekliyor. DexPaprika, 22 Eylül 2026'da ölçüldüğünde, Uniswap piyasa verisini bunların 13'ünde indeksliyor:

Bu tablonun neyi iddia edip neyi iddia etmediği konusunda net olmak lazım. Uniswap'ın işlem API'si bu listedekinden daha fazla zincire ulaşıyor. Buradaki iddia daha dar: bu 13 zincirde, Uniswap'ın API'sinin cevaplamadığı piyasa verisi sorusu, sürüm başına bir subgraph olmadan, tek bir şema altında cevaplanıyor.

Ethereum'da Uniswap, Base, Arbitrum, Polygon ve Monad için canlı swap akışı olan zincire özel sayfalar var.

Sık sorulan sorular

Uniswap'ın bir API'si var mı?

Evet, onaylar, fiyat teklifleri, UniswapX emirleri ve klasik swap'lar için dört belgelenmiş endpoint'i olan Swapping API. İşlem yapmak için tasarlanmış. Havuz rezervlerini, geçmiş fiyatları, OHLCV mumlarını ya da swap geçmişini döndürmüyor.

Uniswap için bir API anahtarına ihtiyacınız var mı?

Swapping API bir x-api-key başlığında anahtar alıyor. Veri için ihtiyacınız olan anahtar, The Graph'ın Studio'sunda oluşturulan bir Graph API anahtarı, ve sizi bunun için faturalandıran da The Graph.

Uniswap API'si geçmiş fiyatları veriyor mu?

Hayır. Geçmiş fiyatlar ve mumlar, The Graph üzerinde sorguladığınız bir subgraph'tan, ya da Uniswap havuzlarını doğrudan indeksleyen bir piyasa verisi API'sinden geliyor.

Uniswap'ın barındırılan subgraph'ına ne oldu?

Kullanımdan kaldırıldı. Uniswap'ın dokümanları artık sizi The Graph'ın Studio'sundan alınan bir anahtarla merkeziyetsiz ağa yönlendiriyor ve listelenen dağıtımların resmi olmadığını, Uniswap Labs tarafından aktif olarak bakımının yapılmayabileceğini belirtiyor.

Hangi Uniswap sürümünü indekslemeliyim?

22 Eylül 2026 itibarıyla Ethereum'da v4, v3'ten daha fazla 24 saatlik hacim taşıyor, ve v2 hâlâ günde $62 milyon yapıyor. Tek bir sürümü tek başına indekslemek, birden fazla sürümde işlem gören herhangi bir token'ı olduğundan düşük gösterir.

Uniswap API'sinde bir hız sınırı var mı?

Uniswap, Swapping API'sinin sınırlarını anahtarınıza göre belgeliyor. Veri tarafında alıntılanacak tek bir Uniswap sınırı yok, çünkü ya The Graph'ın koşulları altında The Graph'ı, ya da kendi koşulları altında üçüncü taraf bir API'yi sorguluyorsunuz.

Bu rakamlar nasıl ölçüldü

Yukarıdaki her şey 22 Eylül 2026'da canlı bir kaynaktan okundu.

Endpoint ve zincir listeleri o gün okunan developers.uniswap.org'dan geliyor. Alıntılanan iki cümle, Uniswap'ın subgraph dokümantasyonundaki kendi ifadeleri. The Graph'ın rakamları The Graph'ın fiyatlandırma sayfasından geliyor.

Hacim tabloları şöyle oluşturuldu: her zincir için GET /networks/{chain}/dexes çağrısı api.dexpaprika.com'a karşı bir kez çalıştırıldı, anahtarsız ve temposu ayarlanmış biçimde, ve her zincirdeki Uniswap girdileri toplandı. Belirli bir tablodaki her rakamın aynı yanıttan gelmesi göründüğünden daha önemli: GET /networks içindeki zincir düzeyi toplamlar ile /dexes içindeki DEX başına toplamlar ayrı ayrı hesaplanıyor ve birbirinden yaklaşık yüzde 0,05 kadar ayrılıyor, bu da birini diğerine bölmenin %100'ün üzerinde bir pay çıkarabilmesine yetiyor. Robinhood Chain bölümünün bir yüzde vermek yerine zincirin neyden oluştuğunu belirtmesinin nedeni bu.

Her rakam, ölçüm anında kapanan 24 saatlik bir pencere, yani bunu okuduğunuzda değişmiş olmasını bekleyin. Ethereum'daki sürüm bölünmesi en çabuk eskiyecek iddia, ve ona güvenmeden önce tekrar çalıştırmaya değer olan da bu.

Arayıp da bulamayabileceğiniz, olumsuz sonuçlanan iki kontrol daha var. /networks/{chain} bir endpoint değil ve Ethereum dahil her zincirde 404 döndürüyor, buna karşı bir şey inşa etmeyin. Ve arama results satırları, başka yerlerdeki eski örnekler ne gösterirse göstersin, bir pair alanı taşımıyor.

Tam REST referansı docs.dexpaprika.com adresinde. Uniswap'ın tüketici tarafını arıyorsanız, Uniswap'ta token swap yapmak için adım adım bir rehberimiz var.

Aynı soru iki başka DEX için: Raydium API'sinin Solana'da neyi kapsadığı, ve PancakeSwap'ın BNB Smart Chain için neyi belgelediği.