← Back to Skills Marketplace
seungdols

kimchi-premium for BTC

by seungdols · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
290
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install kimp-price
Description
Real-time Bitcoin Kimchi Premium calculator. Compares Bitcoin prices between a Korean exchange (Upbit, KRW) and a global exchange (Binance, USD) to calculate...
README (SKILL.md)

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
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: kimp-price Version: 1.0.0 The skill is a straightforward utility for calculating the Bitcoin Kimchi Premium. It fetches real-time data from legitimate public APIs (Upbit, Binance, and ExchangeRate-API) using only Node.js built-in modules and contains no evidence of data exfiltration, malicious execution, or prompt injection in index.mjs or SKILL.md.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install kimp-price
  3. After installation, invoke the skill by name or use /kimp-price
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of kimchi-premium skill. - Calculates real-time Kimchi Premium by comparing Bitcoin prices on Upbit (KRW) and Binance (USD). - Fetches BTC prices and exchange rates via open.er-api.com, api.upbit.com, and api.binance.com. - Outputs current premium percentage and price difference.
Metadata
Slug kimp-price
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 290 downloads so far.

How do I install kimchi-premium for BTC?

Run "/install kimp-price" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is kimchi-premium for BTC free?

Yes, kimchi-premium for BTC is completely free (open-source). You can download, install and use it at no cost.

Which platforms does kimchi-premium for BTC support?

kimchi-premium for BTC is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created kimchi-premium for BTC?

It is built and maintained by seungdols (@seungdols); the current version is v1.0.0.

💬 Comments