bakyang2/kr-crypto-intelligence

Korean 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.

Endpoints (16 paid)

KRW Macro Signal (new)

Endpoint	Price	Description
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).

Korean News → English (new)

Endpoint	Price	Description
GET /api/v1/kr-news/kpop	$0.01	K-pop news (artists/groups) translated to English
GET /api/v1/kr-news/kpop-summary	$0.05	K-pop news + AI sentiment analysis, key themes, trending artists
GET /api/v1/kr-news/semiconductor	$0.02	Korean semiconductor industry news (Samsung/SK Hynix/HBM) in English
GET /api/v1/kr-news/semiconductor-summary	$0.10	Semiconductor news + AI market signal (bullish/bearish), trending companies

Korean Sentiment Analysis (World's First)

Endpoint	Price	Description
/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.

Global vs Korea Divergence

Endpoint	Price	Description
/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.
/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.

Korean Exchange Intelligence

Endpoint	Price	Description
/api/v1/arbitrage-scanner	$0.01	Token-by-token Kimchi Premium for 180+ tokens, reverse premium, Upbit-Bithumb price gaps, market share
/api/v1/exchange-alerts	$0.01	New listings/delistings detection, investment warnings, caution flags (volume soaring, deposit soaring, etc.)
/api/v1/market-movers	$0.01	1-min price surges/crashes, volume spikes, top 20 tokens by trading volume

AI-Powered Analysis

Endpoint	Price	Description
/api/v1/market-read	$0.10	AI market analysis — 12+ data sources + exchange intelligence + Claude AI token-level signals

Market Data

Endpoint	Price	Description
/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
/api/v1/stablecoin-premium	$0.002	USDT/USDC premium on Korean exchanges (fund flow indicator)
/api/v1/kr-prices	$0.002	Korean exchange prices (Upbit, Bithumb)
/api/v1/fx-rate	$0.001	USD/KRW exchange rate

Free

Endpoint	Description
/api/v1/symbols	Available trading symbols
/api/v1/stats	Service statistics
/health	Service health check
/llms.txt	AI agent metadata
/.well-known/x402	x402 service discovery

Live API

Base URL: https://api.printmoneylab.com MCP Server: https://mcp.printmoneylab.com/mcp API Docs: https://api.printmoneylab.com/docs

Key Features

Dual-Basis Kimchi Premium (Industry First)

• Both official USD/KRW basis (matches what exchanges display) and USDT real-trade basis (what arbitrage bots actually trade) in a single response
• The 0.3-1% gap between the two is the structural USDT premium itself — measurable, actionable
• Critical for AI trading agents: the official basis is misleading; only USDT basis reflects true arbitrage margin after capital movement costs
• No other Kimchi Premium API in the x402 ecosystem provides this dual-basis view

KR Sentiment (Unique — No Competitors Worldwide)

• Real-time Korean market sentiment delivered in English
• Combines exchange data (189+ tokens Kimchi Premium, warnings, volume spikes, deposit soaring) with Korean news context (Coinness Telegram, 6-hour window)
• Claude AI generates: sentiment (BULLISH/BEARISH/CAUTIOUS_FOMO/PANIC/GREED/UNCERTAIN), score (-1.0 to +1.0), English report, exchange signals, news context, sources
• Academic research validates: "Korean news sentiment predicts global crypto returns" (2026)
• 1-hour cache + lazy invocation + concurrency lock for cost efficiency

Global vs Korea Divergence

• Light tier: real-time premium between CoinGecko global price and Korean exchange (Upbit), with 1-2 sentence AI interpretation
• 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
• 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)

Arbitrage Scanner

• Real-time Kimchi Premium for every token traded on both Upbit and Binance (189+)
• Reverse premium detection (Korean discount = buy signal)
• Upbit vs Bithumb price gap scanner (domestic arbitrage)
• Market share tracking (Upbit vs Bithumb volume)

Exchange Alerts

• New listing / delisting detection (market list comparison every 60s)
• Investment warning flags (from Upbit official API)
• Caution flags: price fluctuations, volume soaring, deposit soaring, global price differences, small account concentration

Market Movers

• 1-minute price surge/crash detection (>1% in 60 seconds)
• Volume spike detection (24h change rate, >1B KRW volume)
• Top 20 tokens by trading volume

AI Market Read

• 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)
• Claude AI generates: signal (BULLISH/BEARISH/NEUTRAL), confidence (1-10), summary, key factors, token-level alerts, risk warning

Payment

Uses the x402 protocol for micropayments. No API key, no subscription, no signup required.

• Base: USDC on Base mainnet (eip155:8453)
• Polygon: USDC on Polygon mainnet (eip155:137)
• Solana: USDC on Solana mainnet
• XRPL: RLUSD on XRPL mainnet (xrpl:0) — via /api/v1/xrpl/<endpoint> variants

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

Data Sources

• Upbit — Largest Korean crypto exchange (245+ KRW markets)
• Bithumb — Second largest Korean exchange (450+ markets)
• Binance — Global price reference (659+ USDT markets)
• CoinGecko — Global crypto prices (divergence endpoints)
• Coinness Telegram — Korean crypto news source for sentiment analysis
• exchangerate-api.com — USD/KRW FX rate
• Alternative.me — Fear & Greed Index
• Binance Futures — Funding rate, open interest
• Claude AI (Haiku 4.5) — Market analysis and sentiment interpretation

AWS Bedrock AgentCore Integration

KR Crypto Intelligence is x402-native and ready to be discovered by AWS Bedrock AgentCore Payments (launched May 7, 2026 by AWS + Coinbase + Stripe).

Bedrock-powered agents can:

• Discover all 16 endpoints via .well-known/x402 and CDP MCP
• Pay autonomously with USDC on Base, Polygon, or Solana — or RLUSD on XRPL
• Access without API keys, signups, or human approval

Discovery endpoint: https://api.printmoneylab.com/.well-known/x402
MCP server: https://mcp.printmoneylab.com/mcp
OpenAPI spec: https://api.printmoneylab.com/openapi.json

No additional setup required. The service is indexed in CDP Bazaar across all 16 endpoints.

MCP Server

Connect any MCP-compatible AI agent (Claude, Cursor, etc.):

{
  "mcpServers": {
    "kr-crypto-intelligence": {
      "url": "https://mcp.printmoneylab.com/mcp"
    }
  }
}

Receipt Verification

Every paid response includes a signed receipt. Bots can verify receipt authenticity using the merchant's public key.

Public Key

Available at /.well-known/x402 manifest under receipt_signer.public_key: curl https://api.printmoneylab.com/.well-known/x402 | jq '.receipt_signer'

Verification (Python)

from eth_account import Account
from eth_account.messages import encode_defunct

receipt = response_json["receipt"]
payload = "|".join([
    receipt["id"], receipt["endpoint"], receipt["amount"],
    receipt["currency"], receipt["network"], receipt["tx_hash"],
    receipt["payer"], receipt["merchant"], receipt["issued_at"]
])
recovered = Account.recover_message(
    encode_defunct(text=payload),
    signature=receipt["signature"]
)
assert recovered.lower() == receipt["signer"].lower()

Receipt Fields

Field	Description
id	Unique receipt identifier (rcpt_YYYYMMDD_xxxxxx)
issued_at	ISO 8601 timestamp
endpoint	API path that was paid for
amount	Payment amount (USDC on Base/Polygon/Solana, RLUSD on XRPL)
currency	"USDC" or "RLUSD"
network	"eip155:8453" (Base), "eip155:137" (Polygon), "solana:..." or "xrpl:0"
tx_hash	On-chain transaction hash
payer	Buyer's wallet address
merchant	KR Crypto's wallet address
signature	ECDSA secp256k1 signature
signer	KR Crypto's signer address

License

MIT License — see LICENSE