API da Uniswap: o que ela devolve e de onde vêm os dados

Procure por Uniswap API e todo resultado na sua frente é sobre swap. A documentação oficial, o repositório routing-api, o próprio app. Todos respondem à pergunta de como negociar através da Uniswap, e nenhum responde à pergunta que a maioria das pessoas está realmente fazendo, que é de onde vêm os preços e o histórico.

São dois produtos diferentes, com dois donos diferentes. Abaixo está o que cada um cobre, quanto custa o caminho dos dados, e três coisas que eu medi nos deployments da Uniswap em 22 de setembro de 2026. O método está no final.

O que a API da Uniswap realmente faz

O produto que a Uniswap chama de API é a Swapping API, documentada em developers.uniswap.org. Ela tem quatro endpoints documentados, e todos são etapas para fazer uma negociação.

As chamadas levam sua chave em um header x-api-key. A página de chains suportadas lista 21 mainnets: 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 e Zora, mais três testnets.

/quote é o endpoint que costuma ser confundido com um feed de preços, e vale a pena ser preciso sobre por que não é. Ele precifica uma negociação: esta quantidade deste token, por aquele token, agora, nesta rota, com esta tolerância a slippage. Faça a mesma pergunta duas vezes com tamanhos diferentes e você recebe números diferentes, porque é para isso que uma cotação serve. Ele não vai te dizer o que o pool fez ontem, qual é a profundidade dele, ou quantas pessoas negociaram nele hoje de manhã.

Para onde a Uniswap te manda em busca de dados de mercado

A resposta da Uniswap para a questão dos dados são os subgraphs, e a própria documentação é direta sobre o estado deles. Vale a pena citar duas frases diretamente.

Leia essa segunda frase de novo, porque é a parte que surpreende as pessoas. A chave não é uma chave da Uniswap e a cobrança não é uma cobrança da Uniswap. Ambas pertencem ao The Graph. Você se cadastra lá, paga lá, e a Uniswap não entra na transação em nenhum momento.

A Uniswap também adiciona um aviso aos deployments que lista, dizendo que "não são deployments oficiais e podem não ser mantidos ativamente pela Uniswap Labs", e recomenda que quem for rodar isso em produção faça o deploy do próprio subgraph. É um aviso honesto e deve ser levado a sério: a infraestrutura da qual você está prestes a depender é mantida pela comunidade, e a própria Uniswap já disse que não é ela quem mantém isso.

Quanto custa o The Graph, e por que o custo não é o problema

Direto da própria página de preços do The Graph, em 22 de setembro de 2026: 100.000 consultas por mês sem custo, depois US$ 2 a cada 100.000 consultas, pagáveis com cartão ou em GRT.

É um preço baixo para o que oferece, e qualquer artigo que tentasse atacar esse preço estaria errado e seria fácil de refutar. Se a única coisa entre você e os dados da Uniswap fosse a conta, não haveria nada aqui que valesse a pena escrever.

O atrito está na forma e na manutenção. Um subgraph é limitado a uma versão do protocolo em uma chain, então cobrir a Uniswap direito significa um endpoint por versão por chain, cada um com suas próprias peculiaridades de schema, seu próprio estado de sincronização e seu próprio mantenedor. Você escreve GraphQL contra cada um deles, descobre separadamente quando algum fica desatualizado, e a Uniswap já te disse que não é ela quem os mantém vivos.

Em setembro de 2026, a v4 ultrapassou a v3 na Ethereum

Aqui está o motivo de a questão versão-por-versão importar mais do que costumava. As três versões da Uniswap ativas na Ethereum, volume de 24 horas, medido em 22 de setembro de 2026:

A v4 agora é a maior das duas na Ethereum. Quem ainda aponta um subgraph só da v3 para a Ethereum, o que era perfeitamente razoável um ano atrás, está lendo a metade menor do mercado e vai ver o volume real de um token como aproximadamente a metade do que realmente é. Nada quebra, nenhum erro aparece, os números simplesmente estão errados numa direção difícil de perceber.

Esse é o custo de manutenção que a página de preços não mostra. Não são os US$ 2. É saber o dia em que a divisão mudou.

Toda DEX na Robinhood Chain é Uniswap

A segunda coisa que apareceu durante a medição. Peça por todas as DEXes na Robinhood Chain e voltam três linhas. As três são Uniswap.

Nenhum protocolo concorrente aparece na resposta. Rodei a chamada de novo antes de publicar, porque um resultado tão limpo geralmente significa que sobrou algum filtro ligado em algum lugar. Não era o caso.

Note o que isso faz com a questão da versão. Um subgraph só da v3 na Robinhood Chain capturaria US$ 672 milhões e perderia os US$ 541 milhões que passam pela v4 e pela v2, o que é aproximadamente 45% da chain. Os pools da v4 também são onde vive a cauda longa: 20.536 dos 24.263 pools da chain estão na v4, contra 2.920 na v3.

Lendo pools da Uniswap sem subgraph

A outra rota é uma chamada REST contra um índice que já cobre todas as versões em todas as chains. É isso que a DexPaprika faz, e a chamada abaixo não precisa de chave, de cadastro nem de GraphQL:

Isso retorna HTTP 200 com um objeto no formato {results, has_next_page, next_cursor, query}. Cada linha traz 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, as quatro janelas de price_change_percentage_* e um array tokens.

Troque uniswap_v4 por uniswap_v3 ou uniswap_v2 e o formato não muda, e esse é o ponto: um schema único entre versões e chains, em vez de um subgraph para cada par delas.

Chamadas sem chave funcionam para testar isso. Uma chave gratuita em console.dexpaprika.com aumenta a taxa e a cota, e os números atuais de cada plano estão na página de preços, não neste artigo, porque eles mudam. Uma coisa que vale saber antes de construir em cima disso: os dados do plano gratuito podem ter até 60 segundos de atraso. Tempo real é o plano pago.

Quais chains têm quais versões da Uniswap

A API de negociação da Uniswap suporta 21 mainnets. A DexPaprika indexa dados de mercado da Uniswap em 13 delas, medido em 22 de setembro de 2026:

Seja claro sobre o que essa tabela afirma e o que não afirma. A API de negociação da Uniswap alcança mais chains do que esta lista. A afirmação aqui é mais restrita: nessas 13, a pergunta sobre dados de mercado que a API da Uniswap não responde é respondida, sob um único schema, sem um subgraph por versão.

Existem páginas por chain com feed de swaps ao vivo para Uniswap na Ethereum, Base, Arbitrum, Polygon e Monad.

Perguntas comuns

A Uniswap tem uma API?

Sim, a Swapping API, com quatro endpoints documentados para aprovações, cotações, ordens UniswapX e swaps clássicos. Ela foi feita para executar negociações. Não devolve reservas de pool, preços históricos, candles de OHLCV nem histórico de swaps.

Você precisa de uma chave de API para a Uniswap?

A Swapping API recebe uma chave em um header x-api-key. Para dados, a chave que você precisa é uma Graph API key criada no Studio do The Graph, e é o The Graph quem te cobra por ela.

A API da Uniswap dá preços históricos?

Não. Preços históricos e candles vêm de um subgraph que você consulta no The Graph, ou de uma API de dados de mercado que indexa os pools da Uniswap diretamente.

O que aconteceu com o subgraph hospedado da Uniswap?

Foi descontinuado. A documentação da Uniswap agora te direciona para a rede descentralizada, com uma chave do Studio do The Graph, e observa que os deployments listados não são oficiais e podem não ser mantidos ativamente pela Uniswap Labs.

Qual versão da Uniswap eu devo indexar?

Na Ethereum, em 22 de setembro de 2026, a v4 carrega mais volume de 24 horas do que a v3, e a v2 ainda movimenta US$ 62 milhões por dia. Indexar uma versão isolada vai subestimar qualquer token que negocia em várias.

Existe um rate limit na API da Uniswap?

A Uniswap documenta os limites da Swapping API atrelados à sua chave. Para o caminho dos dados não existe um limite único da Uniswap para citar, porque você está consultando o The Graph sob os termos do The Graph, ou uma API de terceiros sob os termos dela.

Como esses números foram medidos

Tudo acima foi lido direto de uma fonte ao vivo em 22 de setembro de 2026.

As listas de endpoints e chains vêm de developers.uniswap.org, lido naquele dia. As duas frases citadas são as próprias palavras da Uniswap na documentação de subgraphs. Os números do The Graph vêm da página de preços do The Graph.

As tabelas de volume são uma chamada GET /networks/{chain}/dexes por chain contra api.dexpaprika.com, sem chave e espaçadas no tempo, somando as entradas da Uniswap em cada chain. Cada número em uma dada tabela vem da mesma resposta, o que importa mais do que parece: os totais no nível da chain em GET /networks e os totais por DEX em /dexes são calculados separadamente e ficam cerca de meio décimo de ponto percentual de diferença, o suficiente para que dividir um pelo outro possa produzir uma fatia acima de 100%. É por isso que a seção da Robinhood Chain descreve do que a chain é composta em vez de citar uma porcentagem.

Todo número é uma janela de 24 horas que se encerra no momento da medição, então espere que ele já tenha mudado quando você estiver lendo isto. A divisão entre versões na Ethereum é a afirmação com mais chance de ficar desatualizada, e é a que vale a pena rodar de novo antes de confiar nela.

Duas coisas que verifiquei e vieram negativas, caso você vá procurar por elas. /networks/{chain} não é um endpoint e retorna 404 em toda chain, incluindo a Ethereum, então não construa nada em cima dele. E as linhas de results da busca não trazem um campo pair, seja lá o que exemplos mais antigos por aí mostrem.

Referência REST completa em docs.dexpaprika.com. Se você quiser o lado do consumidor da Uniswap, temos um guia passo a passo para trocar tokens na Uniswap.

A mesma pergunta para outras duas DEXes: o que a API da Raydium cobre na Solana, e o que a PancakeSwap documenta para a BNB Smart Chain.