Bitculator · Embeds · v1

Embed-віджети

Розмістіть живі криптоінструменти Bitculator прямо на власному сайті за допомогою одного <iframe> — ціновий графік у реальному часі, конвертер, marketcap-фліппер і шість калькуляторів. Без SDK, без етапу збірки.

9 віджетів Embed-ключ + домен Анонімний режим

Кожен віджет — це самодостатня сторінка під /{locale}/embed/…, яку ви розміщуєте на своєму сайті за допомогою <iframe>. Вона відображає живі ринкові дані Bitculator — той самий потік, який використовує застосунок — і не потребує JavaScript з вашого боку.

Вставте будь-де — тег script не потрібен:

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

Додайте свій embed-ключ як параметр запиту та зареєструйте домен, на якому вбудовуватимете (обидва — у вашій консолі розробника). Embed без ключа також працюють в анонімному режимі — зручно для швидкого тесту — але обмежені для кожної IP-адреси відвідувача. Кожен віджет враховує {locale} в URL і слідує cookie theme (або ?theme=dark).

Content-Security-Policy

Використовуєте Content-Security-Policy на своєму сайті? Додайте https://bitculator.com до frame-src (і child-src для старіших браузерів), щоб віджет міг завантажитися. З нашого боку нічого змінювати не потрібно — Bitculator уже дозволяє вбудовування на будь-якому домені.

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

Конструктор фрагментів

Виберіть віджет і його параметри — фрагмент embed оновлюється на льоту. Скопіюйте його або відкрийте живий попередній перегляд у новій вкладці.

Віджет

compact

Тема Embed-ключ

Фрагмент embed Відкрити приклад

Відображається наживо в анонімному режимі.

Автентифікація

Embed-ключ — це токен з дозволом api, створений у вашій консолі розробника. На відміну від ключів Data API, він передається в URL iframe як параметр запиту — ніколи не в заголовку — тож він публічний за задумом. Він несе лише дозвіл api; ключі data-api, що працюють лише як Bearer, тут відхиляються, щоб вони не потрапляли в referer чи логи.

Передавайте його як ?embed_key=… (або через аліас ?api_key=…). Запит із ключем також має надходити з домену зі списку дозволених (див. нижче). Якщо ви ввійшли в Bitculator у тому самому браузері, перевірка ключа пропускається для вашого власного сеансу.

Домени

Embed із ключем відображається лише на доменах, які ви зареєстрували. Bitculator читає Referer сторінки, що вбудовує (з поверненням до Origin), нормалізує його (у нижньому регістрі, без www. та будь-якої кінцевої крапки) і точно зіставляє зі списком дозволених. Незареєстрований або нечитабельний хост повертає 403.

Керуйте доменами у вашій консолі розробника; кожен тариф дозволяє певну кількість (нижче). Оскільки Referer/Origin встановлюється браузером відвідувача і може бути підроблений, список дозволених — це захист від випадкового повторного використання ключа, а не криптографічний доказ — у будь-якому разі вважайте ключ публічним. Анонімні embed (без ключа) не обмежуються доменом; натомість вони обмежені для кожної IP-адреси.

Квота та ліміти

Embed використовують місячний пул, повністю окремий від Data API — власний тариф, власний лічильник. Анонімні завантаження рахуються для кожної IP-адреси відвідувача (1,000/місяць); завантаження з ключем рахуються згідно з місячним лімітом вашого тарифу. Тарифи Free скидаються на початку календарного місяця; платні тарифи скидаються у ваш платіжний день.

*Відповіді embed не містять заголовків `X-Quota-** — навмисно, щоб числа квоти ніколи не потрапляли на сторінки ваших відвідувачів. Натомість стежте за використанням у [консолі розробника](/user/developer/api). (ЗаголовкиX-Quota-*`, які ви могли бачити, є лише в Data API.)

Понад ліміт

Коли віджет перевищує квоту, він повертає 429. У браузерному iframe це невелика стилізована сторінка "ліміт використання досягнуто" (щоб не ламати ваш макет); викликач JSON отримує {"message", "limit", "used"}. Додайте ключ або підвищте тариф, щоб отримати більше.

Тарифи

Тарифи embed окремі від вашого тарифу Data API. Кожен обліковий запис починає з Free; відвідувачі без ключа отримують анонімний рівень.

Тариф	Завантажень / місяць	Домени	Ключі
Free	10,000	1	2
Starter	50,000	3	5
Pro	500,000	10	10
Анонімний	1,000 на IP	—	—

Анонімний — це рівень без ключа: без доменів чи ключів, обмежений для кожної IP-адреси відвідувача. Підвищуйте тариф у консолі розробника.

Віджети

Дев'ять готових віджетів. Скопіюйте фрагмент, підставте свій ключ, зареєструйте домен — готово. Сегменти шляху (наприклад, slug монети) визначаються за slug активу і мають бути активним ринком; кожен віджет також приймає спільні параметри запиту нижче.

GET

Конвертер валют

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

Конвертуйте суму між будь-якими двома криптовалютними чи фіатними активами за живими ринковими курсами, з опціональною таблицею порівняння.

Фрагмент embed Відкрити приклад

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

Параметр	У	За замовчуванням
fromАктив, з якого конвертувати, за slug (активний ринок).	path	—
toАктив, у який конвертувати, за slug (активний ринок).	path	—
hideTableПриховати таблицю порівняння і показати лише конвертер.	query	false
compactВідображати компактний макет із щільнішими відступами — добре для вузьких колонок.	query	false

Живий попередній перегляд

GET

Графік історії цін

/{locale}/embed/zoom/bitcoin

Повна історична ціна монети у вигляді інтерактивного графіка, з вибором топових ринків за marketcap.

Фрагмент embed Відкрити приклад

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

Параметр	У	За замовчуванням
slugМонета або токен для графіка, за slug (активний ринок).	path	—
compactВідображати компактний макет із щільнішими відступами — добре для вузьких колонок.	query	false

Живий попередній перегляд

GET

Marketcap-фліппер

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

"Фліппенінг" — якою була б ціна одного активу за marketcap іншого, з відповідним множником.

Фрагмент embed Відкрити приклад

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

Параметр	У	За замовчуванням
entity1Актив, чия ціна перепроєктується, за slug (активний ринок).	path	—
entity2Актив, чий marketcap застосовується, за slug (активний ринок).	path	—
compactВідображати компактний макет із щільнішими відступами — добре для вузьких колонок.	query	false

Живий попередній перегляд

GET

Симулятор DCA

/{locale}/embed/dca

Скільки б накопичили і принесли регулярні щотижневі покупки монети за останні 5 років.

Фрагмент embed Відкрити приклад

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

Параметр	У	За замовчуванням
compactВідображати компактний макет із щільнішими відступами — добре для вузьких колонок.	query	false

Живий попередній перегляд

GET

Калькулятор прибутку

/{locale}/embed/profit

Чистий прибуток, збиток і ROI з ціни купівлі, ціни продажу, кількості та комісій.

Фрагмент embed Відкрити приклад

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

Параметр	У	За замовчуванням
compactВідображати компактний макет із щільнішими відступами — добре для вузьких колонок.	query	false

Живий попередній перегляд

GET

Калькулятор відсотків

/{locale}/embed/interest

Спрогнозуйте майбутню вартість активу з початкового капіталу, ставки та частоти нарахування складних відсотків.

Фрагмент embed Відкрити приклад

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

Параметр	У	За замовчуванням
compactВідображати компактний макет із щільнішими відступами — добре для вузьких колонок.	query	false

Живий попередній перегляд

GET

Калькулятор податків

/{locale}/embed/tax

Оцініть оподатковувану суму і належний податок за торговими прибутками, майнінгом, стейкінгом, ейрдропами та дохідністю.

Фрагмент embed Відкрити приклад

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

Параметр	У	За замовчуванням
compactВідображати компактний макет із щільнішими відступами — добре для вузьких колонок.	query	false

Живий попередній перегляд

GET

Калькулятор позик

/{locale}/embed/loan

Змоделюйте криптопозику — погашення, загальні відсотки та розбивку амортизації.

Фрагмент embed Відкрити приклад

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

Параметр	У	За замовчуванням
compactВідображати компактний макет із щільнішими відступами — добре для вузьких колонок.	query	false

Живий попередній перегляд

GET

Калькулятор стейкінгу

/{locale}/embed/staking

Оцініть винагороди за стейкінг зі стейкнутої суми, APR/APY і тривалості.

Фрагмент embed Відкрити приклад

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

Параметр	У	За замовчуванням
compactВідображати компактний макет із щільнішими відступами — добре для вузьких колонок.	query	false

Живий попередній перегляд