Bitculator · Embeds · v1

Widget nhúng

Đưa các công cụ crypto trực tiếp của Bitculator thẳng lên trang web của bạn chỉ với một <iframe> duy nhất — biểu đồ giá thời gian thực, công cụ chuyển đổi, công cụ hoán đổi marketcap và sáu công cụ tính toán. Không cần SDK, không cần bước build.

9 widget Embed key + tên miền Chế độ ẩn danh

Mỗi widget là một trang độc lập nằm dưới /{locale}/embed/… mà bạn cắm vào trang web của mình bằng một <iframe>. Nó hiển thị dữ liệu thị trường trực tiếp của Bitculator — cùng nguồn dữ liệu mà ứng dụng sử dụng — và không cần JavaScript ở phía bạn.

Dán vào bất cứ đâu — không cần thẻ script:

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

Thêm embed key của bạn dưới dạng tham số truy vấn và đăng ký tên miền bạn sẽ nhúng lên (cả hai đều trong bảng điều khiển nhà phát triển của bạn). Các embed không có key cũng hoạt động ở chế độ ẩn danh — tiện cho việc kiểm tra nhanh — nhưng bị giới hạn theo IP của khách truy cập. Mỗi widget tôn trọng {locale} trong URL và tuân theo cookie theme (hoặc ?theme=dark).

Content-Security-Policy

Đang phục vụ một Content-Security-Policy trên trang web của bạn? Thêm https://bitculator.com vào frame-src (và child-src cho các trình duyệt cũ) để widget có thể tải. Không cần thay đổi gì ở phía chúng tôi — Bitculator đã cho phép nhúng trên bất kỳ tên miền nào.

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

Trình tạo đoạn mã

Chọn một widget và các tùy chọn của nó — đoạn mã nhúng sẽ cập nhật theo từng thao tác. Sao chép nó, hoặc mở bản xem trước trực tiếp trong một tab mới.

Widget

compact

Giao diện Embed key

Đoạn mã nhúng Mở ví dụ

Được hiển thị trực tiếp ở chế độ ẩn danh.

Xác thực

Một embed key là một token có quyền api, được tạo trong bảng điều khiển nhà phát triển của bạn. Không giống các Data API key, nó nằm trong URL của iframe dưới dạng tham số truy vấn — không bao giờ trong header — nên về bản chất nó là công khai. Nó chỉ mang quyền api; các key data-api chỉ dùng Bearer bị từ chối ở đây để chúng không thể rò rỉ vào referer hoặc log.

Truyền nó dưới dạng ?embed_key=… (hoặc bí danh ?api_key=…). Một request có key cũng phải đến từ một tên miền nằm trong danh sách cho phép (xem bên dưới). Nếu bạn đã đăng nhập vào Bitculator trong cùng trình duyệt, việc kiểm tra key sẽ được bỏ qua cho phiên của chính bạn.

Tên miền

Một embed có key chỉ hiển thị trên các tên miền bạn đã đăng ký. Bitculator đọc Referer của trang nhúng (dự phòng bằng Origin), chuẩn hóa nó (chuyển về chữ thường, loại bỏ www. và bất kỳ dấu chấm cuối nào) và khớp chính xác với danh sách cho phép của bạn. Một host chưa đăng ký hoặc không đọc được sẽ trả về 403.

Quản lý các tên miền trong bảng điều khiển nhà phát triển của bạn; mỗi gói cho phép một số lượng nhất định (bên dưới). Vì Referer/Origin do trình duyệt của khách truy cập đặt và có thể bị giả mạo, danh sách cho phép là một biện pháp bảo vệ chống việc tái sử dụng key một cách tùy tiện, chứ không phải bằng chứng mật mã — dù sao cũng hãy coi key là công khai. Các embed ẩn danh (không có key) không bị giới hạn theo tên miền; thay vào đó chúng bị giới hạn theo IP.

Hạn ngạch & giới hạn

Các embed rút từ một quỹ hàng tháng hoàn toàn tách biệt với Data API — gói riêng, bộ đếm riêng. Các lượt tải ẩn danh được tính theo IP khách truy cập (1,000/tháng); các lượt tải có key được tính vào giới hạn hàng tháng của gói bạn. Các gói Free đặt lại theo tháng dương lịch; các gói trả phí đặt lại vào ngày thanh toán của bạn.

*Các phản hồi embed không mang header `X-Quota-** — một cách có chủ đích, để các con số hạn ngạch không bao giờ rò rỉ vào trang của khách truy cập. Thay vào đó, hãy theo dõi mức sử dụng của bạn trong [bảng điều khiển nhà phát triển](/user/developer/api). (Các headerX-Quota-*` mà bạn có thể đã thấy chỉ có trên Data API.)

Vượt quá giới hạn

Khi một widget vượt hạn ngạch, nó trả về 429. Trong một iframe trình duyệt, đó là một trang nhỏ được tạo kiểu "đã đạt giới hạn sử dụng" (để bố cục của bạn không bị vỡ); một trình gọi JSON nhận được {"message", "limit", "used"}. Hãy thêm key, hoặc nâng cấp gói của bạn, để có thêm.

Gói

Các gói embed tách biệt với gói Data API của bạn. Mọi tài khoản đều bắt đầu ở gói Free; những khách truy cập không có key nhận được bậc ẩn danh.

Gói	Lượt tải / tháng	Tên miền	Key
Free	10,000	1	2
Starter	50,000	3	5
Pro	500,000	10	10
Ẩn danh	1,000 theo IP	—	—

Ẩn danh là bậc không có key — không có tên miền hoặc key, giới hạn theo IP khách truy cập. Nâng cấp trong bảng điều khiển nhà phát triển.

Widget

Chín widget cắm-là-chạy. Sao chép một đoạn mã, thay key của bạn vào, đăng ký tên miền của bạn — xong. Các phân đoạn đường dẫn (như slug của một coin) được phân giải theo slug của tài sản và phải là một thị trường đang hoạt động; mỗi widget cũng chấp nhận các tham số truy vấn dùng chung bên dưới.

GET

Công cụ chuyển đổi tiền tệ

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

Chuyển đổi một số tiền giữa hai tài sản crypto hoặc fiat bất kỳ theo tỷ giá thị trường trực tiếp, kèm bảng so sánh tùy chọn.

Đoạn mã nhúng Mở ví dụ

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

Tham số	Vị trí	Mặc định
fromTài sản cần chuyển đổi từ, theo slug (một thị trường đang hoạt động).	đường dẫn	—
toTài sản cần chuyển đổi sang, theo slug (một thị trường đang hoạt động).	đường dẫn	—
hideTableẨn bảng so sánh và chỉ hiển thị công cụ chuyển đổi.	truy vấn	false
compactHiển thị bố cục thu gọn với khoảng cách chặt hơn — phù hợp cho các cột hẹp.	truy vấn	false

Xem trước trực tiếp

GET

Biểu đồ lịch sử giá

/{locale}/embed/zoom/bitcoin

Toàn bộ giá lịch sử của một coin dưới dạng biểu đồ tương tác, kèm bộ chọn các thị trường hàng đầu theo marketcap.

Đoạn mã nhúng Mở ví dụ

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

Tham số	Vị trí	Mặc định
slugCoin hoặc token cần vẽ biểu đồ, theo slug (một thị trường đang hoạt động).	đường dẫn	—
compactHiển thị bố cục thu gọn với khoảng cách chặt hơn — phù hợp cho các cột hẹp.	truy vấn	false

Xem trước trực tiếp

GET

Công cụ hoán đổi marketcap

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

Sự kiện "flippening" — giá của một tài sản sẽ là bao nhiêu nếu ở marketcap của một tài sản khác, kèm hệ số nhân ngụ ý.

Đoạn mã nhúng Mở ví dụ

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

Tham số	Vị trí	Mặc định
entity1Tài sản có giá được chiếu lại, theo slug (một thị trường đang hoạt động).	đường dẫn	—
entity2Tài sản có marketcap được áp dụng, theo slug (một thị trường đang hoạt động).	đường dẫn	—
compactHiển thị bố cục thu gọn với khoảng cách chặt hơn — phù hợp cho các cột hẹp.	truy vấn	false

Xem trước trực tiếp

GET

Trình mô phỏng DCA

/{locale}/embed/dca

Các lần mua định kỳ hàng tuần một coin trong 5 năm qua sẽ tích lũy và sinh lời được bao nhiêu.

Đoạn mã nhúng Mở ví dụ

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

Tham số	Vị trí	Mặc định
compactHiển thị bố cục thu gọn với khoảng cách chặt hơn — phù hợp cho các cột hẹp.	truy vấn	false

Xem trước trực tiếp

GET

Công cụ tính lợi nhuận

/{locale}/embed/profit

Lợi nhuận ròng, khoản lỗ và ROI từ giá mua, giá bán, số lượng và phí.

Đoạn mã nhúng Mở ví dụ

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

Tham số	Vị trí	Mặc định
compactHiển thị bố cục thu gọn với khoảng cách chặt hơn — phù hợp cho các cột hẹp.	truy vấn	false

Xem trước trực tiếp

GET

Công cụ tính lãi suất

/{locale}/embed/interest

Dự phóng giá trị tương lai của một khoản nắm giữ từ tiền gốc ban đầu, lãi suất và tần suất ghép lãi.

Đoạn mã nhúng Mở ví dụ

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

Tham số	Vị trí	Mặc định
compactHiển thị bố cục thu gọn với khoảng cách chặt hơn — phù hợp cho các cột hẹp.	truy vấn	false

Xem trước trực tiếp

GET

Công cụ tính thuế

/{locale}/embed/tax

Ước tính số tiền chịu thuế và thuế phải nộp trên các khoản lãi giao dịch, đào coin, staking, airdrop và lợi suất.

Đoạn mã nhúng Mở ví dụ

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

Tham số	Vị trí	Mặc định
compactHiển thị bố cục thu gọn với khoảng cách chặt hơn — phù hợp cho các cột hẹp.	truy vấn	false

Xem trước trực tiếp

GET

Công cụ tính khoản vay

/{locale}/embed/loan

Mô hình hóa một khoản vay crypto — khoản trả nợ, tổng lãi và phân tích lịch khấu hao.

Đoạn mã nhúng Mở ví dụ

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

Tham số	Vị trí	Mặc định
compactHiển thị bố cục thu gọn với khoảng cách chặt hơn — phù hợp cho các cột hẹp.	truy vấn	false

Xem trước trực tiếp

GET

Công cụ tính staking

/{locale}/embed/staking

Ước tính phần thưởng staking từ số tiền đã stake, APR/APY và thời hạn.

Đoạn mã nhúng Mở ví dụ

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

Tham số	Vị trí	Mặc định
compactHiển thị bố cục thu gọn với khoảng cách chặt hơn — phù hợp cho các cột hẹp.	truy vấn	false

Xem trước trực tiếp