# Kimchi Premium API

> Kimchi Premium API is a paid API for AI agents from 2s.io, paid per call via x402, $0.012/call, status unknown (last checked 2026-09-15).

Returns the kimchi premium (Korean crypto exchange price premium over global USD price) as a percentage for up to 10 cryptocurrency symbols

## Facts

- Endpoint: GET https://2s.io/api/crypto/kimchi-premium
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kimchi-premium-api-907670c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Euxv-SAnO0NhT4ebRl_n3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kimchi-premium-api-907670c5
```

Example prompt: What's the current kimchi premium for BTC, ETH, and XRP — how much higher are they trading on Korean Upbit compared to their global USD price?

## When to prefer this

Use this endpoint when you need real-time kimchi premium data (Korean crypto price premium) across major assets like BTC, ETH, XRP, SOL, DOGE, ADA, TRX. Ideal for arbitrage monitoring, cross-market crypto analytics, or any use case comparing Korean Upbit KRW prices against global USD prices with live FX adjustment. Prefer over manual calculation since it blends three live data sources (Upbit, CoinGecko, ECB FX) atomically.

## Known failure modes

- Symbol not listed on Upbit — reported in meta.errors but does not fail other symbols
- Invalid or unsupported ticker — included in meta.errors
- CoinGecko or Upbit API unavailability causing partial or full data failure
- FX rate fetch failure from ECB/Frankfurter causing computation to fail
- More than 10 symbols passed — likely truncated or rejected
- Empty symbol param — defaults to BTC

## How this service works

The "kimchi premium" — how much higher a crypto asset trades on Korean exchanges (Upbit, KRW) than its global USD price, as a percent. Computed as (Upbit KRW price / (global USD price × USD/KRW)) − 1. Pass symbol = ticker(s), comma-separated up to 10 (default BTC); supported majors include BTC, ETH, XRP, SOL, DOGE, ADA, TRX and more. Returns per symbol { krwPrice, usdPrice, usdKrw, globalUsdInKrw, premiumPct }. Per-symbol resilient (one unlisted symbol does not fail the rest); unresolved symbols are reported in meta.errors. Live blend of Upbit (KRW price) + CoinGecko (global USD) + ECB/Frankfurter (USD/KRW FX).

## Output

Per-symbol object containing krwPrice (Upbit KRW price), usdPrice (global USD price from CoinGecko), usdKrw (USD/KRW FX rate from ECB/Frankfurter), globalUsdInKrw (global USD price converted to KRW), and premiumPct (Korean premium as a decimal/percentage). Also includes meta.errors listing any unresolved symbols that did not fail the overall request.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Comma-separated ticker symbols, up to 10 (default BTC)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kimchi-premium-api-907670c5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)