kimchi-premium for BTC

Real-time Bitcoin Kimchi Premium calculator. Compares Bitcoin prices between a Korean exchange (Upbit, KRW) and a global exchange (Binance, USD) to calculate...

Security Scan

The skill's code and instructions match its stated purpose (fetch three public APIs and compute a price difference) and request no unrelated secrets or installs.

Purpose & Capability

Name/description, SKILL.md, and index.mjs consistently fetch USD/KRW rates, Upbit KRW BTC price, and Binance USD BTC price to compute the Kimchi Premium. No unrelated services, binaries, or credentials are requested.

Instruction Scope

Runtime instructions and the code only perform the described network calls and calculation. They do not read files, environment variables, or contact endpoints outside the three declared APIs (open.er-api.com, api.upbit.com, api.binance.com). Error handling and timeouts are present.

Install Mechanism

No install spec (instruction-only) which is low risk. Minor inconsistency: the package declares no required binaries, but the usage and code assume a Node.js runtime (node index.mjs). This is an omission in the metadata rather than a functional concern.

Credentials

No environment variables or credentials are required and none are accessed by the code. Network access is limited to the three public APIs needed for the calculation.

Persistence & Privilege

Skill is not always-on, does not request persistent privileges, and does not modify other skill/system configs. Autonomous invocation is allowed (platform default) but not combined with other risky flags.

Assessment

This skill is small, self-contained, and does what it claims: it makes three public API requests and prints a JSON result. Before installing, be aware that it requires a Node.js runtime to run (metadata omitted that requirement) and will make outbound requests to open.er-api.com, api.upbit.com, and api.binance.com. No secrets are requested or used. If you plan to run it locally or in an agent, verify you trust those endpoints and your environment's network policies. If you need stronger guarantees, inspect the included index.mjs yourself or run it in an isolated environment.

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

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