Uniswap API: co zwraca i skąd brać dane rynkowe

Wyszukaj Uniswap API, a każdy wynik dotyczy handlu. Oficjalna dokumentacja, repozytorium routing-api, sama aplikacja. Wszystkie odpowiadają na pytanie, jak handlować przez Uniswap, i żadne nie odpowiada na pytanie, które faktycznie zadaje większość osób: skąd biorą się ceny i historia.

To dwa różne produkty, z dwoma różnymi właścicielami. Poniżej znajdziesz, co obejmuje każdy z nich, ile kosztuje ścieżka danych oraz trzy rzeczy, które zmierzyłem we wdrożeniach Uniswap 22 września 2026. Metodologia jest na końcu.

Co faktycznie robi Uniswap API

Produkt, który Uniswap nazywa swoim API, to Swapping API, udokumentowane pod adresem developers.uniswap.org. Ma cztery udokumentowane endpointy i wszystkie są krokami składania transakcji.

Wywołania przenoszą twój klucz w nagłówku x-api-key. Strona z obsługiwanymi sieciami wymienia 21 mainnetów: 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 i Zora, plus trzy testnety.

/quote to ten endpoint, który bywa mylony ze strumieniem cen, i warto dokładnie wyjaśnić, dlaczego nim nie jest. Wycenia transakcję: tyle tego tokena, na tamten token, w tej chwili, na tej trasie, z tym poślizgiem. Zadaj mu to samo pytanie dwa razy z różnymi wielkościami, a dostaniesz różne liczby, bo do tego służy wycena. Nie powie ci, co działo się w puli wczoraj, jak głęboka jest, ani ilu ludzi handlowało nią dziś rano.

Gdzie Uniswap kieruje cię po dane rynkowe

Odpowiedzią Uniswap na pytanie o dane są subgrafy, a własna dokumentacja Uniswap wprost mówi, w jakim są stanie. Warto zacytować dwa zdania wprost.

Przeczytaj to drugie zdanie jeszcze raz, bo to właśnie ta część zaskakuje ludzi. Ten klucz nie jest kluczem Uniswap, a rozliczenie nie jest rachunkiem od Uniswap. Oba należą do The Graph. Tam się rejestrujesz, tam płacisz, a Uniswap w ogóle nie uczestniczy w tej transakcji.

Uniswap dodaje też do wymienionych wdrożeń zastrzeżenie, że są to "nieoficjalne wdrożenia, które mogą nie być aktywnie utrzymywane przez Uniswap Labs", i zaleca, by każdy, kto uruchamia to produkcyjnie, wdrożył własny subgraf. To uczciwe ostrzeżenie i warto potraktować je dosłownie: infrastruktura, od której masz zamiar zależeć, jest prowadzona przez społeczność, a Uniswap sam powiedział ci, że jej nie utrzymuje.

Ile kosztuje The Graph i dlaczego koszt nie jest problemem

Odczytane wprost ze strony cennika The Graph, 22 września 2026: 100 000 zapytań miesięcznie bez opłat, a potem $2 za każde kolejne 100 000 zapytań, płatne kartą lub w GRT.

To niska cena, jak na to, co oferuje, i każdy artykuł, który próbowałby ją atakować, byłby po prostu błędny i łatwy do obalenia. Gdyby jedyną rzeczą stojącą między tobą a danymi Uniswap był rachunek, nie byłoby tu o czym pisać.

Problemem jest kształt i utrzymanie. Subgraf jest ograniczony do jednej wersji protokołu na jednym łańcuchu, więc pełne pokrycie Uniswap oznacza jeden endpoint na wersję na łańcuch, każdy z własnymi dziwactwami schematu, własnym stanem synchronizacji i własnym opiekunem. Piszesz GraphQL osobno do każdego z nich, osobno dowiadujesz się, gdy który z nich zaczyna zostawać w tyle, a Uniswap już ci powiedział, że to nie on go utrzymuje przy życiu.

v4 wyprzedził v3 na Ethereum we wrześniu 2026

Oto dlaczego kwestia poszczególnych wersji ma teraz większe znaczenie niż wcześniej. Trzy działające wersje Uniswap na Ethereum, wolumen 24-godzinny, zmierzony 22 września 2026:

v4 jest teraz większy z tych dwóch na Ethereum. Każdy, kto nadal kieruje subgraf tylko dla v3 na Ethereum, co jeszcze rok temu było całkowicie rozsądne, czyta mniejszą połowę rynku i zobaczy realny wolumen tokena na poziomie mniej więcej połowy tego, czym jest naprawdę. Nic się nie psuje, żaden błąd nie zostaje zgłoszony, liczby są po prostu błędne w sposób, który trudno zauważyć.

To jest ten koszt utrzymania, którego nie pokazuje strona cennika. To nie jest $2. To wiedza o tym, którego dnia zmienił się podział.

Każdy DEX na Robinhood Chain to Uniswap

Druga rzecz, która wyszła podczas pomiarów. Zapytaj o każdy DEX na Robinhood Chain, a dostaniesz trzy wiersze. Wszystkie trzy to Uniswap.

Żaden konkurencyjny protokół w ogóle nie pojawia się w odpowiedzi. Ponownie uruchomiłem to zapytanie przed publikacją, bo tak czysty wynik zwykle oznacza gdzieś zapomniany filtr. Tym razem nie było filtra.

Zwróć uwagę, co to robi z kwestią wersji. Subgraf tylko dla v3 na Robinhood Chain uchwyciłby $672 mln i pominąłby $541 mln przepływające przez v4 i v2, czyli mniej więcej 45% łańcucha. Pule v4 to też miejsce, gdzie żyje długi ogon: 20 536 z 24 263 pul łańcucha znajduje się na v4, wobec 2 920 na v3.

Odczytywanie pul Uniswap bez subgrafu

Inna droga to wywołanie REST do indeksu, który już obejmuje każdą wersję na każdym łańcuchu. Tak właśnie działa DexPaprika, a wywołanie poniżej nie wymaga klucza, rejestracji ani GraphQL:

Zwraca to HTTP 200 z obiektem w kształcie {results, has_next_page, next_cursor, query}. Każdy wiersz zawiera 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, cztery okna price_change_percentage_* oraz tablicę tokens.

Zamień uniswap_v4 na uniswap_v3 lub uniswap_v2, a kształt się nie zmieni, i to jest właśnie sedno sprawy: jeden schemat dla wszystkich wersji i łańcuchów zamiast jednego subgrafu na każdą taką parę.

Do wypróbowania wystarczą wywołania bez klucza. Darmowy klucz z console.dexpaprika.com podnosi limit zapytań i pulę kredytów, a aktualne liczby dla każdego planu znajdziesz na stronie cennika, a nie w tym artykule, bo się zmieniają. Jedna rzecz warta wiedzy, zanim zaczniesz na tym budować: dane w darmowym planie mogą być opóźnione nawet o 60 sekund. Dane w czasie rzeczywistym to plan płatny.

Które łańcuchy obsługują które wersje Uniswap

API transakcyjne Uniswap obsługuje 21 mainnetów. DexPaprika indeksuje dane rynkowe Uniswap na 13 z nich, zmierzone 22 września 2026:

Żeby było jasne, co ta tabela twierdzi, a czego nie. API transakcyjne Uniswap obejmuje więcej łańcuchów niż ta lista. Twierdzenie tutaj jest węższe: na tych 13 łańcuchach pytanie o dane rynkowe, na które API Uniswap nie odpowiada, ma odpowiedź, w jednym schemacie, bez subgrafu na każdą wersję.

Są też osobne strony dla każdego łańcucha z aktywnym strumieniem swapów na żywo dla Uniswap na Ethereum, Base, Arbitrum, Polygon i Monad.

Najczęstsze pytania

Czy Uniswap ma API?

Tak, Swapping API, z czterema udokumentowanymi endpointami do zatwierdzeń, wycen, zleceń UniswapX i klasycznych swapów. Zostało zbudowane do składania transakcji. Nie zwraca rezerw puli, danych historycznych, świec OHLCV ani historii swapów.

Czy potrzebujesz klucza API dla Uniswap?

Swapping API przyjmuje klucz w nagłówku x-api-key. Do danych potrzebujesz klucza Graph API utworzonego w Studio The Graph, i to The Graph cię za niego rozlicza.

Czy Uniswap API podaje ceny historyczne?

Nie. Ceny historyczne i świece pochodzą z subgrafu, który odpytujesz w The Graph, albo z API danych rynkowych, które indeksuje pule Uniswap bezpośrednio.

Co się stało z hostowanym subgrafem Uniswap?

Został wycofany. Dokumentacja Uniswap kieruje teraz do sieci zdecentralizowanej, z kluczem ze Studio The Graph, i zaznacza, że wymienione wdrożenia są nieoficjalne i mogą nie być aktywnie utrzymywane przez Uniswap Labs.

Którą wersję Uniswap powinienem indeksować?

Na Ethereum, stan na 22 września 2026, v4 ma wyższy wolumen 24-godzinny niż v3, a v2 nadal robi $62 mln dziennie. Indeksowanie tylko jednej wersji zaniży wynik każdego tokena, który handluje na kilku z nich naraz.

Czy istnieje limit zapytań API Uniswap?

Uniswap dokumentuje limity Swapping API względem twojego klucza. Dla ścieżki danych nie ma jednego limitu Uniswap do zacytowania, bo odpytujesz The Graph na warunkach The Graph, albo API firmy trzeciej na jej warunkach.

Jak zmierzono te liczby

Wszystko powyżej odczytano z żywego źródła 22 września 2026.

Listy endpointów i łańcuchów pochodzą z developers.uniswap.org, odczytanego tego dnia. Dwa zacytowane zdania to własne sformułowania Uniswap z dokumentacji subgrafów. Liczby The Graph pochodzą ze strony cennika The Graph.

Tabele wolumenu to jedno wywołanie GET /networks/{chain}/dexes na łańcuch, wobec api.dexpaprika.com, bez klucza i w odstępach czasu, sumujące wpisy Uniswap na każdym łańcuchu. Każda liczba w danej tabeli pochodzi z tej samej odpowiedzi, co ma większe znaczenie, niż się wydaje: sumy na poziomie łańcucha w GET /networks i sumy per DEX w /dexes są liczone osobno i różnią się o mniej więcej pół dziesiątej części procenta, co wystarczy, by dzielenie jednej przez drugą dało udział powyżej 100%. Dlatego sekcja o Robinhood Chain opisuje, z czego składa się łańcuch, zamiast podawać procent.

Każda liczba to okno 24-godzinne zamykające się w momencie pomiaru, więc oczekuj, że zdąży się zmienić, zanim to czytasz. Podział wersji na Ethereum to twierdzenie najbardziej narażone na dezaktualizację i warto je zmierzyć ponownie, zanim na nim polegasz.

Dwie rzeczy, które sprawdziłem i wyszły negatywnie, na wypadek gdybyś sam ich szukał. /networks/{chain} nie jest endpointem i zwraca 404 na każdym łańcuchu, łącznie z Ethereum, więc nie buduj niczego na tym założeniu. A wiersze results z wyszukiwania nie zawierają pola pair, cokolwiek pokazują starsze przykłady gdzie indziej.

Pełne API REST znajdziesz na docs.dexpaprika.com. Jeśli zamiast tego szukasz strony konsumenckiej Uniswap, mamy przewodnik krok po kroku po zamianie tokenów na Uniswap.

To samo pytanie dla dwóch innych DEX-ów: co obejmuje Raydium API na Solanie i co dokumentuje PancakeSwap dla BNB Smart Chain.