API da Curve (CRV): pools, candles e uma chain ausente

A API da Curve acaba caindo no mesmo "será que ela sequer tem uma" que persegue a Raydium e a PancakeSwap, e não deveria. api.curve.fi, o endereço na maioria dos tutoriais antigos, agora responde com um 301 para api.curve.finance. Por trás desse redirecionamento está uma API completa de pools e registries, mais um segundo serviço, separado, construído especificamente para preços e histórico de negociação.

Na Ethereum, os dois ids da Curve na DexPaprika, a AMM comum e a Curve TwoCrypto, carregaram 4,8% do volume de DEX indexado no mesmo dia. Essa é a segunda maior participação da Curve entre as sete chains em que a DexPaprika a indexa. A maior é a Plasma, e é exatamente aí que a própria API da Curve ainda não se atualizou.

Dentro da api.curve.finance: pools, registries e recompensas da DAO

A api.curve.finance publica um documento OpenAPI em api.curve.finance/v1/openapi.json listando 44 caminhos GET, com uma cópia navegável em api.curve.finance/v1/documentation. Agrupados pelo que servem:

Sem chave, sem header, nada para se cadastrar:

Cada pool volta com os seus saldos de moeda, preços, preço virtual e links para a UI da Curve. Para "quais pools a Curve roda, e o que tem nelas agora", essa é a fonte: é o próprio relato do protocolo sobre si mesmo, em 21 chains pela própria contagem dele, cobertas abaixo.

A Prices API: candles e histórico de negociação num segundo host

Essa é a parte que separa a Curve da Raydium e da PancakeSwap. Um segundo serviço, independente, prices.curve.finance, documentado em prices.curve.finance/feeds-docs, traz o seu próprio documento OpenAPI com 138 caminhos. Escondidos nele estão /v1/ohlc/{chain}/{address} e /v1/trades/{chain}/{address}, e os dois funcionam.

Candles de hora em hora para a própria pool de USDC/USDT da Curve na Ethereum:

E um feed negociação por negociação para a mesma pool, em todos os pares que ela tem, sem precisar de endereços de token dessa vez:

Duas coisas a planejar com antecedência. O endpoint de OHLC precisa dos endereços exatos de main_token e reference_token do par, não só do endereço da pool, e cada requisição tem um teto de janela de 300 vezes o tamanho da agregação, então um ano de candles de hora em hora leva várias chamadas. O endpoint de trades limita cada página a 100 linhas. Os dois são parâmetros para projetar com antecedência.

O que nenhuma das APIs da Curve cobre

Os dois serviços só sabem sobre a Curve. Pergunte a qualquer um dos dois o que a Uniswap ou a Aerodrome está fazendo na mesma chain e você não recebe nada, porque essa não é a pergunta que eles respondem. Construir algo que precise comparar o preço ou a liquidez de um token entre todas as DEXes de uma chain, não só as pools da própria Curve, significa recorrer a um índice que cubra mais de um protocolo.

A segunda lacuna é mais estreita, e parece mais que ainda não foi atualizada do que uma escolha deliberada. A api.curve.finance/v1/getPlatforms lista as chains em que a Curve se considera implantada: 21 delas, de Ethereum e Arbitrum até adições mais recentes como Sonic e Mantle. A Plasma não está nessa lista, e nem os endpoints de pool da api.curve.finance nem a prices.curve.finance no seu /v1/chains/ a reconhecem como um chain id válido. Pedir pela Plasma retorna um erro de parâmetro de um, e "This chain is not supported" do outro.

O índice da DexPaprika discorda dessa lista. As pools StableSwap, TriCrypto e TwoCrypto da Curve na Plasma carregaram $1.781.229 dos $11.662.934 de volume de DEX indexado pela DexPaprika na chain em 23 de setembro de 2026, uma participação de 15,3%, a maior que a Curve tem em qualquer uma das sete chains medidas aqui. A mais movimentada dessas pools negocia desde 22 de setembro de 2025 e atualmente guarda $685.343 em liquidez. A Curve está ativa na Plasma. A lista de cobertura da própria API dela ainda não se atualizou.

A participação da Curve no volume de DEX indexado pela DexPaprika, sete chains

Todas as redes da DexPaprika em que a Curve é indexada, 23 de setembro de 2026:

Em cinco dessas sete redes, a DexPaprika lista a Curve sob um id, curve, mais curve_twocrypto especificamente na Ethereum. Na HyperEVM e na Plasma, as mesmas famílias de pool vêm divididas em curve_stableswap, curve_tricrypto e curve_twocrypto sem um id combinado, por isso essas duas linhas somam três valores de dex_id cada uma.

As mesmas duas chamadas, a partir de um índice em nível de chain

Os endpoints de OHLCV e de transações da DexPaprika funcionam da mesma forma para uma pool da Curve como para qualquer outra DEX na chain: um endereço de pool, sem precisar de parâmetros de par de token. Eu as rodei em 23 de setembro de 2026 contra a mesma pool de USDC/USDT da Curve na Ethereum usada acima, que fez $30,3 milhões do volume do dia. Os candles funcionam sem chave:

Cada candle traz time_open, time_close, open, high, low, close e volume.

As negociações individuais vêm do endpoint de transações. Desde 30 de setembro de 2026, ele precisa de um plano Dev ou Pro e roda em api-pro.dexpaprika.com, com a chave sozinha no header Authorization:

Cada linha traz sender, recipient, os símbolos e valores dos dois tokens, price_0_usd, price_1_usd, created_at e factory_id, o contrato por trás da negociação. O mesmo formato funciona com a Uniswap, a Aerodrome ou qualquer outra DEX na mesma chain, e esse é todo o argumento para recorrer a um índice em nível de chain quando uma pergunta deixa de ser só sobre a Curve.

Os candles não precisam de chave para testar. Uma chave gratuita em console.dexpaprika.com aumenta tanto a taxa quanto a cota, e os números atuais de cada plano estão na página de preços em vez de neste artigo, porque eles mudam. Os dados do plano gratuito podem ter até 60 segundos de atraso; o tempo real é o plano pago.

Perguntas comuns

A Curve tem uma API?

Sim, duas. A api.curve.finance cobre pools, registries, APYs e vaults de lending. A prices.curve.finance cobre candles de OHLC, histórico por negociação e snapshots de pool. A api.curve.fi ainda funciona; ela só redireciona.

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

Não. Todo endpoint chamado para este texto em 23 de setembro de 2026 respondeu sem chave e sem nenhum header de autenticação.

A API da Curve dá preços históricos ou OHLCV?

Sim, através de prices.curve.finance/v1/ohlc/{chain}/{address}. Ela precisa dos endereços exatos de token do par, e cada chamada é limitada a uma janela de 300 vezes o tamanho da agregação escolhida.

Posso obter o histórico de swaps da Curve pela API?

Sim. A prices.curve.finance/v1/trades/{chain}/{address} cobre um par de cada vez; a /v1/trades/all/{chain}/{address} cobre todos os pares da pool, paginada em 100 linhas por página.

Quais são os rate limits da API da Curve?

Nenhum dos dois serviços publica um, e as respostas deles não trazem headers ratelimit-* para você ler um orçamento. Os dois ficam atrás do Cloudflare, então trate o limite como real e não divulgado: espace as chamadas e recue diante de qualquer coisa que não seja um 200.

Quais chains a API da Curve cobre?

A getPlatforms lista 21, e a prices.curve.finance/v1/chains/ reporta dados de preço para 10 delas. Nenhuma das duas listas inclui a Plasma, onde a DexPaprika mediu $1,78 milhão de volume da Curve em 23 de setembro de 2026.

Como esses números foram medidos

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

As contagens de 44 e 138 endpoints vêm dos próprios documentos OpenAPI da Curve em api.curve.finance/v1/openapi.json e prices.curve.finance/feeds-docs/openapi.json, analisados diretamente em vez de lidos nas páginas Swagger renderizadas. A lista de 21 chains da plataforma é api.curve.finance/v1/getPlatforms; a lista de cobertura de preços de 10 chains é prices.curve.finance/v1/chains/. A lacuna da Plasma foi confirmada chamando os endpoints de pool e de chain das duas APIs com plasma como chain id e lendo o erro de parâmetro de volta.

Todo valor da DexPaprika vem de uma chamada por rede à lista de DEXes da DexPaprika (GET /networks/{network}/dexes), que retorna todas as DEXes da chain numa única resposta. A participação da Curve é o volume dos seus dex_id listados dividido pela soma do volume de todas as DEXes nessa mesma resposta. As chamadas de OHLC e de trades da Curve são citadas ao pé da letra e retornaram 200. As chamadas de candle e de transação da DexPaprika também retornaram 200 em 23 de setembro; a chamada de candle é mostrada com um início relativo, que funciona sem chave, e a chamada de transação na api-pro, onde ela precisa de um plano Dev ou Pro desde 30 de setembro. Todo valor de volume é uma janela de 24 horas fechando no momento da medição, então espere que ele se mova, especialmente na Plasma, onde o número de um único dia se apoia num punhado de pools.

Referência REST completa em docs.dexpaprika.com. A documentação da própria Curve está em docs.curve.finance, com a API de pool em api.curve.finance/v1/documentation e a API de preços em prices.curve.finance/feeds-docs. A página ao vivo da DexPaprika para a Curve na Ethereum está em dexpaprika.com/api/ethereum/curve.

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