Bitculator · Embeds · v1

嵌入组件

只需一个 <iframe>，即可将 Bitculator 的实时加密工具直接放到你自己的网站上 — 实时价格图表、货币转换器、市值翻转器和六个计算器。无需 SDK，无需构建步骤。

9 个组件嵌入密钥 + 域名匿名模式

每个组件都是位于 /{locale}/embed/… 下的独立页面，你可以用 <iframe> 将其放入网站。它会渲染 Bitculator 的实时市场数据 — 与应用使用的是同一数据源 — 且无需在你这一侧编写任何 JavaScript。

粘贴到任何地方 — 无需 script 标签：

<iframe src="https://bitculator.com/zh/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 cookie（或 ?theme=dark）。

Content-Security-Policy

在你的网站上启用了 Content-Security-Policy？请将 https://bitculator.com 添加到你的 frame-src（以及针对旧版浏览器的 child-src）中，以便小组件能够加载。我方无需做任何更改 — Bitculator 已允许在任何域名上进行嵌入。

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

代码生成器

选择一个组件及其选项 — 嵌入代码会随之实时更新。复制代码，或在新标签页中打开实时预览。

组件

compact

主题嵌入密钥

嵌入代码片段打开示例

以匿名模式实时渲染。

身份验证

嵌入密钥是一种具备 api 权限的令牌，在你的开发者控制台中创建。与 Data API 密钥不同，它以查询参数的形式随 iframe URL 传递 — 绝不放在请求头中 — 因此从设计上就是公开的。它仅携带 api 权限；仅支持 Bearer 的 data-api 密钥在此会被拒绝，以免泄露到 referer 或日志中。

将其作为 ?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 加以限制。请在开发者控制台中升级。

组件

九个即插即用的组件。复制代码片段，换上你的密钥，注册你的域名 — 完成。路径片段（例如币种 slug）会按资产的 slug 解析，且必须是活跃市场；每个组件也都接受下方的共享查询参数。

GET

货币转换器

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

按实时市场汇率在任意两种加密货币或法币资产之间转换金额，并可选带对比表。

嵌入代码片段打开示例

<iframe src="https://bitculator.com/zh/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 指定（活跃市场）。	路径	—
to要转换到的目标资产，按 slug 指定（活跃市场）。	路径	—
hideTable隐藏对比表，仅显示转换器。	查询	false
compact渲染更紧凑的布局，间距更小 — 适合狭窄的栏目。	查询	false

实时预览

GET

价格历史图表

/{locale}/embed/zoom/bitcoin

以交互式图表展示某币种的完整历史价格，并附带按市值排名的头部市场选择器。

嵌入代码片段打开示例

<iframe src="https://bitculator.com/zh/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 指定（活跃市场）。	路径	—
compact渲染更紧凑的布局，间距更小 — 适合狭窄的栏目。	查询	false

实时预览

GET

市值翻转器

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

「翻转」（flippening）— 若某资产采用另一资产的市值，其价格会是多少，并给出隐含倍数。

嵌入代码片段打开示例

<iframe src="https://bitculator.com/zh/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 指定（活跃市场）。	路径	—
entity2被套用市值的资产，按 slug 指定（活跃市场）。	路径	—
compact渲染更紧凑的布局，间距更小 — 适合狭窄的栏目。	查询	false

实时预览

GET

DCA 模拟器

/{locale}/embed/dca

若在过去 5 年间每周定投买入某币种，会累积多少并获得怎样的回报。

嵌入代码片段打开示例

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

实时预览