Token OHLCV API: jedna seria świec dla tokena z pul DEX

Token, który handluje w sześciu pulach, ma sześć wykresów cenowych. Według danych DexPaprika, w godzinie od 07:00 do 08:00 UTC 29 września 2026 roku Uniswap (UNI) zamknął się na cenach między $8,9404 a $9,0297 w swoich sześciu najbardziej ruchliwych pulach na Ethereum, czyli rozstrzał około 1%. Jeśli twoja aplikacja rysuje wykres z jednej z tych pul, pokazuje spojrzenie tej puli na UNI, a nie spojrzenie tokena.

Ten tekst omawia dane OHLCV, które już teraz możesz pobrać dla puli, dlaczego jedna pula to niepełny obraz, oraz nowy endpoint token OHLCV, który zwraca jedną serię świec dla tokena, zbudowaną jako średnia ważona wolumenem z pul, w których token handluje.

Dlaczego token ma więcej niż jeden wykres cenowy

Zdecentralizowana giełda wycenia token para po parze. UNI wobec WETH to jedna pula, UNI wobec USDT druga, UNI wobec natywnego ETH na Uniswap V4 trzecia. Każda pula ustala własną cenę na podstawie własnych rezerw i własnych transakcji, a arbitraż ściąga je razem, ale dopiero po fakcie i niedoskonale. Więc w obrębie dowolnej godziny pule nieco się różnią: oto co pokazało sześć największych pul UNI na Ethereum dla tej samej świecy.

Godzinowe świece pul z API DexPaprika, 29 września 2026. Udział to wolumen danej puli podzielony przez łączny wolumen sześciu pul w tej godzinie.

Wyróżniają się dwie rzeczy. Najgłębsza pula, UNI/WETH na Uniswap V3, niosła mniej niż jedną trzecią handlu w tej godzinie, więc wykres zbudowany tylko z niej pomija większość tego, co się wydarzyło. A wartością odstającą była pula UNI/AAVE, której cena w dolarach porusza się też razem z AAVE. Wykres jednej puli jest dokładny co do swojej puli, i to jest problem, gdy pytanie dotyczy tokena.

Świece puli, bez potrzeby klucza

OHLCV dla puli działa dziś na darmowym planie. To pobiera ostatnie 24 godzinowe świece puli UNI/USDT z tabeli i działa bez klucza czy rejestracji:

Każda świeca wraca jako time_open, time_close, open, high, low, close i volume. Wywołania bez klucza dostają świece godzinowe i dłuższe w krótkim, niedawnym oknie. Darmowy klucz z console.dexpaprika.com otwiera drobniejsze interwały i więcej historii, a płatne plany idą dalej; tabela limitów OHLCV według planu ma aktualne okna. Żeby w ogóle znaleźć pule tokena, szukaj po adresie tokena:

Stamtąd mógłbyś pobrać świece każdej puli i samodzielnie je zważyć. Działa, ale to jedno żądanie na pulę na okno, musisz zdecydować, które pule się liczą, a pule w parze tokenów wymagają odwrócenia ceny przez inversed=true, gdy token jest drugi w parze.

Token OHLCV: jedna seria świec dla tokena

Endpoint token OHLCV robi to ważenie po naszej stronie. Podajesz łańcuch i adres tokena, a każda świeca jest budowana ze średniej ceny ważonej wolumenem (VWAP) z pul tokena: pierwsza cena w interwale jako open, najwyższa jako high, najniższa jako low, ostatnia jako close, a wolumen zsumowany.

Odpowiedź ma ten sam kształt co OHLCV puli, więc komponent wykresu, który już czyta świece puli, czyta świece tokena bez zmian. Wywołanie dla ostatnich 24 godzinowych świec UNI:

Klucz trafia do nagłówka Authorization samodzielnie, bez niczego przed nim. Endpoint akceptuje dowolny z 36 łańcuchów indeksowanych przez API.

Jak seria tokena wyglądała na tle jego pul

Uruchomiłem endpoint tokena z kluczem Pro obok dziesięciu największych pul trzech tokenów, po 24 godzinowe świece każdy, od 09:00 UTC 28 września do 09:00 UTC 29 września 2026 roku. Dla godziny UNI z pierwszej tabeli świeca tokena zamknęła się na $8,9462: wewnątrz zakresu sześciu pul, mniej niż dziesiątą część centa od najgłębszej puli, i nie podciągnięta w górę przez odstającą pulę UNI/AAVE.

Token i pool OHLCV z DexPaprika, świece 1h, 28 do 29 września 2026. Różnica to bezwzględna różnica między zamknięciem puli a zamknięciem tokena w tej samej godzinie.

Wyszły z tego trzy rzeczy. Zamknięcie tokena nigdy nie wyszło poza zakres, w którym handlowały jego pule. Pojedyncze pule odbiegały od niego nawet o 2,2% w jednej godzinie, a prawie w każdej godzinie przynajmniej jedna pula wydrukowała szerszą świecę niż seria tokena, czyli cień, który pokazałby wykres jednej puli. A najbardziej płynna pula nie zawsze jest najlepszym przybliżeniem: dla UNI śledziła token w granicach 0,06% średnio, ale dla JUP najgłębsza pula, na Meteora, miała średnio szerszą różnicę do ceny tokena (0,23%) niż jej dziesięć pul jako grupa (0,16%).

Jest też kwestia hydrauliki. Odtworzenie tej samej serii samodzielnie zajęło tu jedenaście wywołań na token, jedno wyszukiwanie pul i dziesięć żądań świec pul, plus logikę odwracania. Endpoint tokena to jedno wywołanie.

Gdzie kończy się darmowy plan

Token OHLCV to płatny endpoint, dostępny w planach Dev, Pro i Enterprise. Wywołania bez klucza i darmowe klucze dostają 403 z komunikatem, który to mówi:

Płatne plany wywołują api-pro.dexpaprika.com ze swoim kluczem. Dev, wejściowy plan płatny, obejmuje niedawne okno historii; Pro nie ma na to limitu planu. Strona cennika ma aktualne plany i ceny. Wszystko w sekcji o pulach powyżej zostaje na darmowym planie, więc możesz najpierw zbudować i przetestować wykres na świecach puli, a źródło danych przełączyć, gdy potrzebujesz widoku tokena.

Jak robią to inne API token OHLCV

Endpoint OHLCV na poziomie tokena istnieje też gdzie indziej. API on-chain CoinGecko ma taki pod /onchain/networks/{network}/tokens/{token_address}/ohlcv/{timeframe}, a jej dokumentacja mówi, że „zwraca dane OHLCV z najbardziej płynnej puli tokena”, z osobnym endpointem do sprawdzenia, która to pula, i maksymalnym zakresem sześciu miesięcy na wywołanie. To czysty, przewidywalny wybór: jedna pula, wyraźnie nazwana, i dla tokena takiego jak UNI, którego najgłębsza pula śledziła token w granicach 0,06%, działa dobrze. Kompromis widać tam, gdzie płynność jest rozproszona: najgłębsza pula UNI niosła mniej niż jedną trzecią wolumenu jednej godziny, a najgłębsza pula JUP odpływała dalej od ceny tokena niż jej pule średnio. Endpoint DexPaprika idzie inną drogą i waży pule tokena wolumenem, więc świeca odzwierciedla miejsce, gdzie odbywał się handel.

Najczęstsze pytania

Czym są dane OHLCV?

Open, high, low, close i volume dla ustalonego interwału: pierwsza i ostatnia cena transakcji, skrajne wartości pomiędzy nimi i ile się nahandlowało. To dane stojące za wykresem świecowym. Nasz przewodnik Czym jest OHLCV? Dane za każdym wykresem krypto omawia każde pole, jak budowane są świece i gdzie się psują.

Użyć pool OHLCV czy token OHLCV?

Pool OHLCV, gdy zależy ci na jednym rynku, na przykład puli, przez którą twoja aplikacja kieruje transakcje. Token OHLCV, gdy chcesz cenę tokena taką, jaką widział rynek, na przykład wykres ceny na stronie tokena albo backtest.

Dlaczego dostaję 403 na endpoincie token OHLCV?

Endpoint potrzebuje planu Dev, Pro albo Enterprise. Pool OHLCV wciąż działa bez klucza.

Jak zmierzono te liczby

29 września 2026 roku o 09:10 UTC wylistowałem pule UNI na Ethereum endpointem wyszukiwania pul, posortowane według wolumenu 24-godzinnego, i wziąłem sześć największych. Dla każdej pobrałem godzinowe świece bez klucza od 05:00 do 08:00 UTC, z inversed=true dla jedynej puli, gdzie UNI jest drugim tokenem, i porównałem świecę 07:00 do 08:00. Rozstrzał to najwyższe zamknięcie podzielone przez najniższe, minus jeden. Porównanie token kontra pula użyło klucza Pro tego samego dnia: dla UNI, LINK i JUP pobrałem 24 godzinowe świece tokena od 09:00 UTC 28 września oraz to samo okno dla dziesięciu największych pul każdego tokena według wolumenu 24-godzinnego, odwrócone tam, gdzie token jest drugi w parze, i porównałem zamknięcia i zakresy świec godzina po godzinie. Komunikat 403 to to, co endpoint tokena zwrócił tego dnia wywołaniu bez klucza i darmowemu kluczowi. Sformułowanie CoinGecko jest zacytowane z jej strony referencyjnej token OHLCV, odczytanej tego samego dnia.

Dokumentacja token OHLCV i samouczek z przykładami w Pythonie i JavaScript są na docs.dexpaprika.com, klucze są w console.dexpaprika.com, a plany na stronie cennika.