A CoinMarketCap API é uma das interfaces de programação mais utilizadas para aceder a dados de mercado de criptomoedas em tempo real — preços, capitalização de mercado, volumes de negociação e muito mais. Neste guia explicamos como funciona, quais os planos disponíveis e como tirar partido dos principais endpoints para os seus projetos.
O que é a CoinMarketCap API e para que serve
A CoinMarketCap API é uma interface REST que disponibiliza dados de mercado cripto a programadores, investigadores e criadores de produtos. Com mais de 72 endpoints, cobre preços atualizados, histórico de cotações, rankings, informação sobre exchanges, métricas globais do mercado e dados de derivados.
A sua base de dados abrange dezenas de milhões de ativos rastreados e centenas de exchanges, tornando-a uma fonte de referência para qualquer aplicação que precise de informação fiável sobre o ecossistema cripto.
Os casos de uso mais comuns incluem:
- Monitorização de preços e configuração de alertas de mercado
- Análise técnica e construção de dashboards personalizados
- Backtesting de estratégias com dados históricos de cotações
- Comparação de liquidez e volumes entre exchanges
- Alimentar simuladores de paper trading com dados reais
Autenticação e planos disponíveis
O URL base da API é https://pro-api.coinmarketcap.com. Todas as chamadas autenticadas requerem a passagem da chave API no cabeçalho HTTP X-CMC_PRO_API_KEY — a opção mais segura em ambiente de produção, em comparação com o uso de parâmetros de querystring.
Existe também uma Keyless Public API, acessível sem registo, que expõe um subconjunto de mais de 35 endpoints em modo de avaliação. É útil para prototipagem rápida, mas apresenta limites de taxa bastante restritivos e um conjunto de endpoints fixo.
Os planos principais são:
- Basic (gratuito) — 15 000 créditos mensais, até 50 pedidos por minuto, acesso a mais de 30 endpoints; dados históricos não incluídos.
- Planos pagos (Hobbyist, Startup, Standard e superiores) — créditos adicionais, histórico completo de cotações, endpoints avançados e suporte dedicado.
Para a maioria dos projetos pessoais e educativos, o plano Basic é suficiente para explorar preços em tempo real, listagens e métricas globais de mercado sem qualquer custo.
Principais endpoints da CoinMarketCap API
A API organiza os seus recursos em categorias temáticas. As mais utilizadas pelos programadores são:
/v1/cryptocurrency/listings/latest— lista das criptomoedas mais recentes com preço, market cap e volume de 24 horas./v1/cryptocurrency/quotes/latest— cotação atualizada de uma ou mais moedas identificadas por ID ou símbolo./v1/cryptocurrency/map— mapeamento de todos os ativos ativos com o respetivo ID único da CoinMarketCap./v1/global-metrics/quotes/latest— métricas globais como capitalização total do mercado e Bitcoin dominance./v1/exchange/listings/latest— listagem das principais exchanges com volume de 24 horas e métricas de liquidez.
A maioria dos endpoints REST atualiza os dados num ciclo de 1 minuto. Em endpoints de listagem, cada bloco de 100 registos adicionais (além dos primeiros 100 predefinidos) consome um crédito extra — um detalhe importante para quem gere o plano gratuito.
Da API aos sinais: um exemplo prático de pipeline
Imagine que pretende monitorizar o RSI e o MACD das 50 maiores criptomoedas por capitalização de mercado. O fluxo típico seria:
- Chamar
/v1/cryptocurrency/listings/latest?limit=50&sort=market_cappara obter os símbolos e IDs das moedas. - Para cada ativo, recolher cotações históricas (disponíveis nos planos pagos) ou dados de ticker em tempo real a partir de uma exchange.
- Calcular os indicadores técnicos — RSI, MACD, EMA, Bandas de Bollinger — sobre as séries de preço obtidas.
- Comparar os valores dos indicadores com os limiares definidos na estratégia paper e gerar alertas de sinal.
Este tipo de pipeline — recolher dados de mercado, aplicar indicadores e gerar sinais acionáveis — é exatamente o que o CryptoSignals.bot executa de forma automatizada, incluindo simulação e backtesting em modo paper trading, sem necessidade de escrever código de integração próprio.
Para quem quer consolidar os fundamentos antes de explorar a API, recomendamos a leitura do nosso artigo CoinMarketCap: o que é e como usar para analisar cripto, onde explicamos a plataforma desde o início.
Perguntas frequentes
A CoinMarketCap API é gratuita?
Sim. O plano Basic é completamente gratuito e inclui 15 000 créditos mensais com acesso a mais de 30 endpoints. Para dados históricos de cotações ou volume elevado de chamadas, existem planos pagos com escalonamento de preços.
Preciso de uma chave API para começar?
Não obrigatoriamente. A Keyless Public API permite testar mais de 35 endpoints sem registo, com limites de taxa mais restritivos. Para uso recorrente ou em produção, recomenda-se criar uma conta gratuita e gerar uma chave própria, passada sempre pelo cabeçalho HTTP.
Com que frequência os dados são atualizados?
A maioria dos endpoints REST atualiza num ciclo de 1 minuto. Para dados de tick-by-tick ou streaming contínuo, a CoinMarketCap oferece soluções enterprise separadas que vão além da API pública padrão.
Posso usar a API para criar alertas automáticos de preço?
Sim. Consultando periodicamente o endpoint de cotações, é possível comparar o preço atual com limiares predefinidos e disparar notificações. Ferramentas como o CryptoSignals.bot integram esse mecanismo na camada de sinais técnicos, combinando dados de mercado com indicadores calculados em múltiplos timeframes.
Conclusão
A CoinMarketCap API é um ponto de partida sólido para qualquer projeto que precise de dados cripto fiáveis: o plano gratuito cobre preços atualizados, listagens e métricas globais; os planos pagos desbloqueiam histórico completo e endpoints avançados. Se prefere explorar indicadores técnicos e simular estratégias sem escrever código de integração, experimente CryptoSignals.bot — o simulador processa dados de mercado e gera sinais prontos a usar em modo paper trading, sem qualquer compromisso financeiro.
Este artigo tem fins exclusivamente educativos. O CryptoSignals.bot é um simulador de sinais e não presta aconselhamento financeiro. Investir em criptomoedas envolve riscos significativos de perda de capital.