io.github.bakyang2/kr-crypto-intelligence
Korean crypto + news (kpop/semi), 17 tools, signed receipts. x402 Base+Polygon+Solana.
Open source Repository Open in the app JSON README (API)
About
Korean crypto + news (kpop/semi), 17 tools, signed receipts. x402 Base+Polygon+Solana.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- bakyang2
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.6.0
- Stars
- 2
- Forks
- 2
- Open pull requests
- 2
- Last push
- 2026-08-04T05:58:57Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:02:28
- Updated
- 2026-08-29 03:02:28
- Origin id
io.github.bakyang2/kr-crypto-intelligence
README
# 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)
| 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](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](https://x402.org) 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.):
```json
{
"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)
```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](./LICENSE)