K-Data — Korean Sell-Side Research & Market Data

Kimchi premium on two bases: premium_official_pct (official USD/KRW rate — the quoted figure) and premium_usdt_pct (Upbit KRW/USDT rate — the margin actually realizable, since the KRW exit leg goes through USDT rather than banks). The two frequently disagree in sign. Optional ?symbols=BTC,ETH (max 10). Costs $0.03 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "string",
      "description": "Comma-separated coin tickers, e.g. BTC,ETH,XRP. Default: BTC,ETH,XRP,SOL,DOGE"
    }
  },
  "additionalProperties": false
}

Where the current kimchi premium sits inside its own recent distribution: percentile, mean, stdev, z-score, min/max/median, and a plain-language read. Answers 'is this premium unusual right now?' in one call. Built from a continuous archive that cannot be reconstructed from any free source. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &basis=usdt|official. Costs $0.12 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Archived tickers: BTC, ETH, XRP, SOL, DOGE, USDT"
    },
    "window": {
      "type": "string",
      "enum": [
        "1h",
        "6h",
        "24h",
        "7d",
        "30d",
        "90d"
      ],
      "description": "Lookback window (default 24h)"
    },
    "basis": {
      "type": "string",
      "enum": [
        "usdt",
        "official"
      ],
      "description": "Which premium basis to analyse (default usdt)"
    }
  },
  "additionalProperties": false
}

Time series of the kimchi premium from the continuous archive, both bases, newest-last. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &points=500 (max 2000). Archive depth is reported as first_recorded. Costs $0.08 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Archived tickers: BTC, ETH, XRP, SOL, DOGE, USDT"
    },
    "window": {
      "type": "string",
      "enum": [
        "1h",
        "6h",
        "24h",
        "7d",
        "30d",
        "90d"
      ],
      "description": "Lookback window (default 24h)"
    },
    "points": {
      "type": "integer",
      "description": "Max points returned (default 500, max 2000)"
    }
  },
  "additionalProperties": false
}

Analyst consensus for one KRX ticker, built from the archived research history: mean/median/min/max target price across brokerages, the spread between them, the rating distribution, and a revision log of every target-price and rating change each house has made. Consensus uses each house's latest view, so a weekly publisher does not outvote a quarterly one. Params: ?window=30d|90d|180d|365d (default 90d). Costs $0.12 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "6-digit KRX code, e.g. 005930"
    },
    "window": {
      "type": "string",
      "enum": [
        "30d",
        "90d",
        "180d",
        "365d"
      ],
      "description": "Lookback window (default 90d)"
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

Every archived Korean brokerage report for one KRX ticker, newest first: target price, rating, brokerage, analyst, the Korean title with its English translation, and a one-line English summary. Params: ?limit=20 (max 50). Costs $0.05 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "6-digit KRX code, e.g. 005930"
    },
    "limit": {
      "type": "integer",
      "description": "Max reports (default 20, max 50)"
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

Latest Korean brokerage equity research across all covered companies, newest first — company and KRX ticker, target price, rating, brokerage, analyst, and a one-line English summary of each report. Facts and summaries only; the report PDF stays with its publisher and source_url links back to it. Optional ?limit=20 (max 50). Costs $0.02 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max reports (default 20, max 50)"
    }
  },
  "additionalProperties": false
}

Latest Korean headlines with English translations attached (title_en), from Yonhap, Maeil Business and Hankyung — deduplicated, newest first. Use this instead of the Korean-only route when the consuming agent does not read Korean. Optional ?category=top|economy|tech|politics and ?limit=20 (max 50). Costs $0.05 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "top",
        "economy",
        "tech",
        "politics"
      ],
      "description": "Filter by category"
    },
    "limit": {
      "type": "integer",
      "description": "Max items (default 20, max 50)"
    }
  },
  "additionalProperties": false
}

One-call Korea briefing: dual-basis kimchi premium + top Upbit KRW markets + USD/KRW + latest economy headlines translated to English. Everything needed for a Korea market read in a single paid request. Costs $0.08 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Snapshot of all Upbit KRW crypto markets: top by 24h traded value, top gainers, top losers. Optional ?limit=30 (max 100) for the volume ranking. Costs $0.01 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "How many top-volume markets to return (default 30, max 100)"
    }
  },
  "additionalProperties": false
}

Latest Korean headlines from Yonhap, Maeil Business and Hankyung, deduplicated and newest-first. Titles stay in Korean — use /api/news/headlines/en for English. Optional ?category=top|economy|tech|politics and ?limit=30 (max 100). Costs $0.01 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "top",
        "economy",
        "tech",
        "politics"
      ],
      "description": "Filter by category"
    },
    "limit": {
      "type": "integer",
      "description": "Max items (default 30, max 100)"
    }
  },
  "additionalProperties": false
}

Live quote for one Upbit KRW market by ticker symbol (e.g. BTC, ETH, XRP): price, 24h change, 24h high/low, 24h traded value in KRW. Costs $0.005 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Coin ticker symbol, e.g. BTC"
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

Current USD/KRW exchange rate (ECB reference via Frankfurter, fallback open.er-api.com). Costs $0.005 in USDC per call, settled via x402.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}