Bitculator · Embedy · v1

Embed widgety

Umístěte živé krypto nástroje Bitculator přímo na svůj web pomocí jediného <iframe> — cenový graf v reálném čase, převodník, marketcap flipper a šest kalkulaček. Žádné SDK, žádný build krok.

9 widgetů Embed klíč + doména Anonymní režim

Každý widget je samostatná stránka pod /{locale}/embed/…, kterou vložíte na svůj web pomocí <iframe>. Vykresluje živá tržní data Bitculator — stejný feed, jaký používá aplikace — a nevyžaduje žádný JavaScript na vaší straně.

Vložte jej kamkoli — žádný script tag není potřeba:

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

Přidejte svůj embed klíč jako query parametr a zaregistrujte doménu, na kterou budete embedovat (obojí ve vaší vývojářské konzoli). Embedy bez klíče fungují i v anonymním režimu — hodí se pro rychlý test — ale jsou omezené na IP návštěvníka. Každý widget respektuje {locale} v URL a řídí se cookie theme (nebo ?theme=dark).

Content-Security-Policy

Servírujete na svém webu Content-Security-Policy? Přidejte https://bitculator.com do direktivy frame-src (a child-src pro starší prohlížeče), aby se widget mohl načíst. Na naší straně není potřeba nic měnit — Bitculator už embedování na libovolné doméně povoluje.

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

Průvodce snippetem

Vyberte widget a jeho možnosti — embed snippet se průběžně aktualizuje. Zkopírujte jej, nebo otevřete živý náhled v nové kartě.

Widget

compact

Motiv Embed klíč

Embed snippet Otevřít příklad

Vykresleno živě v anonymním režimu.

Autentizace

Embed klíč je token se schopností api, vytvořený ve vaší vývojářské konzoli. Na rozdíl od klíčů Data API se přenáší v URL iframu jako query parametr — nikdy v hlavičce — takže je ze své podstaty veřejný. Nese pouze schopnost api; klíče data-api určené výhradně pro Bearer jsou zde odmítnuty, aby nemohly uniknout do refererů nebo logů.

Předejte jej jako ?embed_key=… (nebo alias ?api_key=…). Požadavek s klíčem musí také přicházet z povolené domény (viz níže). Pokud jste ve stejném prohlížeči přihlášeni na Bitculator, kontrola klíče se pro vaši vlastní relaci přeskočí.

Domény

Embed s klíčem se vykreslí pouze na doménách, které jste zaregistrovali. Bitculator čte Referer embedující stránky (s návratem na Origin), normalizuje jej (malými písmeny, odstraní www. a případnou koncovou tečku) a přesně jej porovná s vaším seznamem povolených. Nezaregistrovaný nebo nečitelný host vrátí 403.

Spravujte domény ve své vývojářské konzoli; každý plán povoluje určitý počet (níže). Protože Referer/Origin nastavuje prohlížeč návštěvníka a lze je zfalšovat, seznam povolených je ochranou proti běžnému zneužití klíče, nikoli kryptografickým důkazem — v každém případě považujte klíč za veřejný. Anonymní embedy (bez klíče) nejsou omezeny doménou; místo toho jsou omezeny na IP.

Kvóta a limity

Embedy čerpají z měsíčního fondu, který je zcela oddělený od Data API — vlastní plán, vlastní počítadlo. Anonymní načtení se počítají na IP návštěvníka (1,000/měsíc); načtení s klíčem se počítají vůči měsíčnímu limitu vašeho plánu. Free plány se resetují na kalendářní měsíc; placené plány se resetují ve váš fakturační den.

*Embed odpovědi nenesou žádné hlavičky `X-Quota-** — záměrně, aby čísla kvóty nikdy neunikla na stránky vašich návštěvníků. Místo toho sledujte své využití ve [vývojářské konzoli](/user/developer/api). (HlavičkyX-Quota-*`, které jste možná viděli, jsou pouze na Data API.)

Přes limit

Když widget překročí kvótu, vrátí 429. V iframu prohlížeče je to malá stylizovaná stránka „limit využití dosažen“ (aby se váš layout nerozbil); volající JSON dostane {"message", "limit", "used"}. Pro více přidejte klíč nebo si upgradujte plán.

Plány

Embed plány jsou oddělené od vašeho plánu Data API. Každý účet začíná na Free; návštěvníci bez klíče dostávají anonymní úroveň.

Plán	Načtení / měsíc	Domény	Klíče
Free	10,000	1	2
Starter	50,000	3	5
Pro	500,000	10	10
Anonymní	1,000 na IP	—	—

Anonymní je úroveň bez klíče — žádné domény ani klíče, omezeno na IP návštěvníka. Upgradujte ve vývojářské konzoli.

Widgety

Devět hotových widgetů. Zkopírujte snippet, vložte svůj klíč, zaregistrujte doménu — hotovo. Segmenty cesty (jako slug coinu) se řeší podle slugu aktiva a musí být aktivním trhem; každý widget také přijímá sdílené query parametry níže.

GET

Převodník měn

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

Převeďte částku mezi libovolnými dvěma krypto nebo fiat aktivy za živé tržní kurzy, s volitelnou srovnávací tabulkou.

Embed snippet Otevřít příklad

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

Parametr	V	Výchozí
fromAktivum, ze kterého se převádí, podle slugu (aktivní trh).	cesta	—
toAktivum, na které se převádí, podle slugu (aktivní trh).	cesta	—
hideTableSkryje srovnávací tabulku a zobrazí pouze převodník.	dotaz	false
compactVykreslí zhuštěné rozvržení s menšími rozestupy — vhodné pro úzké sloupce.	dotaz	false

Živý náhled

GET

Graf cenové historie

/{locale}/embed/zoom/bitcoin

Kompletní historická cena coinu jako interaktivní graf, s výběrem předních trhů podle marketcapu.

Embed snippet Otevřít příklad

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

Parametr	V	Výchozí
slugCoin nebo token pro graf, podle slugu (aktivní trh).	cesta	—
compactVykreslí zhuštěné rozvržení s menšími rozestupy — vhodné pro úzké sloupce.	dotaz	false

Živý náhled

GET

Marketcap flipper

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

„Flippening“ — jaká by byla cena jednoho aktiva při marketcapu druhého, s implikovaným násobkem.

Embed snippet Otevřít příklad

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

Parametr	V	Výchozí
entity1Aktivum, jehož cena se přepočítává, podle slugu (aktivní trh).	cesta	—
entity2Aktivum, jehož marketcap se aplikuje, podle slugu (aktivní trh).	cesta	—
compactVykreslí zhuštěné rozvržení s menšími rozestupy — vhodné pro úzké sloupce.	dotaz	false

Živý náhled

GET

DCA simulátor

/{locale}/embed/dca

Kolik by opakované týdenní nákupy coinu za posledních 5 let naakumulovaly a vynesly.

Embed snippet Otevřít příklad

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

Parametr	V	Výchozí
compactVykreslí zhuštěné rozvržení s menšími rozestupy — vhodné pro úzké sloupce.	dotaz	false

Živý náhled

GET

Kalkulačka zisku

/{locale}/embed/profit

Čistý zisk, ztráta a ROI z nákupní ceny, prodejní ceny, množství a poplatků.

Embed snippet Otevřít příklad

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

Parametr	V	Výchozí
compactVykreslí zhuštěné rozvržení s menšími rozestupy — vhodné pro úzké sloupce.	dotaz	false

Živý náhled

GET

Kalkulačka úroků

/{locale}/embed/interest

Odhadněte budoucí hodnotu držby z počáteční jistiny, sazby a frekvence úročení.

Embed snippet Otevřít příklad

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

Parametr	V	Výchozí
compactVykreslí zhuštěné rozvržení s menšími rozestupy — vhodné pro úzké sloupce.	dotaz	false

Živý náhled

GET

Daňová kalkulačka

/{locale}/embed/tax

Odhadněte zdanitelnou částku a splatnou daň z obchodních zisků, těžby, stakingu, airdropů a výnosů.

Embed snippet Otevřít příklad

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

Parametr	V	Výchozí
compactVykreslí zhuštěné rozvržení s menšími rozestupy — vhodné pro úzké sloupce.	dotaz	false

Živý náhled

GET

Kalkulačka půjček

/{locale}/embed/loan

Modelujte krypto půjčku — splátky, celkový úrok a rozpis amortizace.

Embed snippet Otevřít příklad

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

Parametr	V	Výchozí
compactVykreslí zhuštěné rozvržení s menšími rozestupy — vhodné pro úzké sloupce.	dotaz	false

Živý náhled

GET

Kalkulačka stakingu

/{locale}/embed/staking

Odhadněte odměny za staking ze stakované částky, APR/APY a doby trvání.

Embed snippet Otevřít příklad

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

Parametr	V	Výchozí
compactVykreslí zhuštěné rozvržení s menšími rozestupy — vhodné pro úzké sloupce.	dotaz	false

Živý náhled