Balancer API: co obejmuje i głosowanie nad zamknięciem

Większość tego, co linkuje się przy okazji Balancera, to SDK albo subgraph, a jednak serwer GraphQL stojący za aplikacją Balancera jest publiczny, nie wymaga klucza i jest szczegółowy, aż po rozbicie APR na poszczególne tokeny nagród.

Poniżej znajdziesz to, co znalazłem, czytając ten schemat na żywo, co dodaje do niego indeks całego łańcucha, taki jak DexPaprika, jak mały jest udział Balancera na każdym łańcuchu, na którym mogłem to sprawdzić, oraz głosowanie zarządcze, które może zakończyć istnienie protokołu przed końcem roku. Metodologia na końcu, wraz z dwiema liczbami, które się nie zgadzają, i nie zamierzam udawać, że jest inaczej.

Co faktycznie daje Balancer API

Introspekcja schematu pod adresem api-v3.balancer.fi/graphql zwraca 25 pól zapytań najwyższego poziomu. Pogrupowane według przeznaczenia:

Odpowiada bez klucza, przez zwykłe POST:

Sam obiekt puli niesie więcej niż większość API pojedynczego DEX-a w ogóle oferuje: isPaused, isInRecoveryMode, holdersCount, aggregateSwapFee oraz tablicę aprItems typowaną na 19 kategorii nagród, od zwykłych opłat za swap po kampanie motywacyjne Aura i Merkl. Jeśli zadanie brzmi "opisz pulę Balancera" albo "ile zarabia ta pozycja LP", to jest właściwe narzędzie, a indeks całego łańcucha nie zrobi tego lepiej.

Co dodaje zamiast tego indeks całego łańcucha

Brakuje dwóch rzeczy i obie mają charakter strukturalny. Nie ma endpointu OHLCV, jest tylko poolGetSnapshots, dzienny zapis płynności, ceny udziału i wolumenu, który musiałbyś sam zamienić na świece. I nie ma niczego poza Balancerem. Enum GqlChain tego API wylicza 17 wartości, 16 działających sieci plus testnet Sepolia, ale każda z nich to własne wdrożenie Balancera. Zapytaj o Uniswap albo Curve na tym samym łańcuchu i żadne zapytanie nie odpowie.

To jest argument za indeksem obejmującym wiele DEX-ów: dane Balancera zawsze opisują wyłącznie Balancer. Schemat, który zwraca ten sam kształt dla każdego DEX-a na łańcuchu, pozwala porównać jeden protokół z dziewięcioma innymi bez dziewięciu osobnych integracji, i właśnie tam leży wartość DexPaprika konkretnie dla Balancera.

Udział Balancera w wolumenie DEX, 23 września 2026

DexPaprika indeksuje Balancer pod dwoma id: balancer_v2 na Arbitrum, Ethereum i Polygonie oraz balancer_v3 na Plasma, jego jedynym wdrożeniu v3 w tym zestawie. Zmierzone względem każdego wiersza DEX, jaki DexPaprika prowadzi dla danego łańcucha, z jednej migawki wykonanej o 22:17 UTC:

Zsumuj te cztery wiersze, a cały ślad Balancera zaindeksowany przez DexPaprika wychodzi na około $4,0 mln dziennie, wobec $69,5 mln całkowitego wolumenu DEX na samym Polygonie tego samego dnia. Polygon jest wyjątkiem z dużym marginesem: wszędzie indziej Balancer to poniżej jednej piątej procenta łańcucha.

Protokół głosujący nad tym, czy dalej działać

Dla każdego, kto integruje teraz Balancer, liczą się dwa zdarzenia. 3 listopada 2025, około 07:40 UTC, atakujący wykorzystał błąd zaokrągleń w matematyce skalowania Composable Stable Pools w Balancerze v2, ze stratami przekraczającymi $120 mln. Techniczne opracowania Certory i OpenZeppelin lokalizują błąd w matematyce puli stabilnej v2, a Certora stwierdza, że v3 nie było na niego narażone.

Potem, 14 września 2026, na własnym forum Balancera pojawiła się propozycja "uporządkowanego zamknięcia": brak nowego rozwoju biznesowego, pule przechodzą wyłącznie na wypłaty od 30 października 2026 tam, gdzie pozwalają na to kontrakty, a DAO zamyka się w zakresie prawnie i praktycznie możliwym. Harmonogram wyznacza głosowanie na Snapshot na 25 do 29 września 2026, dwa dni po pomiarach z tego artykułu. Jeśli przejdzie, od 1 listopada infrastruktura ogranicza się do uproszczonego interfejsu wypłat, potrzebnego pokrycia subgraph i publicznej dokumentacji, utrzymywanych przez obie tury dystrybucji skarbca do posiadaczy BAL, przy czym pierwsza otwiera się pod koniec maja 2027. Nie wszyscy na wątku się zgadzają: dzień po opublikowaniu propozycji zaproponowano tam fork jako inny kierunek.

Gdzie dwa odczyty wolumenu się nie zgadzają

Zapytałem własny protocolMetricsChain Balancera dziewięć minut po powyższej migawce DexPaprika, i te dwa źródła nie zgadzają się na żadnym z czterech łańcuchów:

Oba odczyty to 24-godzinny wolumen swapów, oba na żywo i bez klucza, z datą w odstępie dziesięciu minut od siebie. Na Ethereum, Arbitrum i Plasma własna liczba Balancera jest wyższa od naszej. Na Polygonie jest odwrotnie, ośmiokrotnie. Nie ustaliłem, która reguła liczenia daje tę różnicę, i nie zamierzam tu zgadywać. Jeśli liczba dla Balancera na Polygonie ma znaczenie dla tego, co budujesz, pobierz obie na żywo.

Świece i swapy dla puli Balancera

Najbardziej ruchliwą pulą Balancer V2 na Polygonie tego dnia była para USDC/USDT0, odpowiadająca za $595 957 z powyższego wolumenu, przy płynności poniżej $9 000. Oba poniższe wywołania działają bez klucza.

Świece godzinowe, których nic w schemacie Balancera nie produkuje bezpośrednio:

Każdy wiersz zawiera time_open, time_close, open, high, low, close i volume. Strumień pojedynczych swapów, który za tym stoi:

Wiersze zawierają token_0_symbol, token_1_symbol, obie kwoty, price_0_usd i price_1_usd, created_at i factory_id, przy czym to ostatnie wskazuje na kontrakt Balancer Vault, przez który przechodzi każda pula V2. Te same dwa wywołania, w tym samym kształcie, działają wobec każdego innego DEX-a na Polygonie, i o to właśnie chodzi w indeksowaniu całego łańcucha zamiast pojedynczego protokołu.

Do wypróbowania tego nie potrzeba klucza. Darmowy klucz z console.dexpaprika.com podnosi limit zapytań i pulę, aktualne liczby dla każdego planu znajdziesz na stronie cennika, bo się zmieniają, i warto wiedzieć przed budowaniem, że dane w darmowym planie mogą być opóźnione nawet o 60 sekund, a dane w czasie rzeczywistym są zarezerwowane dla planu płatnego.

Najczęstsze pytania

Czy Balancer ma API?

Tak. Publiczny serwer GraphQL pod adresem api-v3.balancer.fi, udokumentowany na docs.balancer.fi w sekcji Data and Analytics, z 25 zapytaniami najwyższego poziomu obejmującymi pule, ceny, zdarzenia swapów i LP, metryki protokołu oraz zarządzanie veBAL.

Czy potrzebujesz klucza API dla Balancera?

Nie. Każde zapytanie, które wykonałem 23 września 2026, odpowiedziało bez klucza i bez jakiegokolwiek nagłówka uwierzytelniania.

Czy istnieje API Balancer v3?

Ten sam serwer GraphQL obsługuje obie wersje; pule niosą swoją wersję protokołu w typie i id puli, a nie na osobnym hoście. DexPaprika rozróżnia je jako osobne id DEX-a, balancer_v2 i balancer_v3.

Czy Balancer API podaje OHLCV lub świece cenowe?

Nie. Nie ma endpointu open, high, low, close. poolGetSnapshots zwraca dzienną płynność, cenę udziału i wolumen, co jest szeregiem czasowym, ale nie świecą, a tokenGetHistoricalPrices obejmuje ceny tokenów, a nie ceny puli.

Czy Balancer się zamyka?

Jeszcze nie zdecydowano. Propozycja zamknięcia protokołu i zwrotu skarbca posiadaczom BAL trafia pod głosowanie Snapshot od 25 do 29 września 2026. Data przejścia wyłącznie na wypłaty w propozycji to 30 października 2026; reszta tego, co dzieje się w razie przyjęcia, jest w sekcji powyżej.

Powinienem użyć API Balancera czy API agregatora DEX dla danych Balancera?

Dla wszystkiego ograniczonego do samego Balancera: szczegóły puli, rozbicie APR, zarządzanie, zdarzenia LP, własne API jest pełniejszym źródłem i tym, które sam Balancer utrzymuje na bieżąco. Sięgnij po indeks całego łańcucha, taki jak DexPaprika, gdy pytanie obejmuje więcej niż jeden DEX, wymaga OHLCV albo musi dalej działać bez zmian, jeśli zmieni się własna infrastruktura Balancera.

Jak zmierzono te liczby

Schemat API Balancera i każda nazwa pola pochodzą z żywego zapytania introspekcyjnego wobec api-v3.balancer.fi/graphql z 23 września 2026. Liczba pól zapytań, 25, oraz listy pól puli, zdarzeń i typów APR są odczytane wprost z tego żywego schematu.

Wolumeny i udziały DEX pochodzą z migawki GET /networks/{network}/dexes dla Arbitrum, Ethereum, Polygonu i Plasma, wykonanej o 22:17 UTC. Udział każdego łańcucha to wiersz Balancera podzielony przez sumę wszystkich wierszy DEX, jakie DexPaprika zwróciło dla tego łańcucha w tej samej migawce: udział konkretnie w zaindeksowanym wolumenie DEX tego łańcucha. Własne liczby swapVolume24h Balancera pochodzą z protocolMetricsChain o 22:27 UTC tego samego dnia i są cytowane dokładnie tak, jak zwrócone, bez korekty.

Liczby dla najbardziej ruchliwej puli oraz wywołania OHLCV i transakcji są cytowane z żywych odpowiedzi DexPaprika dla puli 0x74d5e70a8db6281ef5341d609725b1c7bbf5ebc6 na Polygonie. Data, godzina i mechanizm ataku pochodzą z niezależnych technicznych opracowań Certory i OpenZeppelin, wzajemnie zweryfikowanych. Fakty o zamknięciu, w tym daty głosowania i data przejścia wyłącznie na wypłaty 30 października, są odczytane z własnego harmonogramu propozycji na forum.balancer.fi. Forki Balancera, które DexPaprika wymienia pod własnymi nazwami (Beets na Sonic, Beethoven X na Optimism, BeraSwap na Berachain), nie są tu liczone jako Balancer.

Każda liczba wolumenu i udziału to 24-godzinne okno zamykające się w momencie pomiaru, więc spodziewaj się zmian, a wynik głosowania nie był jeszcze znany w chwili pisania tego tekstu.

Pełne REST API znajdziesz na docs.dexpaprika.com. Własne API Balancera jest udokumentowane na docs.balancer.fi. Źródłem samej propozycji zamknięcia jest forum zarządcze Balancera, a szerszy wzorzec ataków DeFi omawia ataki DeFi w 2026 roku.

To samo pytanie o pokrycie API dla dwóch innych DEX-ów: co zwraca Uniswap API oraz co obejmuje API Raydium na Solanie.