API de token OHLCV: uma série de candles por token nas pools de DEX

Um token negociado em seis pools tem seis gráficos de preço. Segundo dados da DexPaprika, na hora das 07:00 às 08:00 UTC de 29 de setembro de 2026, a Uniswap (UNI) fechou entre $8,9404 e $9,0297 nas suas seis pools mais movimentadas na Ethereum, uma diferença de cerca de 1%. Se o seu app desenha um gráfico a partir de uma dessas pools, ele mostra a visão daquela pool sobre o UNI, não a do token.

Este texto cobre os dados de OHLCV que você já pode buscar por pool, por que uma única pool é uma visão parcial, e o novo endpoint de token OHLCV, que retorna uma série de candles por token, construída como uma média ponderada por volume entre as pools em que o token é negociado.

Por que um token tem mais de um gráfico de preço

Uma exchange descentralizada precifica um token par a par. UNI contra WETH é uma pool, UNI contra USDT outra, UNI contra ETH nativo na Uniswap V4 uma terceira. Cada pool define o seu próprio preço a partir das suas próprias reservas e das suas próprias negociações, e a arbitragem as aproxima, mas só depois do fato e nunca de forma perfeita. Então, dentro de qualquer hora, as pools divergem um pouco: foi isso que as seis maiores pools de UNI na Ethereum mostraram para o mesmo candle.

Candles de pool de hora em hora da API da DexPaprika, 29 de setembro de 2026. A participação é o volume de cada pool dividido pelo volume combinado das seis pools naquela hora.

Duas coisas se destacam. A pool mais profunda, UNI/WETH na Uniswap V3, carregou menos de um terço das negociações naquela hora, então um gráfico construído só a partir dela deixa de fora a maior parte do que aconteceu. E o outlier foi uma pool de UNI/AAVE, cujo preço em dólar também se move com o AAVE. Um gráfico por pool é exato sobre a sua pool, e esse é o problema quando a pergunta é sobre o token.

Candles de pool, sem precisar de chave

O OHLCV por pool funciona no plano gratuito hoje. Isso busca os últimos 24 candles de hora em hora da pool UNI/USDT da tabela, e roda sem chave nem cadastro:

Cada candle volta como time_open, time_close, open, high, low, close e volume. Chamadas sem chave recebem candles de hora em hora ou maiores, numa janela recente curta. Uma chave gratuita em console.dexpaprika.com abre intervalos mais finos e mais histórico, e os planos pagos vão além; a tabela de limites de OHLCV por plano tem as janelas atuais. Para encontrar as pools de um token antes de tudo, busque pelo endereço do token:

A partir daí, você poderia buscar os candles de cada pool e ponderá-los você mesmo. Funciona, mas é uma requisição por pool por janela, você precisa decidir quais pools contam, e pools num par de tokens precisam ter o preço invertido com inversed=true quando o token fica em segundo no par.

Token OHLCV: uma série de candles por token

O endpoint de token OHLCV faz essa ponderação do nosso lado. Você passa uma chain e um endereço de token, e cada candle é construído a partir de um preço médio ponderado por volume (VWAP) entre as pools do token: o primeiro preço do intervalo como open, o maior como high, o menor como low, o último como close, e o volume somado.

A resposta tem o mesmo formato do OHLCV de pool, então um componente de gráfico que já lê candles de pool lê candles de token sem mudanças. A chamada para os últimos 24 candles de hora em hora do UNI:

A chave vai no header Authorization sozinha, sem nada na frente dela. O endpoint aceita qualquer uma das 36 chains que a API indexa.

Como a série do token ficou em comparação com as suas pools

Rodei o endpoint de token com uma chave Pro ao lado das dez maiores pools de três tokens, 24 candles de hora em hora cada, das 09:00 UTC de 28 de setembro às 09:00 UTC de 29 de setembro de 2026. Para a hora de UNI da primeira tabela, o candle do token fechou em $8,9462: dentro do intervalo das seis pools, a menos de um décimo de centavo da pool mais profunda, e sem ser puxado para cima pelo outlier da UNI/AAVE.

OHLCV de token e de pool da DexPaprika, candles de 1h, 28 a 29 de setembro de 2026. A diferença é o valor absoluto entre o fechamento de uma pool e o fechamento do token na mesma hora.

Três coisas saíram disso. O fechamento do token nunca saiu do intervalo em que as suas pools negociaram. Pools isoladas se desviaram dele em até 2,2% numa hora, e em quase toda hora pelo menos uma pool imprimiu um candle mais largo que a série do token, que é o pavio que um gráfico de uma única pool teria mostrado. E a pool mais líquida nem sempre é o melhor proxy: para o UNI, ela acompanhou o token dentro de 0,06% em média, mas para o JUP a pool mais profunda, na Meteora, teve em média uma diferença maior em relação ao preço do token (0,23%) do que as suas dez pools tiveram como grupo (0,16%).

Há também a parte de encanamento. Reconstruir a mesma série por conta própria exigiu onze chamadas por token aqui, uma busca de pool e dez requisições de candle de pool, além da lógica de inversão. O endpoint de token é uma única chamada.

Onde o plano gratuito termina

O token OHLCV é um endpoint pago, disponível nos planos Dev, Pro e Enterprise. Chamadas sem chave e chaves gratuitas recebem um 403 com uma mensagem que diz isso:

Os planos pagos chamam api-pro.dexpaprika.com com a sua chave. O Dev, o plano pago de entrada, cobre uma janela de histórico recente; o Pro não tem limite de plano nisso. A página de preços tem os planos e preços atuais. Tudo na seção de pool acima continua no plano gratuito, então você pode construir e testar o gráfico com candles de pool primeiro e trocar a fonte de dados quando precisar da visão do token.

Como outras APIs de token OHLCV fazem isso

Um endpoint de OHLCV em nível de token existe em outros lugares também. A API on-chain da CoinGecko tem um em /onchain/networks/{network}/tokens/{token_address}/ohlcv/{timeframe}, e a sua documentação diz que ele "retorna dados de OHLCV da pool mais líquida do token", com um endpoint separado para checar qual é essa pool, e um intervalo máximo de seis meses por chamada. Essa é uma escolha limpa e previsível: uma pool, claramente identificada, e para um token como o UNI, cuja pool mais profunda acompanhou o token dentro de 0,06%, ela funciona bem. O trade-off aparece onde a liquidez está espalhada: a pool mais profunda de UNI carregou menos de um terço do volume de uma hora, e a pool mais profunda do JUP se afastou mais do preço do token do que as suas pools fizeram em média. O endpoint da DexPaprika segue o outro caminho e pondera as pools do token por volume, então o candle reflete onde a negociação aconteceu.

Perguntas comuns

O que são dados de OHLCV?

Open, high, low, close e volume para um intervalo fixo: o primeiro e o último preço negociado, os extremos no meio, e quanto foi negociado. São os dados por trás de um gráfico de candlestick. O nosso guia O que é OHLCV? Os dados por trás de todo gráfico cripto cobre cada campo, como os candles são construídos e onde eles falham.

Devo usar OHLCV de pool ou OHLCV de token?

OHLCV de pool quando você se importa com um único mercado, como a pool pela qual o seu app roteia negociações. OHLCV de token quando você quer o preço do token como o mercado o viu, como um gráfico de preço numa página de token ou um backtest.

Por que recebo um 403 no endpoint de token OHLCV?

O endpoint precisa de um plano Dev, Pro ou Enterprise. O OHLCV de pool continua funcionando sem chave.

Como esses números foram medidos

Em 29 de setembro de 2026, às 09:10 UTC, listei as pools de UNI na Ethereum com o endpoint de busca de pool, ordenadas por volume de 24 horas, e peguei as seis maiores. Para cada uma, busquei candles de hora em hora sem chave das 05:00 às 08:00 UTC, com inversed=true para a única pool em que o UNI é o segundo token, e comparei o candle das 07:00 às 08:00. A diferença é o maior fechamento sobre o menor, menos um. A comparação entre token e pool usou uma chave Pro no mesmo dia: para UNI, LINK e JUP, busquei 24 candles de hora em hora do token a partir das 09:00 UTC de 28 de setembro e a mesma janela para as dez maiores pools de cada token por volume de 24 horas, invertidas onde o token é o segundo no par, e comparei fechamentos e intervalos de candle hora a hora. A mensagem de 403 é o que o endpoint de token retornou naquele dia para uma chamada sem chave e para uma chave gratuita. A frase da CoinGecko é citada da sua página de referência de token OHLCV, lida no mesmo dia.

A referência de token OHLCV e um tutorial com exemplos em Python e JavaScript estão em docs.dexpaprika.com, as chaves estão em console.dexpaprika.com, e os planos estão na página de preços.