{
  "markdown": "# KR Crypto Intelligence API\n\nKorean crypto market data + AI analysis for AI agents. 16 paid endpoints (11 crypto + 4 Korean news + 1 KRW macro), 180+ tokens, world's first Korean-to-English crypto sentiment API. Pay-per-use via x402 protocol on Base, Polygon, Solana, and XRPL. AWS Bedrock AgentCore-ready.\n\n## Endpoints (16 paid)\n\n### KRW Macro Signal (new)\n| Endpoint | Price | Description |\n|----------|-------|-------------|\n| `GET /api/v1/krw-macro-stress` | $0.05 | **KRW Macro Stress Score (0-100)** — combined signal from US 3Y treasury (FRED) + VIX + foreign ownership proxy (SK Hynix + Samsung mcap-weighted) + USD/KRW momentum + Korean semiconductor equity. Rolling 120d percentile over 2yr backfill. Returns score + regime (calm/neutral/caution/risk_off/crisis) + direction (krw_weakening/stable/strengthening) + per-component breakdown + AI factual note. 15-min cache. Positioning: KRW macro stress filter for trading bots (not kimchi-premium predictor). |\n\n### Korean News → English (new)\n| Endpoint | Price | Description |\n|----------|-------|-------------|\n| `GET /api/v1/kr-news/kpop` | $0.01 | K-pop news (artists/groups) translated to English |\n| `GET /api/v1/kr-news/kpop-summary` | $0.05 | K-pop news + AI sentiment analysis, key themes, trending artists |\n| `GET /api/v1/kr-news/semiconductor` | $0.02 | Korean semiconductor industry news (Samsung/SK Hynix/HBM) in English |\n| `GET /api/v1/kr-news/semiconductor-summary` | $0.10 | Semiconductor news + AI market signal (bullish/bearish), trending companies |\n\n### Korean Sentiment Analysis (World's First)\n| Endpoint | Price | Description |\n|----------|-------|-------------|\n| `/api/v1/kr-sentiment` | $0.05 | Korean market sentiment in English — combines exchange intelligence (189+ tokens) with Korean news context (Coinness Telegram) for AI-powered insights. 1-hour cache. |\n\n### Global vs Korea Divergence \n| Endpoint | Price | Description |\n|----------|-------|-------------|\n| `/api/v1/global-vs-korea-divergence` | $0.05 | Global vs Korea divergence (light) — CoinGecko global price + Korean exchange + 1-2 sentence AI summary. 60s cache. |\n| `/api/v1/global-vs-korea-divergence-deep` | $0.10 | Deep tier — light data + Korean news signals (Coinness Telegram) + structured AI breakdown (drivers, global context, action suggestion, confidence). 5-min cache. |\n\n### Korean Exchange Intelligence\n| Endpoint | Price | Description |\n|----------|-------|-------------|\n| `/api/v1/arbitrage-scanner` | $0.01 | Token-by-token Kimchi Premium for 180+ tokens, reverse premium, Upbit-Bithumb price gaps, market share |\n| `/api/v1/exchange-alerts` | $0.01 | New listings/delistings detection, investment warnings, caution flags (volume soaring, deposit soaring, etc.) |\n| `/api/v1/market-movers` | $0.01 | 1-min price surges/crashes, volume spikes, top 20 tokens by trading volume |\n\n### AI-Powered Analysis\n| Endpoint | Price | Description |\n|----------|-------|-------------|\n| `/api/v1/market-read` | $0.10 | AI market analysis — 12+ data sources + exchange intelligence + Claude AI token-level signals |\n\n### Market Data\n| Endpoint | Price | Description |\n|----------|-------|-------------|\n| `/api/v1/kimchi-premium` | $0.002 | BTC Kimchi Premium (Upbit vs Binance) — includes both official USD/KRW basis (`premium_pct`) and **USDT real-trade basis (`premium_pct_usdt`)** for true arbitrage edge measurement |\n| `/api/v1/stablecoin-premium` | $0.002 | USDT/USDC premium on Korean exchanges (fund flow indicator) |\n| `/api/v1/kr-prices` | $0.002 | Korean exchange prices (Upbit, Bithumb) |\n| `/api/v1/fx-rate` | $0.001 | USD/KRW exchange rate |\n\n### Free\n| Endpoint | Description |\n|----------|-------------|\n| `/api/v1/symbols` | Available trading symbols |\n| `/api/v1/stats` | Service statistics |\n| `/health` | Service health check |\n| `/llms.txt` | AI agent metadata |\n| `/.well-known/x402` | x402 service discovery |\n\n## Live API\n\n**Base URL:** `https://api.printmoneylab.com`\n**MCP Server:** `https://mcp.printmoneylab.com/mcp`\n**API Docs:** [https://api.printmoneylab.com/docs](https://api.printmoneylab.com/docs)\n\n## Key Features\n\n### Dual-Basis Kimchi Premium (Industry First)\n- Both **official USD/KRW basis** (matches what exchanges display) and **USDT real-trade basis** (what arbitrage bots actually trade) in a single response\n- The 0.3-1% gap between the two is the structural USDT premium itself — measurable, actionable\n- Critical for AI trading agents: the official basis is misleading; only USDT basis reflects true arbitrage margin after capital movement costs\n- No other Kimchi Premium API in the x402 ecosystem provides this dual-basis view\n### KR Sentiment (Unique — No Competitors Worldwide)\n- Real-time Korean market sentiment delivered in English\n- Combines exchange data (189+ tokens Kimchi Premium, warnings, volume spikes, deposit soaring) with Korean news context (Coinness Telegram, 6-hour window)\n- Claude AI generates: sentiment (BULLISH/BEARISH/CAUTIOUS_FOMO/PANIC/GREED/UNCERTAIN), score (-1.0 to +1.0), English report, exchange signals, news context, sources\n- Academic research validates: \"Korean news sentiment predicts global crypto returns\" (2026)\n- 1-hour cache + lazy invocation + concurrency lock for cost efficiency\n\n### Global vs Korea Divergence\n- Light tier: real-time premium between CoinGecko global price and Korean exchange (Upbit), with 1-2 sentence AI interpretation\n- Deep tier: adds Korean news signals (Coinness Telegram, 24h keywords + sentiment score) and structured AI analysis with Korean market drivers, global context, action suggestion, and confidence level\n- 25 supported symbols (BTC, ETH, XRP, SOL, ADA, DOGE, DOT, MATIC, LINK, AVAX, ATOM, UNI, LTC, NEAR, OP, ARB, APT, ALGO, FTM, SUI, TRX, BCH, ETC, HBAR, SHIB)\n\n### Arbitrage Scanner\n- Real-time Kimchi Premium for **every token** traded on both Upbit and Binance (189+)\n- Reverse premium detection (Korean discount = buy signal)\n- Upbit vs Bithumb price gap scanner (domestic arbitrage)\n- Market share tracking (Upbit vs Bithumb volume)\n\n### Exchange Alerts\n- New listing / delisting detection (market list comparison every 60s)\n- Investment warning flags (from Upbit official API)\n- Caution flags: price fluctuations, volume soaring, deposit soaring, global price differences, small account concentration\n\n### Market Movers\n- 1-minute price surge/crash detection (>1% in 60 seconds)\n- Volume spike detection (24h change rate, >1B KRW volume)\n- Top 20 tokens by trading volume\n\n### AI Market Read\n- 12+ data sources combined: Kimchi Premium, stablecoin premium, FX rate, Upbit/Bithumb volume TOP 5, BTC funding rate, open interest, dominance, Fear & Greed, + exchange intelligence (180+ tokens)\n- Claude AI generates: signal (BULLISH/BEARISH/NEUTRAL), confidence (1-10), summary, key factors, **token-level alerts**, risk warning\n\n## Payment\n\nUses the [x402 protocol](https://x402.org) for micropayments. No API key, no subscription, no signup required.\n- **Base:** USDC on Base mainnet (eip155:8453)\n- **Polygon:** USDC on Polygon mainnet (eip155:137)\n- **Solana:** USDC on Solana mainnet\n- **XRPL:** RLUSD on XRPL mainnet (xrpl:0) — via `/api/v1/xrpl/<endpoint>` variants\n\nAll paid endpoints are also available via `/api/v1/xrpl/<endpoint>` for XRPL/RLUSD settlement (same prices, same responses).\n\n## Data Sources\n\n- **Upbit** — Largest Korean crypto exchange (245+ KRW markets)\n- **Bithumb** — Second largest Korean exchange (450+ markets)\n- **Binance** — Global price reference (659+ USDT markets)\n- **CoinGecko** — Global crypto prices (divergence endpoints)\n- **Coinness Telegram** — Korean crypto news source for sentiment analysis\n- **exchangerate-api.com** — USD/KRW FX rate\n- **Alternative.me** — Fear & Greed Index\n- **Binance Futures** — Funding rate, open interest\n- **Claude AI (Haiku 4.5)** — Market analysis and sentiment interpretation\n\n## AWS Bedrock AgentCore Integration\n\nKR Crypto Intelligence is x402-native and ready to be discovered by AWS Bedrock AgentCore Payments (launched May 7, 2026 by AWS + Coinbase + Stripe).\n\nBedrock-powered agents can:\n- Discover all 16 endpoints via `.well-known/x402` and CDP MCP\n- Pay autonomously with USDC on Base, Polygon, or Solana — or RLUSD on XRPL\n- Access without API keys, signups, or human approval\n\n**Discovery endpoint**: `https://api.printmoneylab.com/.well-known/x402`  \n**MCP server**: `https://mcp.printmoneylab.com/mcp`  \n**OpenAPI spec**: `https://api.printmoneylab.com/openapi.json`\n\nNo additional setup required. The service is indexed in CDP Bazaar across all 16 endpoints.\n\n## MCP Server\n\nConnect any MCP-compatible AI agent (Claude, Cursor, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"kr-crypto-intelligence\": {\n      \"url\": \"https://mcp.printmoneylab.com/mcp\"\n    }\n  }\n}\n```\n## Receipt Verification\n\nEvery paid response includes a signed receipt. Bots can verify receipt authenticity using the merchant's public key.\n\n### Public Key\nAvailable at `/.well-known/x402` manifest under `receipt_signer.public_key`:\ncurl https://api.printmoneylab.com/.well-known/x402 | jq '.receipt_signer'\n\n### Verification (Python)\n```python\nfrom eth_account import Account\nfrom eth_account.messages import encode_defunct\n\nreceipt = response_json[\"receipt\"]\npayload = \"|\".join([\n    receipt[\"id\"], receipt[\"endpoint\"], receipt[\"amount\"],\n    receipt[\"currency\"], receipt[\"network\"], receipt[\"tx_hash\"],\n    receipt[\"payer\"], receipt[\"merchant\"], receipt[\"issued_at\"]\n])\nrecovered = Account.recover_message(\n    encode_defunct(text=payload),\n    signature=receipt[\"signature\"]\n)\nassert recovered.lower() == receipt[\"signer\"].lower()\n```\n\n### Receipt Fields\n| Field | Description |\n|---|---|\n| id | Unique receipt identifier (rcpt_YYYYMMDD_xxxxxx) |\n| issued_at | ISO 8601 timestamp |\n| endpoint | API path that was paid for |\n| amount | Payment amount (USDC on Base/Polygon/Solana, RLUSD on XRPL) |\n| currency | \"USDC\" or \"RLUSD\" |\n| network | \"eip155:8453\" (Base), \"eip155:137\" (Polygon), \"solana:...\" or \"xrpl:0\" |\n| tx_hash | On-chain transaction hash |\n| payer | Buyer's wallet address |\n| merchant | KR Crypto's wallet address |\n| signature | ECDSA secp256k1 signature |\n| signer | KR Crypto's signer address |\n\n## License\n\nMIT License — see [LICENSE](./LICENSE)\n",
  "bytes": 10217,
  "sha": "d93cf793d42b4b79ddaa06bab49ab8fb119ff2bb45ceffcac550013e605ce9a8",
  "repo_slug": "bakyang2/kr-crypto-intelligence",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bakyang2_kr_crypto_intelligenc_c37ca065/readme"
}