Bitculator · Embed · v1

Widżety embed

Umieść narzędzia krypto Bitculator na żywo bezpośrednio na własnej stronie za pomocą jednego <iframe> — wykres cen w czasie rzeczywistym, konwerter, przelicznik marketcap i sześć kalkulatorów. Bez SDK, bez etapu budowania.

9 widżetów Klucz embed + domena Tryb anonimowy

Każdy widżet to samodzielna strona pod /{locale}/embed/…, którą umieszczasz na swojej stronie za pomocą <iframe>. Renderuje dane rynkowe Bitculator na żywo — ten sam strumień, którego używa aplikacja — i nie wymaga JavaScriptu po Twojej stronie.

Wklej to gdziekolwiek — bez potrzeby tagu skryptu:

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

Dodaj swój klucz embed jako parametr zapytania i zarejestruj domenę, na której będziesz osadzać (oba w Twojej konsoli deweloperskiej). Embedy bez klucza działają też w trybie anonimowym — przydatne do szybkiego testu — ale są ograniczone na IP odwiedzającego. Każdy widżet respektuje {locale} w adresie URL i podąża za ciasteczkiem theme (lub ?theme=dark).

Content-Security-Policy

Serwujesz na swojej stronie nagłówek Content-Security-Policy? Dodaj https://bitculator.com do frame-src (oraz child-src dla starszych przeglądarek), aby widżet mógł się załadować. Po naszej stronie nic nie trzeba zmieniać — Bitculator już zezwala na osadzanie na dowolnej domenie.

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

Kreator fragmentów

Wybierz widżet i jego opcje — fragment embed aktualizuje się na bieżąco. Skopiuj go lub otwórz podgląd na żywo w nowej karcie.

Widżet

compact

Motyw Klucz embed

Fragment embed Otwórz przykład

Renderowane na żywo w trybie anonimowym.

Uwierzytelnianie

Klucz embed to token z uprawnieniem api, tworzony w Twojej konsoli deweloperskiej. W odróżnieniu od kluczy Data API, jedzie w adresie URL iframe jako parametr zapytania — nigdy w nagłówku — więc z założenia jest publiczny. Niesie wyłącznie uprawnienie api; klucze data-api działające tylko jako Bearer są tutaj odrzucane, aby nie mogły wyciekać do refererów ani logów.

Przekaż go jako ?embed_key=… (lub alias ?api_key=…). Zapytanie z kluczem musi też pochodzić z domeny z listy dozwolonych (patrz niżej). Jeśli jesteś zalogowany do Bitculator w tej samej przeglądarce, sprawdzanie klucza jest pomijane dla Twojej własnej sesji.

Domeny

Embed z kluczem renderuje się tylko na domenach, które zarejestrowałeś. Bitculator odczytuje Referer osadzającej strony (z powrotem do Origin), normalizuje go (małe litery, usunięte www. i ewentualna końcowa kropka) i dopasowuje dokładnie do Twojej listy dozwolonych. Niezarejestrowany lub nieodczytywalny host zwraca 403.

Zarządzaj domenami w swojej konsoli deweloperskiej; każdy plan pozwala na określoną liczbę (poniżej). Ponieważ Referer/Origin jest ustawiany przez przeglądarkę odwiedzającego i może zostać sfałszowany, lista dozwolonych to zabezpieczenie przed przypadkowym ponownym użyciem klucza, a nie dowód kryptograficzny — tak czy inaczej traktuj klucz jako publiczny. Anonimowe embedy (bez klucza) nie są ograniczane domeną; zamiast tego są ograniczane na IP.

Limit i ograniczenia

Embedy czerpią z miesięcznej puli całkowicie oddzielnej od Data API — z własnym planem, własnym licznikiem. Anonimowe załadowania liczone są na IP odwiedzającego (1,000/miesiąc); załadowania z kluczem liczone są względem miesięcznego limitu Twojego planu. Plany Free resetują się w miesiącu kalendarzowym; plany płatne resetują się w Twoim dniu rozliczeniowym.

*Odpowiedzi embed nie niosą nagłówków `X-Quota-** — celowo, aby liczby limitu nigdy nie wyciekały na strony Twoich odwiedzających. Zamiast tego obserwuj swoje zużycie w [konsoli deweloperskiej](/user/developer/api). (NagłówkiX-Quota-*`, które mogłeś widzieć, są tylko w Data API.)

Powyżej limitu

Gdy widżet przekroczy limit, zwraca 429. W iframe przeglądarki to mała stylizowana strona „osiągnięto limit użycia” (aby Twój układ się nie zepsuł); wywołujący JSON otrzymuje {"message", "limit", "used"}. Dodaj klucz lub podnieś swój plan, aby mieć więcej.

Plany

Plany embed są oddzielne od Twojego planu Data API. Każde konto zaczyna od Free; odwiedzający bez klucza otrzymują poziom anonimowy.

Plan	Załadowania / miesiąc	Domeny	Klucze
Free	10,000	1	2
Starter	50,000	3	5
Pro	500,000	10	10
Anonimowy	1,000 na IP	—	—

Anonimowy to poziom bez klucza — bez domen ani kluczy, ograniczony na IP odwiedzającego. Podnieś plan w konsoli deweloperskiej.

Widżety

Dziewięć gotowych widżetów. Skopiuj fragment, wstaw swój klucz, zarejestruj domenę — gotowe. Segmenty ścieżki (jak slug monety) rozwiązywane są po slugu aktywa i muszą być aktywnym rynkiem; każdy widżet przyjmuje też wspólne parametry zapytania poniżej.

GET

Konwerter walut

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

Przelicz kwotę między dowolnymi dwoma aktywami krypto lub fiat po kursach rynkowych na żywo, z opcjonalną tabelą porównawczą.

Fragment embed Otwórz przykład

<iframe src="https://bitculator.com/pl/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	Miejsce	Domyślnie
fromAktywo, z którego przeliczasz, po slugu (aktywny rynek).	ścieżka	—
toAktywo, na które przeliczasz, po slugu (aktywny rynek).	ścieżka	—
hideTableUkryj tabelę porównawczą i pokaż tylko konwerter.	zapytanie	false
compactRenderuj zwarty układ z ciaśniejszymi odstępami — dobry do wąskich kolumn.	zapytanie	false

Podgląd na żywo

GET

Wykres historii cen

/{locale}/embed/zoom/bitcoin

Pełna historia ceny monety jako interaktywny wykres, z selektorem najlepszych rynków według marketcap.

Fragment embed Otwórz przykład

<iframe src="https://bitculator.com/pl/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	Miejsce	Domyślnie
slugMoneta lub token do wykresu, po slugu (aktywny rynek).	ścieżka	—
compactRenderuj zwarty układ z ciaśniejszymi odstępami — dobry do wąskich kolumn.	zapytanie	false

Podgląd na żywo

GET

Przelicznik marketcap

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

Efekt „flippening” — jaka byłaby cena jednego aktywa przy marketcap innego, wraz z wynikającym mnożnikiem.

Fragment embed Otwórz przykład

<iframe src="https://bitculator.com/pl/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	Miejsce	Domyślnie
entity1Aktywo, którego cena jest przeliczana, po slugu (aktywny rynek).	ścieżka	—
entity2Aktywo, którego marketcap jest zastosowany, po slugu (aktywny rynek).	ścieżka	—
compactRenderuj zwarty układ z ciaśniejszymi odstępami — dobry do wąskich kolumn.	zapytanie	false

Podgląd na żywo

GET

Symulator DCA

/{locale}/embed/dca

Ile cotygodniowe cykliczne zakupy monety w ciągu ostatnich 5 lat by zgromadziły i zwróciły.

Fragment embed Otwórz przykład

<iframe src="https://bitculator.com/pl/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	Miejsce	Domyślnie
compactRenderuj zwarty układ z ciaśniejszymi odstępami — dobry do wąskich kolumn.	zapytanie	false

Podgląd na żywo

GET

Kalkulator zysku

/{locale}/embed/profit

Zysk netto, strata i ROI z ceny zakupu, ceny sprzedaży, ilości i opłat.

Fragment embed Otwórz przykład

<iframe src="https://bitculator.com/pl/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	Miejsce	Domyślnie
compactRenderuj zwarty układ z ciaśniejszymi odstępami — dobry do wąskich kolumn.	zapytanie	false

Podgląd na żywo

GET

Kalkulator odsetek

/{locale}/embed/interest

Prognozuj przyszłą wartość pozycji na podstawie kapitału początkowego, stopy i częstotliwości kapitalizacji.

Fragment embed Otwórz przykład

<iframe src="https://bitculator.com/pl/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	Miejsce	Domyślnie
compactRenderuj zwarty układ z ciaśniejszymi odstępami — dobry do wąskich kolumn.	zapytanie	false

Podgląd na żywo

GET

Kalkulator podatku

/{locale}/embed/tax

Oszacuj kwotę podlegającą opodatkowaniu i należny podatek od zysków z tradingu, kopania, stakingu, airdropów i dochodu.

Fragment embed Otwórz przykład

<iframe src="https://bitculator.com/pl/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	Miejsce	Domyślnie
compactRenderuj zwarty układ z ciaśniejszymi odstępami — dobry do wąskich kolumn.	zapytanie	false

Podgląd na żywo

GET

Kalkulator pożyczki

/{locale}/embed/loan

Modeluj pożyczkę krypto — spłatę, całkowite odsetki i rozbicie amortyzacji.

Fragment embed Otwórz przykład

<iframe src="https://bitculator.com/pl/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	Miejsce	Domyślnie
compactRenderuj zwarty układ z ciaśniejszymi odstępami — dobry do wąskich kolumn.	zapytanie	false

Podgląd na żywo

GET

Kalkulator stakingu

/{locale}/embed/staking

Oszacuj nagrody ze stakingu na podstawie zastakowanej kwoty, APR/APY i czasu trwania.

Fragment embed Otwórz przykład

<iframe src="https://bitculator.com/pl/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	Miejsce	Domyślnie
compactRenderuj zwarty układ z ciaśniejszymi odstępami — dobry do wąskich kolumn.	zapytanie	false

Podgląd na żywo