# Kimchi Premium

> Real-time Bitcoin Kimchi Premium calculator. Compares Bitcoin prices between a Korean exchange (Upbit, KRW) and a global exchange (Binance, USD) to calculate the premium percentage and price difference in KRW. Reflects live USD/KRW exchange rates and uses only Node.js built-in modules with zero dependencies.

- Skill: `knownasnaffy/kimchi-premium-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add knownasnaffy/kimchi-premium-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knownasnaffy/kimchi-premium-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: knownasnaffy (https://skillmd.com/u/knownasnaffy)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/knownasnaffy/kimchi-premium-2

---





### Cleanup Review

`python scripts/_cleanup.py` is an optional cleanup helper for the `Kimchi Premium 🌶️` skill. It may recursively remove /tmp/_skill_run/*, /tmp/_skill_run/.cache. Show the exact paths first, explain whether they are skill-private temporary paths or user state, and run the cleanup only after the user confirms.

# 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

1. **Fetches live exchange rate** — Retrieves the current USD/KRW rate from ExchangeRate-API
2. **Fetches Upbit BTC price** — Gets the latest Bitcoin price in KRW from the Upbit API
3. **Fetches Binance BTC price** — Gets the latest Bitcoin price in USD from the Binance API
4. **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

```json
{
  "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

```bash
node index.mjs
```

## Technical Highlights

- Zero external dependencies — uses only the Node.js built-in `https` module
- Parallel API calls via `Promise.all` for fast response times
- 5-second timeout for reliable error handling
- Structured JSON output for easy parsing