Pular para o conteúdo principal

Referência da API

Bem-vindo à API da Blocklens! Nossa API oferece acesso programático a mais de 210 métricas on-chain — os mesmos dados de alta fidelidade que alimentam nossos painéis na web. Foi criada para traders profissionais, analistas, fundos e desenvolvedores que precisam de dados confiáveis e consistentes para seus modelos, pesquisas e aplicações.

Primeiros passos​

Para começar a usar a API da Blocklens, você precisará de uma chave de API. O acesso à API está disponível para usuários dos nossos planos de assinatura pagos.

  1. Assine: Faça upgrade para um plano que permita acesso à API na nossa Página de Preços.
  2. Gere uma chave: Acesse a seção API Keys no painel da sua conta para criar sua primeira chave.
  3. Autentique-se: Inclua sua chave de API no cabeçalho Authorization das suas requisições.

Para todos os detalhes, consulte o guia de Autenticação.

API de Snapshot de Gráficos​

A API de Snapshot permite renderizar gráficos de análise on-chain como imagens PNG, gráficos vetoriais SVG ou metadados JSON — tudo através de um único endpoint.

# Simple: render a BTC price chart
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.blocklens.co/v1/chart/snapshot?metric=price" -o chart.png

# Template: MVRV ratio with dark theme
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.blocklens.co/v1/chart/snapshot?template=mvrv_ratio&theme=dark" -o mvrv.png

Use modelos pré-construídos para gráficos comuns, ou o endpoint POST para personalização completa (estilização por métrica, fórmulas, eixos customizados, heatmaps, sobreposições de desempenho de ciclo). O Servidor MCP usa esta API internamente para a ferramenta render_chart.

Consulte a documentação completa da API de Snapshot para todos os parâmetros, modelos e exemplos.

Filosofia da API​

Nossa API foi projetada com os seguintes princípios em mente:

  • Consistência: As estruturas de endpoints e os esquemas de dados são projetados para serem previsíveis e consistentes em todas as redes suportadas.
  • Desempenho: Otimizamos nossa infraestrutura para entregar respostas de baixa latência para consultas sensíveis ao tempo.
  • Clareza: Nossa documentação e campos de dados são nomeados de forma clara para serem autoexplicativos.
  • Confiabilidade: Construímos para alta disponibilidade e fornecemos um Changelog transparente para todas as atualizações.