API da Balancer: o que ela cobre e a votação de encerramento

A maior parte do que é linkado sobre a Balancer é o SDK ou o subgraph, mas o servidor GraphQL por trás do app da Balancer é público, sem chave e detalhado, até o ponto de trazer a APR discriminada por token de recompensa.

A seguir está o que encontrei lendo esse schema ao vivo, o que um índice no nível da chain como a DexPaprika acrescenta a ele, quão pequena é a presença da Balancer em cada chain que consegui checar, e a votação de governança que pode encerrar o protocolo antes do fim do ano. O método está no final, incluindo dois números que discordam entre si, e eu não vou fingir que não discordam.

O que a API da Balancer realmente entrega

Fazer introspecção do schema em api-v3.balancer.fi/graphql retorna 25 campos de query de nível superior. Agrupados pelo que fazem:

Ela responde sem chave, por um POST simples:

Só o objeto de pool já carrega mais do que a maioria das APIs de DEX única se dá ao trabalho de expor: isPaused, isInRecoveryMode, holdersCount, aggregateSwapFee, e um array aprItems tipado em 19 categorias de recompensa, de taxas de swap simples até campanhas de incentivo da Aura e da Merkl. Se a tarefa é "descrever esse pool da Balancer" ou "quanto essa LP está rendendo", essa é a ferramenta certa, e um índice de chain não faz isso melhor.

O que um índice no nível da chain acrescenta

Faltam duas coisas, e as duas são estruturais. Não há endpoint de OHLCV, só o poolGetSnapshots, um registro diário de liquidez, preço de share e volume que você mesmo teria que transformar em candles. E não há nada fora da Balancer. O enum GqlChain da API lista 17 valores, 16 redes ativas mais uma testnet Sepolia, mas todas são deployments da própria Balancer. Pergunte sobre a Uniswap ou a Curve na mesma chain e nenhuma query responde.

Esse é o argumento a favor de um índice multi-DEX: os dados da Balancer só descrevem a Balancer. Um schema que retorna o mesmo formato para cada DEX de uma chain é o que permite comparar uma contra outras nove sem fazer nove integrações, e é aí que está o valor da DexPaprika especificamente para a Balancer.

A fatia da Balancer no volume de DEXes, 23 de setembro de 2026

A DexPaprika indexa a Balancer sob dois ids: balancer_v2 no Arbitrum, Ethereum e Polygon, e balancer_v3 no Plasma, seu único deployment v3 neste conjunto. Medido contra cada linha de DEX que a DexPaprika carrega para aquela chain, a partir de um único snapshot tirado às 22:17 UTC:

Somando as quatro linhas, toda a presença da Balancer indexada pela DexPaprika chega a cerca de US$ 4,0 milhões por dia, contra US$ 69,5 milhões só do volume total de DEXes do Polygon naquele mesmo dia. O Polygon é a exceção, e por uma margem grande: em todo o resto, a Balancer fica abaixo de um quinto de um por cento da chain.

Um protocolo votando se continua funcionando

Dois eventos importam para quem está integrando a Balancer agora. Em 3 de novembro de 2025, por volta das 07:40 UTC, um atacante explorou uma falha de arredondamento na matemática de escala dos Composable Stable Pools da Balancer v2, com perdas de mais de US$ 120 milhões. Os relatórios técnicos da Certora e da OpenZeppelin situam o bug na matemática de stable pool da v2, e o da Certora afirma que a v3 não estava exposta a ele.

Depois, em 14 de setembro de 2026, uma proposta foi postada no próprio fórum da Balancer para um "encerramento ordenado": nenhum novo desenvolvimento de negócio, pools movidas para modo somente saque em 30 de outubro de 2026 onde os contratos permitem, e a DAO fechada até onde for legal e praticamente possível. O cronograma da proposta marca a votação no Snapshot para o período de 25 a 29 de setembro de 2026, dois dias depois das medições deste artigo. Se aprovada, a partir de 1 de novembro a infraestrutura se reduz a uma interface simplificada de saque, à cobertura de subgraph que ela precisa e à documentação pública, mantidas disponíveis durante as duas rodadas de distribuição da tesouraria aos detentores de BAL, a primeira abrindo no final de maio de 2027. Nem todo mundo na thread concorda: um fork foi proposto lá como outra direção no dia seguinte à publicação da proposta.

Onde as duas leituras de volume discordam

Consultei o próprio protocolMetricsChain da Balancer nove minutos depois do snapshot da DexPaprika acima, e os dois não concordam em nenhuma das quatro chains:

As duas leituras são volume de swap de 24 horas, as duas ao vivo e sem chave, com datas a menos de dez minutos uma da outra. No Ethereum, no Arbitrum e no Plasma, o número da própria Balancer vem mais alto que o nosso. No Polygon é o contrário, por um fator de oito. Eu não resolvi qual regra de contagem produz essa diferença e não vou chutar aqui. Se um número da Balancer específico do Polygon importa para o que você está construindo, puxe os dois ao vivo.

Candles e swaps de um pool da Balancer

O pool Balancer V2 mais movimentado no Polygon naquele dia foi um par USDC/USDT0 fazendo US$ 595.957 do volume acima, com liquidez abaixo de US$ 9.000. As duas chamadas abaixo funcionam sem chave.

Candles de hora em hora, que nada no schema da Balancer produz diretamente:

Cada linha traz time_open, time_close, open, high, low, close e volume. O feed individual de swaps por trás disso:

As linhas trazem token_0_symbol, token_1_symbol, os dois valores, price_0_usd e price_1_usd, created_at e factory_id, esse último apontando para o contrato Balancer Vault por onde toda pool V2 é roteada. As mesmas duas chamadas, no mesmo formato, funcionam contra qualquer uma das outras DEXes do Polygon, e esse é todo o argumento a favor de indexar uma chain em vez de um único protocolo.

Não precisa de chave para testar isso. Uma chave gratuita em console.dexpaprika.com aumenta a taxa e a cota, os números atuais de cada plano ficam na página de preços porque eles mudam, e vale saber antes de construir que os dados do plano gratuito podem ficar até 60 segundos atrasados, com tempo real reservado para o plano pago.

Perguntas comuns

A Balancer tem uma API?

Sim. Um servidor GraphQL público em api-v3.balancer.fi, documentado em docs.balancer.fi na seção Data and Analytics, com 25 queries de nível superior cobrindo pools, preços, eventos de swap e LP, métricas de protocolo e governança veBAL.

Preciso de uma chave de API para a Balancer?

Não. Toda query que rodei em 23 de setembro de 2026 respondeu sem chave e sem nenhum tipo de header de autenticação.

Existe uma API da Balancer v3?

O mesmo servidor GraphQL cobre as duas versões; as pools carregam sua versão de protocolo no próprio tipo e no id da pool, em vez de ficarem num host separado. A DexPaprika as distingue como dex ids separados, balancer_v2 e balancer_v3.

A API da Balancer dá OHLCV ou candles de preço?

Não. Não existe endpoint de open, high, low, close. O poolGetSnapshots retorna liquidez diária, preço de share e volume, o que é uma série temporal mas não um candle, e o tokenGetHistoricalPrices cobre preços de tokens, não preços de pools.

A Balancer vai fechar?

Ainda não está decidido. Uma proposta para encerrar o protocolo e devolver sua tesouraria aos detentores de BAL está em votação no Snapshot de 25 a 29 de setembro de 2026. A data de somente saque da proposta é 30 de outubro de 2026; o resto do que acontece se ela for aprovada está na seção acima.

Devo usar a API da Balancer ou a API de um agregador de DEX para dados da Balancer?

Para qualquer coisa restrita à Balancer, detalhe de pool, discriminação de APR, governança, eventos de LP, a própria API dela é a fonte mais completa e a que a Balancer mantém atualizada. Recorra a um índice no nível da chain como a DexPaprika quando a pergunta abrange mais de uma DEX, precisa de OHLCV, ou tem que continuar funcionando sem alteração caso a infraestrutura da própria Balancer mude.

Como esses números foram medidos

O schema da API da Balancer e cada nome de campo vieram de uma query de introspecção ao vivo contra api-v3.balancer.fi/graphql em 23 de setembro de 2026. A contagem de 25 campos de query e as listas de campos de pool, evento e tipo de APR são lidas direto desse schema ao vivo.

Os volumes e fatias de DEX vêm de um snapshot de GET /networks/{network}/dexes para Arbitrum, Ethereum, Polygon e Plasma, tirado às 22:17 UTC. A fatia de cada chain é a linha da Balancer dividida pela soma de cada linha de DEX que a DexPaprika retornou para aquela chain no mesmo snapshot: uma fatia do volume de DEX indexado daquela chain especificamente. Os números swapVolume24h da própria Balancer vieram do protocolMetricsChain às 22:27 UTC do mesmo dia e são citados como retornados, sem ajuste.

Os números do pool mais movimentado e as chamadas de OHLCV e transações são citados de respostas ao vivo da DexPaprika para o pool 0x74d5e70a8db6281ef5341d609725b1c7bbf5ebc6 no Polygon. A data, o horário e o mecanismo do exploit vêm dos relatórios técnicos independentes da Certora e da OpenZeppelin, cruzados um contra o outro. Os fatos do encerramento, incluindo as datas da votação e a data de somente saque de 30 de outubro, são lidos do próprio cronograma da proposta em forum.balancer.fi. Forks da Balancer que a DexPaprika lista sob nomes próprios (Beets no Sonic, Beethoven X no Optimism, BeraSwap no Berachain) não são contados aqui como Balancer.

Todo número de volume e de fatia é uma janela de 24 horas fechando no momento da medição, então espere movimento, e o resultado da votação ainda não era conhecido quando isso foi escrito.

Referência REST completa em docs.dexpaprika.com. A própria API da Balancer está documentada em docs.balancer.fi. Para a proposta de encerramento em si, a fonte é o fórum de governança da Balancer, e o padrão mais amplo de ataques em DeFi está coberto em os exploits de DeFi em 2026.

A mesma pergunta sobre cobertura de API para outras duas DEXes: o que a API da Uniswap retorna, e o que a API da Raydium cobre na Solana.