Passa al contenuto principale

Riferimento API

Benvenuto nell'API di Blocklens! La nostra API fornisce accesso programmatico a oltre 210 metriche on-chain — gli stessi dati ad alta fedeltà che alimentano le nostre dashboard web. È pensata per trader professionisti, analisti, fondi e sviluppatori che hanno bisogno di dati affidabili e coerenti per i propri modelli, ricerche e applicazioni.

Per iniziare​

Per iniziare a usare l'API di Blocklens, è necessaria una chiave API. L'accesso all'API è disponibile per gli utenti dei nostri piani di abbonamento a pagamento.

  1. Abbonati: passa a un piano che consente l'accesso all'API sulla nostra pagina dei prezzi.
  2. Genera una chiave: vai alla sezione Chiavi API della dashboard del tuo account per creare la tua prima chiave.
  3. Autenticati: includi la tua chiave API nell'header Authorization delle tue richieste.

Per tutti i dettagli, consulta la guida all'Autenticazione.

API Snapshot dei grafici​

L'API Snapshot consente di renderizzare i grafici di analisi on-chain come immagini PNG, grafica vettoriale SVG o metadati JSON — il tutto tramite un singolo 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

Usa i template predefiniti per i grafici più comuni, oppure l'endpoint POST per una personalizzazione completa (stili per singola metrica, formule, assi personalizzati, heatmap, sovrapposizioni delle performance di ciclo). Il server MCP si appoggia internamente a questa API per lo strumento render_chart.

Consulta la documentazione completa dell'API Snapshot per tutti i parametri, i template e gli esempi.

Filosofia dell'API​

La nostra API è progettata secondo i seguenti principi:

  • Coerenza: le strutture degli endpoint e gli schemi dei dati sono progettati per essere prevedibili e coerenti su tutte le reti supportate.
  • Prestazioni: ottimizziamo la nostra infrastruttura per offrire risposte a bassa latenza per le query sensibili al tempo.
  • Chiarezza: la nostra documentazione e i nostri campi dati sono denominati in modo chiaro per risultare autoesplicativi.
  • Affidabilità: progettiamo per un'elevata disponibilità e forniamo un Changelog trasparente per tutti gli aggiornamenti.