Bitculator · 埋め込み · v1

埋め込みウィジェット

Bitculator のライブな暗号資産ツールを、たった一つの <iframe> であなたのサイトにそのまま設置できます — リアルタイムの価格チャート、コンバーター、時価総額フリッパー、そして 6 種類の計算ツール。SDK もビルド工程も不要です。

9 個のウィジェット埋め込みキー + ドメイン匿名モード

すべてのウィジェットは /{locale}/embed/… 配下の自己完結型ページで、<iframe> であなたのサイトに設置します。Bitculator のライブなマーケットデータ — アプリが使用しているのと同じフィード — を表示し、あなたの側での JavaScript は不要です。

どこにでも貼り付けるだけ — スクリプトタグは不要です:

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

埋め込みキー をクエリパラメータとして追加し、埋め込み先のドメインを登録してください（どちらも開発者コンソールで設定します）。キーなしの埋め込みは 匿名モード でも動作し — ちょっとしたテストに便利です — ただし訪問者の IP ごとに制限があります。すべてのウィジェットは URL 内の {locale} を尊重し、theme クッキー（または ?theme=dark）に従います。

Content-Security-Policy

サイトで Content-Security-Policy を配信していますか？ウィジェットを読み込めるように、frame-src（および古いブラウザ向けに child-src）に https://bitculator.com を追加してください。こちら側で変更する必要はありません — Bitculator はすでにあらゆるドメインでの埋め込みを許可しています。

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

スニペットビルダー

ウィジェットとそのオプションを選ぶと、埋め込みスニペットがその場で更新されます。コピーするか、新しいタブでライブプレビューを開いてください。

ウィジェット

compact

テーマ埋め込みキー

埋め込みスニペット例を開く

匿名モードでライブ表示されています。

認証

埋め込みキーは api 権限を持つトークンで、開発者コンソールで発行します。Data API キーとは異なり、iframe の URL にクエリパラメータとして 載り — ヘッダーには決して載らず — 設計上パブリックです。持つのは api 権限のみで、Bearer 専用の data-api キーはここでは拒否されるため、リファラーやログに漏れることはありません。

?embed_key=…（またはエイリアスの ?api_key=…）として渡してください。キー付きのリクエストは、許可リストに登録されたドメインからのものである必要もあります（下記参照）。同じブラウザで Bitculator にログインしている場合、あなた自身のセッションではキーのチェックはスキップされます。

ドメイン

キー付きの埋め込みは、登録したドメインでのみ表示されます。Bitculator は埋め込みページの Referer（なければ Origin）を読み取り、正規化して（小文字化し、www. と末尾のドットを除去）、あなたの許可リストと完全一致で照合します。未登録または読み取れないホストは 403 を返します。

ドメインは開発者コンソールで管理します。各プランで許可される数が決まっています（下記）。Referer/Origin は訪問者のブラウザが設定するもので偽装できるため、許可リストは安易なキーの再利用を防ぐガードであって暗号学的な証明ではありません — いずれにせよキーはパブリックとして扱ってください。匿名（キーなし）の埋め込みはドメインで制限されず、代わりに IP ごとに制限されます。

クォータと制限

埋め込みは Data API とは完全に分離された月間プール から消費します — 独自のプラン、独自のカウンターです。匿名の読み込みは訪問者の IP ごとにカウントされ（毎月 1,000 回）、キー付きの読み込みはあなたのプランの月間上限に対してカウントされます。Free プランは暦月でリセットされ、有料プランは 請求日 でリセットされます。

*埋め込みのレスポンスには `X-Quota-ヘッダーは付きません** — 意図的にそうしており、クォータの数値が訪問者のページに漏れることはありません。代わりに [開発者コンソール](/user/developer/api) で使用状況を確認してください。（見かけたことがあるかもしれないX-Quota-*` ヘッダーは Data API のみに付きます。）

上限を超えた場合

ウィジェットがクォータを超えると 429 を返します。ブラウザの iframe 内では、スタイル付きの小さな「使用制限に達しました」ページが表示されます（レイアウトが崩れないように）。JSON の呼び出し元には {"message", "limit", "used"} が返されます。さらに増やすにはキーを追加するか、プランをアップグレードしてください。

プラン

埋め込みのプランは Data API のプランとは別です。すべてのアカウントは Free から始まり、キーなしの訪問者は匿名ティアになります。

プラン	読み込み / 月	ドメイン	キー
Free	10,000	1	2
Starter	50,000	3	5
Pro	500,000	10	10
匿名	1,000 IP ごと	—	—

匿名はキーなしのティアです — ドメインもキーもなく、訪問者の IP ごとに制限されます。開発者コンソールでアップグレードできます。

ウィジェット

設置するだけの 9 個のウィジェット。スニペットをコピーし、キーを差し替え、ドメインを登録すれば完了です。パス部分（コインのスラッグなど）は資産のスラッグで解決され、アクティブなマーケットである必要があります。すべてのウィジェットは下記の共有クエリパラメータも受け付けます。

GET

通貨コンバーター

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

任意の 2 つの暗号資産または法定通貨の間で、ライブの市場レートで金額を変換します。任意で比較テーブルも表示できます。

埋め込みスニペット例を開く

<iframe src="https://bitculator.com/ja/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変換元の資産をスラッグで指定します（アクティブなマーケット）。	パス	—
to変換先の資産をスラッグで指定します（アクティブなマーケット）。	パス	—
hideTable比較テーブルを非表示にし、コンバーターのみを表示します。	クエリ	false
compact余白を詰めた凝縮レイアウトで表示します — 幅の狭いカラムに適しています。	クエリ	false

ライブプレビュー

GET

価格履歴チャート

/{locale}/embed/zoom/bitcoin

コインの全期間の価格履歴をインタラクティブなチャートで表示し、時価総額上位のマーケットを選べるピッカー付きです。

埋め込みスニペット例を開く

<iframe src="https://bitculator.com/ja/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チャートに表示するコインまたはトークンをスラッグで指定します（アクティブなマーケット）。	パス	—
compact余白を詰めた凝縮レイアウトで表示します — 幅の狭いカラムに適しています。	クエリ	false

ライブプレビュー

GET

時価総額フリッパー

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

「フリッペニング」 — ある資産が別の資産の時価総額になったときの価格を、その倍率とともに示します。

埋め込みスニペット例を開く

<iframe src="https://bitculator.com/ja/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価格が再投影される資産をスラッグで指定します（アクティブなマーケット）。	パス	—
entity2時価総額が適用される資産をスラッグで指定します（アクティブなマーケット）。	パス	—
compact余白を詰めた凝縮レイアウトで表示します — 幅の狭いカラムに適しています。	クエリ	false

ライブプレビュー

GET

DCA シミュレーター

/{locale}/embed/dca

過去 5 年間、毎週コインを定期購入していた場合に積み上がった量とリターンを示します。

埋め込みスニペット例を開く

<iframe src="https://bitculator.com/ja/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余白を詰めた凝縮レイアウトで表示します — 幅の狭いカラムに適しています。	クエリ	false

ライブプレビュー

GET

利益計算ツール

/{locale}/embed/profit

購入価格・売却価格・数量・手数料から、純利益・損失・ROI を算出します。

埋め込みスニペット例を開く

<iframe src="https://bitculator.com/ja/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余白を詰めた凝縮レイアウトで表示します — 幅の狭いカラムに適しています。	クエリ	false

ライブプレビュー

GET

利息計算ツール

/{locale}/embed/interest

元本・利率・複利頻度から、保有資産の将来価値を予測します。

埋め込みスニペット例を開く

<iframe src="https://bitculator.com/ja/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余白を詰めた凝縮レイアウトで表示します — 幅の狭いカラムに適しています。	クエリ	false

ライブプレビュー

GET

税金計算ツール

/{locale}/embed/tax

トレードの利益、マイニング、ステーキング、エアドロップ、イールドにわたって課税対象額と納税額を見積もります。

埋め込みスニペット例を開く

<iframe src="https://bitculator.com/ja/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余白を詰めた凝縮レイアウトで表示します — 幅の狭いカラムに適しています。	クエリ	false

ライブプレビュー

GET

ローン計算ツール

/{locale}/embed/loan

暗号資産ローンをモデル化します — 返済額、総利息、そして償却の内訳。

埋め込みスニペット例を開く

<iframe src="https://bitculator.com/ja/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余白を詰めた凝縮レイアウトで表示します — 幅の狭いカラムに適しています。	クエリ	false

ライブプレビュー

GET

ステーキング計算ツール

/{locale}/embed/staking

ステーキング額・APR/APY・期間から、ステーキング報酬を見積もります。

埋め込みスニペット例を開く

<iframe src="https://bitculator.com/ja/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余白を詰めた凝縮レイアウトで表示します — 幅の狭いカラムに適しています。	クエリ	false

ライブプレビュー