Open Source

Bitcoin widgets for any website

Drop-in price ticker and converter. Zero dependencies, zero backend. One script tag.

<21kb Minified
~6kb Gzipped
0 Dependencies
3 Price Sources

Price Ticker

Real-time BTC price from Binance, Coinbase, and Kraken. Click a currency to switch.

Currencies
Dark theme

Converter

Convert between BTC, sats, and fiat. Prices update automatically without interrupting your input.

BTC to Naira
Sats to Cedis
BTC to Shillings — dark
BTC to Rand

Get Started

<!-- Add the script -->
<script src="https://cdn.jsdelivr.net/npm/alke-puldist/alke-pulse.min.js"></script>

<!-- Use the widgets -->
<alke-btc-price currencies="USD,NGN,GHS,KES,ZAR" show-sats></alke-btc-price>
<alke-btc-converter show-sats></alke-btc-converter>
# Install
npm install alke-pulse

# Import (auto-registers both components)
import 'alke-pulse';
<!-- No custom elements needed — just classes + data attributes -->
<script src="https://cdn.jsdelivr.net/npm/alke-puldist/alke-pulse.min.js"></script>

<div class="btc-ticker"
     data-currencies="USD,NGN,GHS"
     data-show-sats></div>

<div class="alke-converter"
     data-default-from="NGN"
     data-default-to="BTC"></div>

Configuration

Customize via HTML attributes. All optional.

<alke-btc-price>

AttributeDefault
currencyUSD
currenciesUSD,EUR,GBP
show-satsfalse
themelight
refresh-interval60000

<alke-btc-converter>

AttributeDefault
default-fromBTC
default-toUSD
currenciesUSD,EUR,GBP
show-satsfalse
themelight
refresh-interval60000

How It Works

⚖

Median Pricing

Aggregates BTC/USD from Binance, Coinbase, and Kraken. Takes the median to filter outliers.

⚡

Shared Engine

Multiple widgets on one page share a single polling loop. One set of API calls, no matter how many widgets.

🔒

Shadow DOM

Styles are fully isolated. Won't break your site, your site won't break the widgets.

🌍

150+ Currencies

Any ISO 4217 code works. NGN, GHS, KES, ZAR, UGX, TZS, EUR — just pass the code.

💤

Battery Friendly

Pauses polling when the tab is hidden. Resumes instantly when you switch back.

🛠

Themeable

Light and dark themes built in. Override any CSS variable for custom branding.

Currencies

Use any valid ISO 4217 currency code. If the forex API has a rate for it, it works. Defaults shown below, but you can use UGX, TZS, RWF, ETB, XOF, EGP, MAD, JPY — any of the 150+ currencies the API supports.

₦ Nigerian Naira (NGN)

Official CBN rate. Parallel market rates may differ.

₵ Ghanaian Cedi (GHS)

Bank of Ghana reference rate.

KSh Kenyan Shilling (KES)

Central Bank of Kenya rate.

R South African Rand (ZAR)

South African Reserve Bank rate.

$ US Dollar (USD)

Base currency for all conversions.

Any ISO 4217 Code

EUR, GBP, UGX, TZS, RWF, ETB, XOF, XAF, EGP, MAD, JPY, INR, BRL — just pass the code.