# KR Crypto Intelligence API

> Korean crypto market data + AI sentiment analysis for AI agents. Pay per request via x402 on Base, Polygon, Solana, and XRPL. The only Korean crypto market data provider on XRPL — payable in RLUSD.
> API: https://api.printmoneylab.com
> MCP: https://mcp.printmoneylab.com/mcp
> Docs: https://api.printmoneylab.com/docs
> GitHub: https://github.com/bakyang2/kr-crypto-intelligence

## How it works

Every endpoint is callable via the x402 payment protocol.
Your agent sends a standard HTTP request; when payment is required,
it receives HTTP 402 with payment instructions. No API keys, no accounts,
no registration. Payment is settled per-request in USDC (on Base, Polygon,
or Solana) or RLUSD (on XRPL — via /api/v1/xrpl/<endpoint> variants).

## How AI agents pay

This API uses x402 micropayments (HTTP 402 Payment Required protocol).

### Quick start

1. Install an x402-compatible client:
   - AgentCash (recommended for MCP): https://agentcash.dev
   - Pay.sh (Google Cloud / Solana Foundation): https://pay.sh
   - x402 SDK (TypeScript / Python / Go / Java): https://github.com/coinbase/x402
2. Fund your wallet:
   - USDC on Base, Polygon, or Solana mainnet, OR
   - RLUSD on XRPL mainnet (for /api/v1/xrpl/<endpoint> variants)
   - Minimum $0.10 recommended for testing
   - Each API call costs $0.001 to $0.10 (same tiers on all chains)
3. Call any paid endpoint:
   - First call returns HTTP 402 with payment challenge
   - Client signs a stablecoin transfer (USDC or RLUSD; handled automatically)
   - Retry with X-PAYMENT (EVM/Solana) or PAYMENT-SIGNATURE (XRPL) header gets data

All paid endpoints are also reachable via /api/v1/xrpl/<endpoint> for
XRPL/RLUSD settlement — same prices, same responses.

### Merchant wallets

- Base mainnet: 0xcF9223eCe895258dEa8D288AEBcf846Ab8E342fB
- Polygon mainnet: 0xcF9223eCe895258dEa8D288AEBcf846Ab8E342fB
- Solana mainnet: 3Ywxk31SvWKwZBdY6bLvjmn5h4mzWcT3HJ5UZbYXoVy9
- XRPL mainnet: raKj7ZGoPy1fWw1vfynuJhyHirpcmUMBhP
- RLUSD issuer (XRPL): rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De

### Receipt verification

Every paid response includes a signed receipt (ECDSA secp256k1) for agent accountability.

- Public key: https://api.printmoneylab.com/.well-known/x402 → receipt_signer.public_key
- Verification: Account.recover_message() from the eth_account Python library
- Payload format: id|endpoint|amount|currency|network|tx_hash|payer|merchant|issued_at

### Browser support

CORS preflight allows X-PAYMENT header from any origin. Browser-based agents can
call paid endpoints directly without proxy.

## Unique value

World's first Korean-to-English crypto sentiment API. Covers 189+ tokens
across Upbit and Bithumb (top Korean exchanges). Academic research
(European Journal of Finance, 2026) confirms Korean news sentiment
predicts global crypto returns.

## Networks supported

- Base (eip155:8453)
- Polygon (eip155:137)
- Solana mainnet

## Endpoints

### Korean Sentiment Analysis
- GET /api/v1/kr-sentiment -> $0.05
  World's first Korean-to-English crypto sentiment. Combines 189+ tokens
  exchange intelligence with Korean news context for AI-powered insights.
  1-hour cache.

### KRW Macro Signal
- GET /api/v1/krw-macro-stress -> $0.05
  KRW Macro Stress Score (0-100). Combined 5-component signal:
  US 3Y treasury (FRED), VIX, foreign ownership proxy on 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-generated factual note (no trading advice).
  15-min cache. Positioning: KRW macro stress signal for trading bots
  filtering entry/exit on macro regime (not a kimchi-premium predictor).

### AI Analysis
- GET /api/v1/market-read -> $0.10
  Comprehensive market analysis combining 12+ data sources with
  Claude AI. Returns signal (BULLISH/BEARISH/NEUTRAL), confidence
  score, token-level alerts.
- GET /api/v1/global-vs-korea-divergence?symbol={SYMBOL} -> $0.05
  Global (CoinGecko) vs Korean (Upbit) price divergence with AI
  interpretation (1-2 sentence summary). 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).
- GET /api/v1/global-vs-korea-divergence-deep?symbol={SYMBOL} -> $0.10
  Same as light tier plus: Korean news signals from Coinness Telegram
  (24h window, top keywords, sentiment score) and structured AI
  analysis with korean_market_drivers, global_context, action
  suggestion, and confidence rating.

### Korean Exchange Intelligence
- GET /api/v1/arbitrage-scanner -> $0.01
  Token-by-token Kimchi Premium for 189+ tokens, reverse premium
  detection, Upbit-Bithumb price gaps.
- GET /api/v1/exchange-alerts -> $0.01
  New listings/delistings, investment warnings, caution flags.
- GET /api/v1/market-movers -> $0.01
  1-minute price surges/crashes, volume spikes, top 20 by volume.

### Market Data
- GET /api/v1/kimchi-premium?symbol={SYMBOL} -> $0.002
- GET /api/v1/stablecoin-premium -> $0.002
- GET /api/v1/kr-prices?symbol={SYMBOL}&exchange={EXCHANGE} -> $0.002
- GET /api/v1/fx-rate -> $0.001

### Korean News → English (Naver-aggregated, AI-translated)
- GET /api/v1/kr-news/kpop?limit={1..10} -> $0.01
  Korean K-pop news (artists, groups, soloists, comebacks) translated to
  English with AI relevance classification. Returns title_en + summary_en
  + source_en + original Korean (title_kr/source_kr) for verification.
  5-min cache.
- GET /api/v1/kr-news/kpop-summary?limit={1..10} -> $0.05
  Same articles + Sonnet 4.6 synthesis: overall_sentiment, key_themes,
  trending_entities, paragraph summary.
- GET /api/v1/kr-news/semiconductor?limit={1..10} -> $0.02
  Korean semiconductor industry news (Samsung Electronics, SK Hynix, HBM,
  DRAM/NAND, foundry, suppliers) translated to English. Headlines from
  전자신문/디지털타임스/한국경제/etc.
- GET /api/v1/kr-news/semiconductor-summary?limit={1..10} -> $0.10
  Same articles + Sonnet 4.6 market synthesis: sentiment, key_themes,
  trending_entities, market_signal (bullish/bearish/neutral), paragraph.

### Free
- GET /api/v1/symbols -> free (list of tradeable symbols)
- GET /health -> free (service health)

## Discovery

Our endpoints are registered in the x402 Bazaar discovery layer.
Query all CDP-facilitated services:
  GET https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources

## MCP server

Connect any MCP-compatible AI agent (Claude, Cursor, ChatGPT):
  URL: https://mcp.printmoneylab.com/mcp
  Transport: streamable-http
  Tools: 13 (get_kr_sentiment, get_market_read, get_arbitrage_scanner,
         get_exchange_alerts, get_market_movers, get_kimchi_premium,
         get_stablecoin_premium, get_kr_prices, get_fx_rate,
         get_global_vs_korea_divergence, get_global_vs_korea_divergence_deep,
         get_available_symbols, check_health)