Skip to content

bakyang2/kr-crypto-intelligence

Repository files navigation

KR Crypto Intelligence API

Korean crypto market data + AI analysis for AI agents. 15 paid endpoints (11 crypto + 4 Korean news), 180+ tokens, world's first Korean-to-English crypto sentiment API. Pay-per-use via x402 protocol on Base, Polygon, and Solana. AWS Bedrock AgentCore-ready.

Endpoints (15 paid)

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.001 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.001 USDT/USDC premium on Korean exchanges (fund flow indicator)
/api/v1/kr-prices $0.001 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

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 11 endpoints via .well-known/x402 and CDP MCP
  • Pay autonomously with USDC on Base, Polygon, or Solana
  • 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 11 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 in USDC
currency "USDC"
network "eip155:8453" (Base) or "solana:..."
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

About

Korean crypto market data API for AI agents. Kimchi premium, exchange prices, FX rates. x402 pay-per-use on Base.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors