--- name: api.printmoneylab.com description: api.printmoneylab.com provides real-time Korean crypto market data, Kimchi premium analytics, Korean exchange monitoring, and Korean-language news intelligence (semiconductor and K-pop) with English translations and AI-generated summaries. It focuses exclusively on the Korean market — KRW-denominated prices, Upbit/Bithumb exchange data, and Korea-specific news signals. All endpoints return single-shot snapshots; none support streaming or historical time-series queries. host: api.printmoneylab.com --- # api.printmoneylab.com PrintMoneyLab is a data host specializing in Korean financial and entertainment market intelligence. It serves agents that need KRW crypto pricing, Kimchi premium calculations, Korean exchange risk alerts, stablecoin capital-flow signals, and AI-synthesized Korean news (semiconductor industry and K-pop). Its distinguishing characteristic is the combination of Korean-language source ingestion, English translation, and AI-structured market interpretation in a single API call per endpoint. It does not serve global crypto markets, non-Korean exchanges, or historical data needs. ## When to use this host Use this host when an agent needs KRW-denominated crypto pricing, Kimchi premium calculations, Korean exchange risk monitoring, stablecoin capital-flow signals, or AI-translated Korean news in the semiconductor or K-pop domains. It is the correct choice for any Korea-specific crypto arbitrage or sentiment workflow. Do not use this host for: global (non-Korean) crypto prices or exchange data — use a general crypto price API (e.g., CoinGecko, Binance public API) instead; historical price or premium time-series data — this host returns only real-time snapshots; non-Korean regional arbitrage (e.g., US vs EU price gaps); order book depth or trade execution; Korean news topics outside semiconductor industry and K-pop; or any streaming or webhook-based data delivery. ## Capabilities ### Korean Crypto Pricing Provides live KRW-denominated cryptocurrency prices from Upbit and Bithumb, plus the current USD/KRW FX rate needed to contextualize those prices. - **`fetch-korean-crypto-prices`** — Returns live cryptocurrency prices in KRW from Upbit and Bithumb, including price, 24h volume, change rate, and timestamps per exchange. - **`fetch-usd-krw-fx-rate`** — Returns the current USD to KRW exchange rate as JSON, including the numeric rate, data source, Unix timestamp, and data freshness in seconds. ### Kimchi Premium & Arbitrage Measures the price gap between Korean exchanges (Upbit, Bithumb) and global exchanges (Binance), returning premium percentages, FX context, and per-token spread data across the full KRW-listed universe. - **`fetch-kimchi-premium`** — Returns real-time kimchi premium data for a crypto symbol, including Upbit KRW price, Binance USDT price, FX rates, KRW equivalent, and premium percentage. - **`fetch-global-vs-korea-divergence`** — Returns real-time price divergence for a cryptocurrency between global markets and the Korean market, including premium percentage, FX rate, source attribution, and a short AI interpretation. - **`fetch-btc-korea-divergence-deep`** — Returns BTC (or other crypto) price divergence between global and Korean markets, including premium percentage, Korean news sentiment, and AI-generated market interpretation. - **`fetch-arbitrage-scanner`** — Returns live per-token Kimchi Premium, reverse premium, Upbit-Bithumb gap, market share, and Upbit caution flags for KRW-listed crypto assets across Upbit, Binance, and Bithumb. ### Korean Stablecoin & Capital Flow Signals Tracks whether USDT and USDC are trading at a premium or discount on Korean exchanges relative to the official FX rate, surfacing directional capital-flow signals for the Korean crypto market. - **`fetch-korean-stablecoin-premium`** — Returns current Korean stablecoin premium data for USDT and USDC, including KRW prices, premium percentages, 24h trading volume, and the reference USD/KRW FX rate. ### Korean Exchange Monitoring Monitors Korean crypto exchanges for abnormal activity including volume spikes, deposit surges, investment warnings, price discrepancies, listing changes, and caution-flagged tokens. - **`fetch-market-movers`** — Returns real-time token market mover data including volume spikes, top-volume rankings, and 24-hour price change rates, denominated in KRW. - **`fetch-exchange-alerts`** — Returns current caution tokens with risk flags (volume surge, deposit surge, investment warning, price difference) and listing changes from a Korean crypto exchange monitor. ### Korean Crypto Sentiment Aggregates exchange signals, Kimchi premium dynamics, and Korean news into a single AI-labeled sentiment score and narrative report for the Korean crypto market. - **`fetch-korean-crypto-sentiment`** — Returns AI-generated Korean crypto market sentiment combining real-time Upbit/Bithumb exchange signals, kimchi premium data, and Korean news analysis into a labeled sentiment score and report. ### Korean News Intelligence Fetches recent Korean-language news articles in the semiconductor and K-pop domains, providing English translations, per-article summaries, sentiment analysis, key themes, and AI-generated market signals. - **`fetch-kr-semiconductor-news`** — Fetches South Korean semiconductor industry news from Naver, translated to English, covering Samsung, SK Hynix, HBM, and related topics, for $0.02 per call. - **`fetch-kr-semiconductor-news-summary`** — Fetches recent Korean semiconductor news articles with English translations, summaries, and AI-generated market analysis including sentiment, key themes, and a market signal. - **`fetch-kpop-korea-news`** — Fetches up to 10 recent Korean K-pop and idol entertainment news articles from Naver, translated to English with AI relevance classification, for $0.01 per call. - **`fetch-kpop-news-summary`** — Fetches and AI-synthesizes recent Korean K-pop news articles, returning per-article English summaries, sentiment analysis, key themes, and trending entities. ## Workflows ### Full Kimchi Premium Assessment *Use when an agent needs to assess the Kimchi premium for a specific token with full FX context and a broader market-wide view of all KRW-listed assets.* 1. **`fetch-usd-krw-fx-rate`** — Retrieve the current USD/KRW FX rate to establish the baseline for premium calculations. 2. **`fetch-kimchi-premium`** — Fetch the real-time Kimchi premium for the target token, using Upbit vs Binance prices and the FX context. 3. **`fetch-arbitrage-scanner`** — Pull the full market-wide arbitrage scan to compare the target token's premium against the broader KRW-listed universe. ### Korean Crypto Market Situation Report *Use when an agent needs a comprehensive snapshot of current Korean crypto market conditions including sentiment, capital flows, exchange risk flags, and momentum.* 1. **`fetch-korean-stablecoin-premium`** — Check USDT/USDC premium direction to assess whether capital is flowing into or out of the Korean crypto market. 2. **`fetch-exchange-alerts`** — Identify tokens currently flagged for abnormal activity, deposit surges, or investment warnings on Korean exchanges. 3. **`fetch-market-movers`** — Surface tokens with unusual volume spikes or significant 24h price changes in KRW markets. 4. **`fetch-korean-crypto-sentiment`** — Synthesize all signals into an AI-labeled sentiment score and narrative report covering Korean market conditions. ### Deep Korea Divergence with News Context *Use when an agent needs to understand why a specific crypto asset is showing a Kimchi premium or discount, incorporating Korean semiconductor or macro news signals.* 1. **`fetch-btc-korea-divergence-deep`** — Retrieve deep divergence analysis for the target asset including Korean news sentiment and AI interpretation of local vs global dynamics. 2. **`fetch-kr-semiconductor-news-summary`** — Fetch Korean semiconductor news with AI market signal to provide macro industry context that may explain Korean retail demand patterns. ### K-Pop Market Intelligence Digest *Use when an agent needs a layered view of current K-pop news, combining raw translated articles with AI-synthesized themes and trending entities.* 1. **`fetch-kpop-korea-news`** — Fetch raw recent K-pop news headlines with English translations and source links. 2. **`fetch-kpop-news-summary`** — Retrieve AI-synthesized summaries, sentiment analysis, and trending artist/entity extraction across the same recent articles. ## Skill reference ### `fetch-kr-semiconductor-news-summary` **Korean Semiconductor News Summary** — Fetches recent Korean semiconductor news articles with English translations, summaries, and AI-generated market analysis including sentiment, key themes, and a market signal. *Use when:* Use when an agent needs a current snapshot of Korean semiconductor industry news with English-translated titles and summaries, plus AI-synthesized sentiment and market signal (bullish/bearish) for investment or research context. *Not for:* Do not use for real-time price feeds or stock quotes; this returns news article summaries and AI analysis, not market data. Not suitable for non-semiconductor Korean news topics. **Inputs:** - `limit` (integer) — Number of Korean semiconductor news articles to analyze and return, between 1 and 10 inclusive. Defaults to 5. **Returns:** Returns ok=true with up to 10 Korean semiconductor news articles (English-translated titles and summaries), plus an ai_analysis object with overall_sentiment, key_themes, trending_entities, and a market_signal string. **Example:** `GET https://api.printmoneylab.com/api/v1/kr-news/semiconductor-summary?limit=5` --- ### `fetch-kpop-news-summary` **K-Pop News Summary** — Fetches and AI-synthesizes recent Korean K-pop news articles, returning per-article English summaries, sentiment analysis, key themes, and trending entities. *Use when:* Use when an agent needs a current snapshot of K-pop industry news including article summaries in English, overall sentiment, trending artists, and key themes derived from Korean-language sources. *Not for:* Do not use for general Korean news outside K-pop, real-time streaming updates, or historical archive queries beyond the most recent articles; use a broader Korean news API for non-K-pop topics. **Inputs:** - `limit` (integer) — Number of K-pop articles to fetch and analyze, between 1 and 10 inclusive. Defaults to 5. **Returns:** Returns ok=true with up to 10 article objects (Korean/English titles, English summaries, source, timestamp, link) plus an ai_analysis block with overall_sentiment, key_themes, trending_entities, and a narrative English summary. **Example:** `GET https://api.printmoneylab.com/api/v1/kr-news/kpop-summary?limit=5` --- ### `fetch-kr-semiconductor-news` **KR Semiconductor News** — Fetches South Korean semiconductor industry news from Naver, translated to English, covering Samsung, SK Hynix, HBM, and related topics, for $0.02 per call. *Use when:* Use when an agent needs recent South Korean semiconductor industry news in English, including coverage of Samsung Electronics, SK Hynix, HBM memory, and Korean chip policy or market developments. *Not for:* Do not use for global semiconductor news outside Korea, real-time price feeds, or financial data; use a general news or market data API instead. **Inputs:** - `limit` (integer) — Number of articles to return, between 1 and 10 inclusive. Defaults to 5. **Returns:** Returns ok=true with an array of up to 10 Korean semiconductor news articles, each with Korean and English titles, an English summary, source, publication timestamp, and article link, plus a payment receipt. **Example:** `GET https://api.printmoneylab.com/api/v1/kr-news/semiconductor?limit=5` --- ### `fetch-kpop-korea-news` **K-Pop Korea News** — Fetches up to 10 recent Korean K-pop and idol entertainment news articles from Naver, translated to English with AI relevance classification, for $0.01 per call. *Use when:* Use when an agent needs current Korean K-pop or idol entertainment news headlines with English translations, source links, and publication timestamps — for example, to monitor idol activity, brand rankings, or music releases. *Not for:* Do not use for general Korean news outside K-pop/idol entertainment; use a broader Korean news endpoint instead. Not suitable for real-time streaming or high-frequency polling. **Inputs:** - `limit` (integer) — Number of articles to return, between 1 and 10 inclusive. Defaults to 5. **Returns:** Returns ok=true, a results array of up to 10 K-pop news articles each with Korean/English titles, English summary, source, published_at timestamp, and article link, plus a payment receipt. **Example:** `GET https://api.printmoneylab.com/api/v1/kr-news/kpop?limit=5` --- ### `fetch-global-vs-korea-divergence` **Global vs Korea Crypto Divergence** — Returns real-time price divergence for a cryptocurrency between global markets and the Korean market, including premium percentage, FX rate, source attribution, and a short AI interpretation. *Use when:* Use when an agent needs to compare a cryptocurrency's global USD price against its Korean KRW price on Upbit, calculate the Kimchi premium or discount, or surface a brief AI summary of regional demand divergence. *Not for:* Do not use for streaming price feeds or historical divergence data; this is a single-shot light-tier snapshot. Not suitable for deep order-book or volume analysis. **Inputs:** - `symbol` (string) — Crypto symbol to query (e.g., BTC, ETH, XRP). Defaults to BTC. **Returns:** Returns global USD price, Korean KRW price, FX rate with sources, divergence premium percentage and direction, context signals (investment warning, volume spike), and a 1-2 sentence AI interpretation. **Example:** `GET https://api.printmoneylab.com/api/v1/global-vs-korea-divergence?symbol=BTC` --- ### `fetch-btc-korea-divergence-deep` **Bitcoin Korea Divergence Analysis (Deep)** — Returns BTC (or other crypto) price divergence between global and Korean markets, including premium percentage, Korean news sentiment, and AI-generated market interpretation. *Use when:* Use when an agent needs to assess the Kimchi premium or discount for a crypto asset, including Korean news signals and AI-structured analysis of local vs. global market dynamics. *Not for:* Do not use for real-time streaming price feeds or non-Korean regional arbitrage analysis; use a standard exchange price API for those cases. **Inputs:** - `symbol` (string) — Crypto symbol to analyze (e.g., BTC, ETH, XRP). Defaults to BTC. **Returns:** Returns BTC global vs. Korean price divergence (premium_pct, direction, magnitude), Korean news sentiment (score, keywords, count), and an AI analysis object with summary, market drivers, and implied action suggestion. **Example:** `GET https://api.printmoneylab.com/api/v1/global-vs-korea-divergence-deep?symbol=BTC` --- ### `fetch-usd-krw-fx-rate` **USD/KRW FX Rate** — Returns the current USD to KRW exchange rate as JSON, including the numeric rate, data source, Unix timestamp, and data freshness in seconds. *Use when:* Use when an agent needs the current USD to KRW foreign exchange rate, such as for currency conversion calculations, financial reporting, or displaying live FX data to a user. *Not for:* Do not use for historical FX rates or other currency pairs; this endpoint returns only the current USD/KRW rate. **Returns:** Returns a JSON object with base=USD, quote=KRW, a numeric rate (e.g. 1469.39), the data source name, a millisecond Unix timestamp, and data age in seconds. **Example:** `GET https://api.printmoneylab.com/api/v1/fx-rate` --- ### `fetch-korean-crypto-prices` **Korean BTC Price API** — Returns live cryptocurrency prices in KRW from Upbit and Bithumb, including price, 24h volume, change rate, and timestamps per exchange. *Use when:* Use when an agent needs current Korean exchange prices for a cryptocurrency in KRW, such as to calculate kimchi premium, compare Korean vs global prices, or monitor KRW-denominated market data. *Not for:* Do not use for global USD-denominated price feeds or non-Korean exchanges; use a general crypto price API instead. Not suitable for historical price data. **Inputs:** - `symbol` (string) — Crypto symbol to query. Defaults to BTC. - `exchange` (string) — Exchange to query: upbit, bithumb, or all. Defaults to all. **Returns:** Returns a JSON object with per-exchange KRW price, 24h volume, change rate, and millisecond timestamps for Upbit and Bithumb, plus a top-level response timestamp. **Example:** `GET https://api.printmoneylab.com/api/v1/kr-prices?symbol=BTC&exchange=all` --- ### `fetch-arbitrage-scanner` **PrintMoneyLab Arbitrage Scanner** — Returns live per-token Kimchi Premium, reverse premium, Upbit-Bithumb gap, market share, and Upbit caution flags for KRW-listed crypto assets across Upbit, Binance, and Bithumb. *Use when:* Use when an agent needs real-time KRW market spread data, Kimchi Premium percentages, or exchange pricing discrepancies for individual tokens listed on Upbit, Binance, or Bithumb. *Not for:* Do not use for non-KRW exchange arbitrage, cross-chain bridge quotes, or historical price data; this endpoint returns live KRW market data only. **Returns:** Returns a premiums array where each element contains a token's Upbit KRW price, Binance USD price, KRW-converted global price, Kimchi Premium percentage, Upbit warning/caution flags, and 24h Upbit volume in KRW. **Example:** `GET https://api.printmoneylab.com/api/v1/arbitrage-scanner` --- ### `fetch-korean-stablecoin-premium` **Korean Stablecoin Premium** — Returns current Korean stablecoin premium data for USDT and USDC, including KRW prices, premium percentages, 24h trading volume, and the reference USD/KRW FX rate. *Use when:* Use when an agent needs to assess capital flow direction in the Korean crypto market by checking whether USDT or USDC is trading at a premium or discount relative to the official USD/KRW exchange rate. *Not for:* Do not use for real-time streaming price feeds or for stablecoins other than USDT and USDC; not suitable for non-Korean exchange premium data. **Returns:** Returns official USD/KRW FX rate, USDT and USDC KRW prices, premium percentages and directions, 24h volumes, capital flow interpretations, and a millisecond timestamp. **Example:** `GET https://api.printmoneylab.com/api/v1/stablecoin-premium` --- ### `fetch-market-movers` **Market Movers API** — Returns real-time token market mover data including volume spikes, top-volume rankings, and 24-hour price change rates, denominated in KRW. *Use when:* Use when an agent needs to identify tokens with unusual volume activity or significant price changes in the last 24 hours, such as for screening trading opportunities or monitoring market momentum. *Not for:* Do not use for historical market data or continuous streaming price feeds; this is a single-shot snapshot updated on a 60-second interval. **Returns:** Returns volume_spikes and top_volume arrays of token objects with symbol, KRW volume, and 24h change rate, plus a last_update timestamp, meta pricing info, and a USDC payment receipt. **Example:** `GET https://api.printmoneylab.com/api/v1/market-movers` --- ### `fetch-korean-crypto-sentiment` **Korean Crypto Sentiment** — Returns AI-generated Korean crypto market sentiment combining real-time Upbit/Bithumb exchange signals, kimchi premium data, and Korean news analysis into a labeled sentiment score and report. *Use when:* Use when an agent needs to assess current Korean crypto market conditions, including retail FOMO signals, kimchi premium dynamics, regulatory risk context, or Korea-specific token deposit/volume surges. *Not for:* Do not use for global crypto sentiment or non-Korean market analysis; use a broader market sentiment API instead. Not suitable for real-time price feeds or trade execution signals. **Returns:** Returns a sentiment label (e.g. CAUTIOUS_FOMO), numeric score, English narrative report, exchange signals with kimchi premium stats and token lists, Korean news articles, and data source metadata. **Example:** `GET https://api.printmoneylab.com/api/v1/kr-sentiment` --- ### `fetch-exchange-alerts` **Exchange Alerts API** — Returns current caution tokens with risk flags (volume surge, deposit surge, investment warning, price difference) and listing changes from a Korean crypto exchange monitor. *Use when:* Use when an agent needs to check which tokens are currently flagged for abnormal trading activity, deposit surges, investment warnings, or global price discrepancies on a Korean crypto exchange, or to detect recent listing changes. *Not for:* Do not use for real-time streaming price feeds or order book data; this endpoint is a single-shot snapshot updated every 60 seconds and does not provide price quotes or trade execution. **Returns:** Returns listing_changes array, caution_tokens array with symbol/korean_name/flags per token, a last_update Unix timestamp, meta with price and update_interval, and a payment receipt object. **Example:** `GET https://api.printmoneylab.com/api/v1/exchange-alerts` --- ### `fetch-kimchi-premium` **Kimchi Premium** — Returns real-time kimchi premium data for a crypto symbol, including Upbit KRW price, Binance USDT price, FX rates, KRW equivalent, and premium percentage. *Use when:* Use when an agent needs to measure the price gap between Korean crypto exchanges (Upbit) and global exchanges (Binance) for a given token, expressed as a premium percentage with FX context. *Not for:* Do not use for historical kimchi premium data or time-series analysis; this endpoint returns a single real-time snapshot only. **Inputs:** - `symbol` (string) — Crypto symbol to query (e.g., BTC, ETH, XRP). Defaults to BTC. **Returns:** Returns a JSON object with Upbit KRW price, Binance USDT price, FX rates, KRW-equivalent Binance price, premium percentage (two variants), premium direction, and a millisecond timestamp. **Example:** `GET https://api.printmoneylab.com/api/v1/kimchi-premium?symbol=BTC` ---