Intégrez les outils crypto en direct de Bitculator directement sur votre propre site avec un seul <iframe> — un graphique de prix en temps réel, un convertisseur, un flipper de marketcap et six calculateurs. Aucun SDK, aucune étape de build.
9 widgetsClé embed + domaineMode anonyme
Chaque widget est une page autonome sous /{locale}/embed/… que vous intégrez à votre site avec un <iframe>. Elle affiche les données de marché en direct de Bitculator — le même flux que l'application — et ne nécessite aucun JavaScript de votre côté.
Collez-le n'importe où — aucune balise de script nécessaire :
Ajoutez votre clé embed en paramètre de requête et enregistrez le domaine sur lequel vous intégrerez (les deux dans votre console développeur). Les embeds sans clé fonctionnent aussi en mode anonyme — pratique pour un test rapide — mais sont limités par IP de visiteur. Chaque widget respecte le {locale} de l'URL et suit le cookie theme (ou ?theme=dark).
Content-Security-Policy
Vous servez une Content-Security-Policy sur votre site ? Ajoutez https://bitculator.com à votre frame-src (et à child-src pour les navigateurs plus anciens) afin que le widget puisse se charger. Rien à changer de notre côté — Bitculator autorise déjà l'intégration sur n'importe quel domaine.
Choisissez un widget et ses options — l'extrait embed se met à jour au fur et à mesure. Copiez-le, ou ouvrez un aperçu en direct dans un nouvel onglet.
Une clé embed est un token doté de l'aptitude api, créé dans votre console développeur. Contrairement aux clés Data API, elle circule dans l'URL de l'iframe en paramètre de requête — jamais dans un en-tête — elle est donc publique par conception. Elle porte uniquement l'aptitude api ; les clés data-api exclusivement Bearer sont rejetées ici afin qu'elles ne fuient pas dans les referers ou les logs.
Transmettez-la sous la forme ?embed_key=… (ou l'alias ?api_key=…). Une requête avec clé doit aussi provenir d'un domaine autorisé (voir ci-dessous). Si vous êtes connecté à Bitculator dans le même navigateur, la vérification de la clé est ignorée pour votre propre session.
Domaines
Un embed avec clé ne s'affiche que sur les domaines que vous avez enregistrés. Bitculator lit le Referer de la page d'intégration (à défaut, l'Origin), le normalise (mis en minuscules, www. et tout point final supprimés) et le compare exactement à votre liste d'autorisation. Un hôte non enregistré ou illisible renvoie 403.
Gérez les domaines dans votre console développeur ; chaque forfait en autorise un nombre défini (ci-dessous). Comme le Referer/Origin est défini par le navigateur du visiteur et peut être falsifié, la liste d'autorisation protège contre une réutilisation occasionnelle de la clé, ce n'est pas une preuve cryptographique — considérez la clé comme publique dans tous les cas. Les embeds anonymes (sans clé) ne sont pas restreints par domaine ; ils sont limités par IP à la place.
Quota & limites
Les embeds puisent dans une réserve mensuelle entièrement distincte de la Data API — son propre forfait, son propre compteur. Les chargements anonymes comptent par IP de visiteur (1,000/mois) ; les chargements avec clé comptent sur la limite mensuelle de votre forfait. Les forfaits Free se réinitialisent au mois calendaire ; les forfaits payants se réinitialisent à votre jour de facturation.
*Les réponses embed ne transportent aucun en-tête `X-Quota-** — délibérément, afin que les chiffres de quota ne fuient jamais dans les pages de vos visiteurs. Surveillez plutôt votre utilisation dans la [console développeur](/user/developer/api). (Les en-têtesX-Quota-*` que vous avez pu voir n'existent que sur la Data API.)
Au-delà de la limite
Lorsqu'un widget dépasse son quota, il renvoie 429. Dans une iframe de navigateur, c'est une petite page stylée « limite d'utilisation atteinte » (pour que votre mise en page ne casse pas) ; un appelant JSON reçoit {"message", "limit", "used"}. Ajoutez une clé, ou passez à un forfait supérieur, pour en obtenir davantage.
Forfaits
Les forfaits embed sont distincts de votre forfait Data API. Chaque compte démarre sur Free ; les visiteurs sans clé bénéficient du palier anonyme.
Forfait
Chargements / mois
Domaines
Clés
Free
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Anonyme
1,000 par IP
—
—
Anonyme est le palier sans clé — aucun domaine ni clé, limité par IP de visiteur. Mettez à niveau dans la console développeur.
Widgets
Neuf widgets prêts à l'emploi. Copiez un extrait, insérez votre clé, enregistrez votre domaine — c'est fait. Les segments de chemin (comme un slug de coin) se résolvent par le slug de l'actif et doivent correspondre à un marché actif ; chaque widget accepte également les paramètres de requête partagés ci-dessous.
GET
Convertisseur de devises
/{locale}/embed/converter/bitcoin/usd
Convertissez un montant entre deux actifs crypto ou fiat quelconques aux taux de marché en direct, avec un tableau de comparaison optionnel.