Bitculator
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

代码生成器

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

嵌入代码片段 打开示例

                    

以匿名模式实时渲染。

身份验证

嵌入密钥是一种具备 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
实时预览