Token-OHLCV-API: eine Candle-Serie pro Token über DEX-Pools

Ein Token, das in sechs Pools gehandelt wird, hat sechs Preis-Charts. Laut DexPaprika-Daten schloss Uniswap (UNI) in der Stunde von 07:00 bis 08:00 UTC am 29. September 2026 zu Preisen zwischen 8,9404 $ und 9,0297 $ über seine sechs aktivsten Ethereum-Pools, eine Spanne von etwa 1 %. Zeichnet deine App ein Chart aus einem dieser Pools, zeigt es die Sicht dieses Pools auf UNI, nicht die des Tokens.

Dieser Beitrag behandelt die OHLCV-Daten, die man bereits pro Pool abrufen kann, warum ein Pool nur eine Teilansicht ist, und den neuen Token-OHLCV-Endpunkt, der eine Candle-Serie pro Token liefert, aufgebaut als volumengewichteter Durchschnitt über die Pools, in denen das Token gehandelt wird.

Warum ein Token mehr als ein Preis-Chart hat

Eine dezentrale Börse bepreist ein Token Paar für Paar. UNI gegen WETH ist ein Pool, UNI gegen USDT ein anderer, UNI gegen natives ETH auf Uniswap V4 ein dritter. Jeder Pool setzt seinen eigenen Preis aus eigenen Reserven und eigenen Trades, und Arbitrage zieht sie zusammen, aber erst im Nachhinein und nicht perfekt. Innerhalb einer Stunde weichen die Pools also leicht voneinander ab: Das zeigten die sechs größten UNI-Pools auf Ethereum für dieselbe Candle.

Stündliche Pool-Candles aus der DexPaprika-API, 29. September 2026. Anteil ist das Volumen jedes Pools geteilt durch das kombinierte Volumen der sechs Pools in dieser Stunde.

Zwei Dinge fallen auf. Der tiefste Pool, UNI/WETH auf Uniswap V3, trug weniger als ein Drittel des Handels in dieser Stunde, ein allein daraus gebautes Chart lässt also das meiste außen vor, was passiert ist. Und der Ausreißer war ein UNI/AAVE-Pool, dessen Dollarpreis sich auch mit AAVE bewegt. Ein Pool-Chart ist exakt für seinen Pool, und genau das ist das Problem, wenn die Frage dem Token gilt.

Pool-Candles, kein Key nötig

Pool-OHLCV funktioniert heute schon im kostenlosen Tier. Dieser Call holt die letzten 24 stündlichen Candles des UNI/USDT-Pools aus der Tabelle, und er läuft ohne Key oder Anmeldung:

Jede Candle kommt als time_open, time_close, open, high, low, close und volume zurück. Calls ohne Key bekommen stündliche und längere Candles über ein kurzes, aktuelles Fenster. Ein kostenloser Key von console.dexpaprika.com öffnet feinere Intervalle und mehr Historie, und bezahlte Pläne gehen weiter; die Tabelle OHLCV-Limits nach Plan zeigt die aktuellen Fenster. Um die Pools eines Tokens überhaupt erst zu finden, suche nach Token-Adresse:

Von dort aus könntest du die Candles jedes Pools abrufen und sie selbst gewichten. Es funktioniert, aber es ist ein Request pro Pool pro Fenster, du musst entscheiden, welche Pools zählen, und Pools, in denen das Token zweites im Paar ist, brauchen ihren Preis mit inversed=true gedreht.

Token-OHLCV: eine Candle-Serie pro Token

Der Token-OHLCV-Endpunkt übernimmt diese Gewichtung für dich. Du übergibst eine Chain und eine Token-Adresse, und jede Candle wird aus einem volumengewichteten Durchschnittspreis (VWAP) über die Pools des Tokens gebaut: der erste Preis im Intervall als Open, der höchste als High, der niedrigste als Low, der letzte als Close, und das Volumen summiert.

Die Antwort hat dieselbe Form wie Pool-OHLCV, eine Chart-Komponente, die bereits Pool-Candles liest, liest Token-Candles also unverändert. Der Call für UNIs letzte 24 stündliche Candles:

Der Key kommt für sich allein in den Authorization-Header, ohne irgendetwas davor. Der Endpunkt akzeptiert jede der 36 Chains, die die API indexiert.

Wie die Token-Serie im Vergleich zu ihren Pools aussah

Ich ließ den Token-Endpunkt mit einem Pro-Key neben den zehn größten Pools von drei Token laufen, je 24 stündliche Candles, von 09:00 UTC am 28. September bis 09:00 UTC am 29. September 2026. Für die UNI-Stunde aus der ersten Tabelle schloss die Token-Candle bei 8,9462 $: innerhalb der Spanne der sechs Pools, weniger als einen Zehntel-Cent vom tiefsten Pool entfernt, und nicht vom UNI/AAVE-Ausreißer nach oben gezogen.

DexPaprika Token- und Pool-OHLCV, 1-h-Candles, 28. bis 29. September 2026. Lücke ist die absolute Differenz zwischen dem Schluss eines Pools und dem Schluss des Tokens in derselben Stunde.

Drei Dinge kamen dabei heraus. Der Token-Schluss verließ nie die Spanne, in der seine Pools gehandelt wurden. Einzelne Pools wichen in einer Stunde um bis zu 2,2 % ab, und in fast jeder Stunde zeigte mindestens ein Pool eine breitere Candle als die Token-Serie, genau der Docht, den ein Ein-Pool-Chart gezeigt hätte. Und der liquideste Pool ist nicht immer der beste Proxy: Für UNI folgte er dem Token im Schnitt auf 0,06 % genau, aber bei JUP hatte der tiefste Pool, auf Meteora, im Schnitt eine breitere Lücke zum Token-Preis (0,23 %) als seine zehn Pools als Gruppe (0,16 %).

Dazu kommt die Infrastruktur. Dieselbe Serie selbst nachzubauen kostete hier elf Calls pro Token, eine Pool-Suche und zehn Pool-Candle-Requests, plus die Inversionslogik. Der Token-Endpunkt ist ein Call.

Wo das kostenlose Tier endet

Token-OHLCV ist ein bezahlter Endpunkt, verfügbar auf den Plänen Dev, Pro und Enterprise. Calls ohne Key und kostenlose Keys bekommen einen 403 mit einer Meldung, die das sagt:

Bezahlte Pläne rufen api-pro.dexpaprika.com mit ihrem Key auf. Dev, der Einstiegsplan unter den bezahlten, deckt ein kürzlich zurückliegendes Zeitfenster ab; Pro hat dafür kein Planlimit. Die Pricing-Seite zeigt die aktuellen Pläne und Preise. Alles im Pool-Abschnitt oben bleibt im kostenlosen Tier, du kannst das Chart also zuerst mit Pool-Candles bauen und testen und die Datenquelle wechseln, sobald du die Token-Sicht brauchst.

Wie andere Token-OHLCV-APIs es machen

Einen Token-Level-OHLCV-Endpunkt gibt es auch anderswo. CoinGeckos On-Chain-API hat einen unter /onchain/networks/{network}/tokens/{token_address}/ohlcv/{timeframe}, und ihre Dokumentation sagt, er "liefert OHLCV-Daten aus dem liquidesten Pool des Tokens", mit einem eigenen Endpunkt, um zu prüfen, welcher Pool das ist, und einer maximalen Spanne von sechs Monaten pro Call. Das ist eine saubere, vorhersehbare Wahl: ein Pool, klar benannt, und für ein Token wie UNI, dessen tiefster Pool dem Token auf 0,06 % genau folgte, funktioniert das gut. Der Kompromiss zeigt sich, wo die Liquidität verteilt ist: Der tiefste UNI-Pool trug unter einem Drittel des Volumens einer Stunde, und JUPs tiefster Pool driftete weiter vom Token-Preis ab als seine Pools im Schnitt. DexPaprikas Endpunkt geht den anderen Weg und gewichtet die Pools des Tokens nach Volumen, sodass die Candle zeigt, wo der Handel stattfand.

Häufige Fragen

Was sind OHLCV-Daten?

Open, High, Low, Close und Volume für ein festes Intervall: der erste und letzte gehandelte Preis, die Extreme dazwischen, und wie viel gehandelt wurde. Das sind die Daten hinter einem Candlestick-Chart. Unsere Anleitung Was ist OHLCV? Die Daten hinter jedem Krypto-Chart deckt jedes Feld ab, wie Candles gebaut werden und wo sie versagen.

Sollte ich Pool-OHLCV oder Token-OHLCV nutzen?

Pool-OHLCV, wenn dich ein Markt interessiert, etwa der Pool, über den deine App Trades routet. Token-OHLCV, wenn du den Preis des Tokens willst, wie der Markt ihn gesehen hat, etwa für ein Preis-Chart auf einer Token-Seite oder einen Backtest.

Warum bekomme ich einen 403 auf dem Token-OHLCV-Endpunkt?

Der Endpunkt braucht einen Dev-, Pro- oder Enterprise-Plan. Pool-OHLCV funktioniert weiterhin ohne Key.

Wie diese Zahlen gemessen wurden

Am 29. September 2026 um 09:10 UTC listete ich UNIs Pools auf Ethereum über den Pool-Suche-Endpunkt, sortiert nach 24-Stunden-Volumen, und nahm die sechs größten. Für jeden holte ich stündliche Candles ohne Key von 05:00 bis 08:00 UTC, mit inversed=true für den einen Pool, in dem UNI das zweite Token ist, und verglich die Candle von 07:00 bis 08:00. Die Spanne ist der höchste Schluss über dem niedrigsten, minus eins. Der Vergleich Token gegen Pool nutzte am selben Tag einen Pro-Key: für UNI, LINK und JUP holte ich 24 stündliche Token-Candles ab 09:00 UTC am 28. September und dasselbe Fenster für die zehn größten Pools jedes Tokens nach 24-Stunden-Volumen, invertiert, wo das Token zweites im Paar ist, und verglich Schlüsse und Candle-Spannen Stunde für Stunde. Die 403-Meldung ist, was der Token-Endpunkt an diesem Tag auf einen Call ohne Key und auf einen kostenlosen Key zurückgab. CoinGeckos Formulierung ist aus seiner Token-OHLCV-Referenzseite zitiert, am selben Tag gelesen.

Die Token-OHLCV-Referenz und eine Anleitung mit Python- und JavaScript-Beispielen stehen auf docs.dexpaprika.com, Keys gibt es auf console.dexpaprika.com, und Pläne stehen auf der Pricing-Seite.