Bitculator · Embeds · v1

Embed-widgets

Zet Bitculators live cryptotools rechtstreeks op je eigen site met één enkele <iframe> — een realtime prijsgrafiek, een converter, een marketcap-flipper en zes calculators. Geen SDK, geen build-stap.

9 widgets Embed-key + domein Anonieme modus

Elke widget is een zelfstandige pagina onder /{locale}/embed/… die je met een <iframe> op je site plaatst. Hij toont Bitculators live marktdata — dezelfde feed die de app gebruikt — en vereist geen JavaScript aan jouw kant.

Plak het overal — geen scripttag nodig:

<iframe src="https://bitculator.com/nl/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>

Voeg je embed-key toe als query-parameter en registreer het domein waarop je gaat embedden (beide in je developerconsole). Keyless embeds werken ook in anonieme modus — handig voor een snelle test — maar zijn beperkt per bezoeker-IP. Elke widget respecteert de {locale} in de URL en volgt de theme-cookie (of ?theme=dark).

Content-Security-Policy

Serveer je een Content-Security-Policy op je site? Voeg https://bitculator.com toe aan je frame-src (en child-src voor oudere browsers) zodat de widget kan laden. Aan onze kant hoeft niets te veranderen — Bitculator staat embedden op elk domein al toe.

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

Snippet-builder

Kies een widget en de opties — de embed-snippet wordt meteen bijgewerkt. Kopieer hem, of open een live preview in een nieuw tabblad.

Widget

compact

Thema Embed-key

Embed-snippet Voorbeeld openen

Live gerenderd in anonieme modus.

Authenticatie

Een embed-key is een token met de api-ability, aangemaakt in je developerconsole. Anders dan Data API-keys zit hij in de iframe-URL als query-parameter — nooit in een header — dus is hij per ontwerp publiek. Hij draagt alleen de api-ability; de Bearer-only data-api-keys worden hier geweigerd zodat ze niet kunnen lekken in referers of logs.

Geef hem mee als ?embed_key=… (of de alias ?api_key=…). Een request met key moet ook van een toegestaan domein komen (zie hieronder). Als je in dezelfde browser bij Bitculator bent ingelogd, wordt de key-controle voor je eigen sessie overgeslagen.

Domeinen

Een embed met key rendert alleen op domeinen die je hebt geregistreerd. Bitculator leest de Referer van de embeddende pagina (met Origin als fallback), normaliseert die (kleine letters, www. en een eventuele afsluitende punt verwijderd) en matcht die exact tegen je allow-list. Een niet-geregistreerde of onleesbare host geeft 403.

Beheer domeinen in je developerconsole; elk abonnement staat een vast aantal toe (hieronder). Omdat Referer/Origin door de browser van de bezoeker wordt gezet en vervalst kan worden, is de allow-list een bescherming tegen achteloos hergebruik van keys, geen cryptografisch bewijs — behandel de key sowieso als publiek. Anonieme (keyless) embeds zijn niet domeingebonden; die zijn in plaats daarvan beperkt per IP.

Quotum & limieten

Embeds putten uit een maandelijkse pool die volledig gescheiden is van de Data API — een eigen abonnement, een eigen teller. Anonieme loads tellen per bezoeker-IP (1,000/maand); loads met key tellen mee voor de maandlimiet van je abonnement. Free-abonnementen resetten op de kalendermaand; betaalde abonnementen resetten op je factuurdag.

*Embed-responses dragen geen `X-Quota-headers** — met opzet, zodat quotumcijfers nooit in de pagina's van je bezoekers lekken. Houd je verbruik in de gaten in de [developerconsole](/user/developer/api). (DeX-Quota-*` headers die je misschien hebt gezien, zitten alleen op de Data API.)

Over de limiet

Wanneer een widget over het quotum is, geeft hij 429. In een browser-iframe is dat een kleine gestylede "gebruikslimiet bereikt"-pagina (zodat je layout niet breekt); een JSON-caller krijgt {"message", "limit", "used"}. Voeg een key toe of upgrade je abonnement voor meer.

Abonnementen

Embed-abonnementen staan los van je Data API-abonnement. Elk account start op Free; bezoekers zonder key krijgen de anonieme tier.

Abonnement	Loads / maand	Domeinen	Keys
Free	10,000	1	2
Starter	50,000	3	5
Pro	500,000	10	10
Anoniem	1,000 per IP	—	—

Anoniem is de keyless tier — geen domeinen of keys, beperkt per bezoeker-IP. Upgrade in de developerconsole.

Widgets

Negen kant-en-klare widgets. Kopieer een snippet, vul je key in, registreer je domein — klaar. Padsegmenten (zoals een coin-slug) worden opgelost via de slug van het asset en moeten een actieve markt zijn; elke widget accepteert ook de gedeelde query-parameters hieronder.

GET

Valuta-converter

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

Reken een bedrag om tussen twee crypto- of fiat-assets tegen live marktkoersen, met een optionele vergelijkingstabel.

Embed-snippet Voorbeeld openen

<iframe src="https://bitculator.com/nl/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>

Parameter	In	Standaard
fromHet asset waarvan je omrekent, op slug (een actieve markt).	path	—
toHet asset waarnaar je omrekent, op slug (een actieve markt).	path	—
hideTableVerberg de vergelijkingstabel en toon alleen de converter.	query	false
compactRendert een compacte layout met krappere ruimte — geschikt voor smalle kolommen.	query	false

Live preview

GET

Prijshistorie-grafiek

/{locale}/embed/zoom/bitcoin

De volledige prijshistorie van een coin als interactieve grafiek, met een keuzemenu van de topmarkten op marketcap.

Embed-snippet Voorbeeld openen

<iframe src="https://bitculator.com/nl/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>

Parameter	In	Standaard
slugDe coin of token om te charten, op slug (een actieve markt).	path	—
compactRendert een compacte layout met krappere ruimte — geschikt voor smalle kolommen.	query	false

Live preview

GET

Marketcap-flipper

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

De "flippening" — wat de prijs van het ene asset zou zijn bij de marketcap van een ander, met de impliciete multiple.

Embed-snippet Voorbeeld openen

<iframe src="https://bitculator.com/nl/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>

Parameter	In	Standaard
entity1Het asset waarvan de prijs wordt geprojecteerd, op slug (een actieve markt).	path	—
entity2Het asset waarvan de marketcap wordt toegepast, op slug (een actieve markt).	path	—
compactRendert een compacte layout met krappere ruimte — geschikt voor smalle kolommen.	query	false

Live preview

GET

DCA-simulator

/{locale}/embed/dca

Wat terugkerende wekelijkse aankopen van een coin over de afgelopen 5 jaar zouden hebben opgebouwd en opgeleverd.

Embed-snippet Voorbeeld openen

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

Parameter	In	Standaard
compactRendert een compacte layout met krappere ruimte — geschikt voor smalle kolommen.	query	false

Live preview

GET

Winstcalculator

/{locale}/embed/profit

Nettowinst, verlies en ROI uit een aankoopprijs, verkoopprijs, hoeveelheid en fees.

Embed-snippet Voorbeeld openen

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

Parameter	In	Standaard
compactRendert een compacte layout met krappere ruimte — geschikt voor smalle kolommen.	query	false

Live preview

GET

Rentecalculator

/{locale}/embed/interest

Projecteer de toekomstige waarde van een holding op basis van een startbedrag, rentevoet en samenstellingsfrequentie.

Embed-snippet Voorbeeld openen

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

Parameter	In	Standaard
compactRendert een compacte layout met krappere ruimte — geschikt voor smalle kolommen.	query	false

Live preview

GET

Belastingcalculator

/{locale}/embed/tax

Schat het belastbare bedrag en de verschuldigde belasting over handelswinsten, mining, staking, airdrops en yield.

Embed-snippet Voorbeeld openen

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

Parameter	In	Standaard
compactRendert een compacte layout met krappere ruimte — geschikt voor smalle kolommen.	query	false

Live preview

GET

Leningcalculator

/{locale}/embed/loan

Modelleer een cryptolening — aflossing, totale rente en een aflossingsoverzicht.

Embed-snippet Voorbeeld openen

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

Parameter	In	Standaard
compactRendert een compacte layout met krappere ruimte — geschikt voor smalle kolommen.	query	false

Live preview

GET

Stakingcalculator

/{locale}/embed/staking

Schat stakingbeloningen op basis van een gestaket bedrag, APR/APY en looptijd.

Embed-snippet Voorbeeld openen

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

Parameter	In	Standaard
compactRendert een compacte layout met krappere ruimte — geschikt voor smalle kolommen.	query	false

Live preview