Bitculator · Embed · v1

Widget embed

Porta gli strumenti crypto in tempo reale di Bitculator direttamente sul tuo sito con un solo <iframe> — un grafico dei prezzi in tempo reale, un convertitore, un flipper di marketcap e sei calcolatori. Nessun SDK, nessun passaggio di build.

9 widget Chiave embed + dominio Modalità anonima

Ogni widget è una pagina autonoma sotto /{locale}/embed/… che inserisci nel tuo sito con un <iframe>. Mostra i dati di mercato in tempo reale di Bitculator — lo stesso feed usato dall'app — e non richiede alcun JavaScript da parte tua.

Incollalo ovunque — nessun tag script necessario:

<iframe src="https://bitculator.com/it/embed/converter/bitcoin/usd?embed_key=YOUR_EMBED_KEY"
        title="Bitculator converter" loading="lazy"
        width="100%" height="470" style="border:0;border-radius:12px"></iframe>

Aggiungi la tua chiave embed come parametro di query e registra il dominio su cui incorporerai il widget (entrambi nella tua console per sviluppatori). Anche gli embed senza chiave funzionano in modalità anonima — comodo per una prova rapida — ma sono limitati per IP visitatore. Ogni widget rispetta il {locale} nell'URL e segue il cookie theme (o ?theme=dark).

Content-Security-Policy

Utilizzi una Content-Security-Policy sul tuo sito? Aggiungi https://bitculator.com al tuo frame-src (e a child-src per i browser più datati) così il widget può caricarsi. Nulla da modificare dalla nostra parte — Bitculator consente già l'incorporamento su qualsiasi dominio.

Content-Security-Policy: frame-src https://bitculator.com

Generatore di snippet

Scegli un widget e le sue opzioni — lo snippet embed si aggiorna mentre procedi. Copialo, oppure apri un'anteprima in tempo reale in una nuova scheda.

Widget

compact

Tema Chiave embed

Snippet embed Apri esempio

Renderizzato in tempo reale in modalità anonima.

Autenticazione

Una chiave embed è un token con l'abilità api, generato nella tua console per sviluppatori. A differenza delle chiavi della Data API, viaggia nell'URL dell'iframe come parametro di query — mai in un header — quindi è pubblica per progettazione. Porta solo l'abilità api; le chiavi data-api (solo Bearer) vengono qui rifiutate così non possono trapelare nei referer o nei log.

Passala come ?embed_key=… (o l'alias ?api_key=…). Una richiesta con chiave deve inoltre provenire da un dominio nella allow-list (vedi sotto). Se hai effettuato l'accesso a Bitculator nello stesso browser, il controllo della chiave viene saltato per la tua sessione.

Domini

Un embed con chiave viene renderizzato solo sui domini che hai registrato. Bitculator legge il Referer della pagina che incorpora (ripiegando su Origin), lo normalizza (minuscolo, www. e qualsiasi punto finale rimossi) e lo confronta esattamente con la tua allow-list. Un host non registrato o non leggibile restituisce 403.

Gestisci i domini nella tua console per sviluppatori; ogni piano ne consente un certo numero (sotto). Poiché Referer/Origin è impostato dal browser del visitatore e può essere falsificato, la allow-list è una protezione contro il riutilizzo casuale della chiave, non una prova crittografica — considera comunque la chiave come pubblica. Gli embed anonimi (senza chiave) non sono vincolati al dominio; sono invece limitati per IP.

Quota e limiti

Gli embed attingono da un pool mensile completamente separato dalla Data API — un piano proprio, un contatore proprio. I caricamenti anonimi contano per IP visitatore (1.000/mese); i caricamenti con chiave contano sul limite mensile del tuo piano. I piani Free si azzerano il mese di calendario; i piani a pagamento si azzerano nel tuo giorno di fatturazione.

*Le risposte embed non riportano header `X-Quota-** — deliberatamente, così i numeri della quota non trapelano mai nelle pagine dei tuoi visitatori. Controlla invece il tuo utilizzo nella [console per sviluppatori](/user/developer/api). (Gli headerX-Quota-*` che potresti aver visto sono solo sulla Data API.)

Oltre il limite

Quando un widget supera la quota restituisce 429. In un iframe del browser è una piccola pagina "limite di utilizzo raggiunto" con uno stile dedicato (così il tuo layout non si rompe); un chiamante JSON riceve {"message", "limit", "used"}. Aggiungi una chiave, o esegui l'upgrade del piano, per ottenere di più.

Piani

I piani embed sono separati dal tuo piano Data API. Ogni account parte da Free; i visitatori senza chiave ottengono il livello anonimo.

Piano	Caricamenti / mese	Domini	Chiavi
Free	10,000	1	2
Starter	50,000	3	5
Pro	500,000	10	10
Anonimo	1,000 per IP	—	—

Anonimo è il livello senza chiave — nessun dominio o chiave, limitato per IP visitatore. Esegui l'upgrade nella console per sviluppatori.

Widget

Nove widget pronti all'uso. Copia uno snippet, inserisci la tua chiave, registra il tuo dominio — fatto. I segmenti di percorso (come lo slug di una coin) si risolvono in base allo slug dell'asset e devono essere un mercato attivo; ogni widget accetta inoltre i parametri di query condivisi qui sotto.

GET

Convertitore di valuta

/{locale}/embed/converter/bitcoin/usd

Converti un importo tra due asset qualsiasi, crypto o fiat, a tassi di mercato in tempo reale, con una tabella di confronto opzionale.

Snippet embed Apri esempio

<iframe src="https://bitculator.com/it/embed/converter/bitcoin/usd?embed_key=YOUR_EMBED_KEY"
        title="Bitculator converter" loading="lazy"
        width="100%" height="470" style="border:0;border-radius:12px"></iframe>

Parametro	In	Predefinito
fromL'asset da cui convertire, per slug (un mercato attivo).	path	—
toL'asset verso cui convertire, per slug (un mercato attivo).	path	—
hideTableNascondi la tabella di confronto e mostra solo il convertitore.	query	false
compactRenderizza un layout condensato con spaziatura più stretta — ideale per colonne strette.	query	false

Anteprima in tempo reale

GET

Grafico storico dei prezzi

/{locale}/embed/zoom/bitcoin

L'intero storico dei prezzi di una coin come grafico interattivo, con un selettore dei principali mercati per marketcap.

Snippet embed Apri esempio

<iframe src="https://bitculator.com/it/embed/zoom/bitcoin?embed_key=YOUR_EMBED_KEY"
        title="Bitculator price chart" loading="lazy"
        width="100%" height="460" style="border:0;border-radius:12px"></iframe>

Parametro	In	Predefinito
slugLa coin o il token da rappresentare nel grafico, per slug (un mercato attivo).	path	—
compactRenderizza un layout condensato con spaziatura più stretta — ideale per colonne strette.	query	false

Anteprima in tempo reale

GET

Flipper di marketcap

/{locale}/embed/flip/bitcoin/ethereum

Il "flippening" — quale sarebbe il prezzo di un asset con la marketcap di un altro, con il multiplo implicito.

Snippet embed Apri esempio

<iframe src="https://bitculator.com/it/embed/flip/bitcoin/ethereum?embed_key=YOUR_EMBED_KEY"
        title="Bitculator marketcap flipper" loading="lazy"
        width="100%" height="460" style="border:0;border-radius:12px"></iframe>

Parametro	In	Predefinito
entity1L'asset il cui prezzo viene riproiettato, per slug (un mercato attivo).	path	—
entity2L'asset la cui marketcap viene applicata, per slug (un mercato attivo).	path	—
compactRenderizza un layout condensato con spaziatura più stretta — ideale per colonne strette.	query	false

Anteprima in tempo reale

GET

Simulatore DCA

/{locale}/embed/dca

Cosa avrebbero accumulato e reso acquisti settimanali ricorrenti di una coin negli ultimi 5 anni.

Snippet embed Apri esempio

<iframe src="https://bitculator.com/it/embed/dca?embed_key=YOUR_EMBED_KEY"
        title="Bitculator DCA simulator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

Parametro	In	Predefinito
compactRenderizza un layout condensato con spaziatura più stretta — ideale per colonne strette.	query	false

Anteprima in tempo reale

GET

Calcolatore di profitto

/{locale}/embed/profit

Profitto netto, perdita e ROI da un prezzo di acquisto, prezzo di vendita, quantità e commissioni.

Snippet embed Apri esempio

<iframe src="https://bitculator.com/it/embed/profit?embed_key=YOUR_EMBED_KEY"
        title="Bitculator profit calculator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

Parametro	In	Predefinito
compactRenderizza un layout condensato con spaziatura più stretta — ideale per colonne strette.	query	false

Anteprima in tempo reale

GET

Calcolatore di interessi

/{locale}/embed/interest

Proietta il valore futuro di una holding a partire da capitale iniziale, tasso e frequenza di capitalizzazione.

Snippet embed Apri esempio

<iframe src="https://bitculator.com/it/embed/interest?embed_key=YOUR_EMBED_KEY"
        title="Bitculator interest calculator" loading="lazy"
        width="100%" height="560" style="border:0;border-radius:12px"></iframe>

Parametro	In	Predefinito
compactRenderizza un layout condensato con spaziatura più stretta — ideale per colonne strette.	query	false

Anteprima in tempo reale

GET

Calcolatore delle tasse

/{locale}/embed/tax

Stima l'importo imponibile e le tasse dovute su guadagni di trading, mining, staking, airdrop e rendimenti.

Snippet embed Apri esempio

<iframe src="https://bitculator.com/it/embed/tax?embed_key=YOUR_EMBED_KEY"
        title="Bitculator tax calculator" loading="lazy"
        width="100%" height="580" style="border:0;border-radius:12px"></iframe>

Parametro	In	Predefinito
compactRenderizza un layout condensato con spaziatura più stretta — ideale per colonne strette.	query	false

Anteprima in tempo reale

GET

Calcolatore di prestiti

/{locale}/embed/loan

Modella un prestito crypto — rimborso, interessi totali e un dettaglio di ammortamento.

Snippet embed Apri esempio

<iframe src="https://bitculator.com/it/embed/loan?embed_key=YOUR_EMBED_KEY"
        title="Bitculator loan calculator" loading="lazy"
        width="100%" height="580" style="border:0;border-radius:12px"></iframe>

Parametro	In	Predefinito
compactRenderizza un layout condensato con spaziatura più stretta — ideale per colonne strette.	query	false

Anteprima in tempo reale

GET

Calcolatore di staking

/{locale}/embed/staking

Stima le ricompense di staking da un importo in staking, APR/APY e durata.

Snippet embed Apri esempio

<iframe src="https://bitculator.com/it/embed/staking?embed_key=YOUR_EMBED_KEY"
        title="Bitculator staking calculator" loading="lazy"
        width="100%" height="520" style="border:0;border-radius:12px"></iframe>

Parametro	In	Predefinito
compactRenderizza un layout condensato con spaziatura più stretta — ideale per colonne strette.	query	false

Anteprima in tempo reale