io.github.bakyang2/kr-crypto-intelligence

KR Crypto Intelligence API

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)

Korean News → English (new)

Korean Sentiment Analysis (World's First)

Global vs Korea Divergence

Korean Exchange Intelligence

AI-Powered Analysis

Market Data

Free

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

License

MIT License — see LICENSE