knownasnaffy Kimchi Premium 🌶️
A Claude Code skill that calculates the real-time Bitcoin Kimchi Premium.
What is Kimchi Premium?
The Kimchi Premium is a metric that measures how much higher (or lower) Bitcoin prices are on South Korean cryptocurrency exchanges (e.g. Upbit) compared to global exchanges (e.g. Binance). The premium tends to rise when local demand is strong, influenced by investor sentiment and capital flow regulations in South Korea.
What This Skill Does
- Fetches live exchange rate — Retrieves the current USD/KRW rate from ExchangeRate-API
- Fetches Upbit BTC price — Gets the latest Bitcoin price in KRW from the Upbit API
- Fetches Binance BTC price — Gets the latest Bitcoin price in USD from the Binance API
- Calculates the premium — Converts the Binance price to KRW, then compares it with the Upbit price to produce the premium percentage and the absolute price difference in KRW
Example Output
{
"timestamp": "2/1/2026, 2:20:00 PM",
"exchange_rate": "1,380 KRW/USD",
"upbit_btc": "145,000,000 KRW",
"binance_btc": "105,000 USD",
"kimchi_premium": "0.15%",
"price_diff": "217,000 KRW"
}
Usage
node index.mjs
Technical Highlights
- Zero external dependencies — uses only the Node.js built-in
httpsmodule - Parallel API calls via
Promise.allfor fast response times - 5-second timeout for reliable error handling
- Structured JSON output for easy parsing