The only way AI agents access Asian crypto markets. CrossFin is a financial router for AI agents. It finds the cheapest path to move money across 14 exchanges (Bithumb, Upbit, Coinone, GoPax, bitFlyer, WazirX, bitbank, Indodax, Bitkub, Binance, OKX, Bybit, KuCoin, Coinbase), pays for APIs with crypto (x402 protocol), and gives agents real-time access to market data that's normally locked behind Ko
Add this skill
npx mdskills install bubilife1202/crossfinComprehensive MCP server for Asian crypto market access with routing engine and 16 well-documented tools
1# CrossFin23**The only way AI agents access Asian crypto markets.**45CrossFin is a financial router for AI agents. It finds the cheapest path to move money across 14 exchanges (Bithumb, Upbit, Coinone, GoPax, bitFlyer, WazirX, bitbank, Indodax, Bitkub, Binance, OKX, Bybit, KuCoin, Coinbase), pays for APIs with crypto (x402 protocol), and gives agents real-time access to market data that's normally locked behind Korean-language interfaces and IP restrictions.67**Live:** [crossfin.dev](https://crossfin.dev) | **Demo:** [live.crossfin.dev](https://live.crossfin.dev)89---1011## Install in 30 seconds1213Add this to your MCP client config:1415```json16{17 "mcpServers": {18 "crossfin": {19 "command": "npx",20 "args": ["-y", "crossfin-mcp"],21 "env": {22 "EVM_PRIVATE_KEY": "0x..."23 }24 }25 }26}27```2829Restart your MCP client. Done. 16 tools available immediately.3031> **All API endpoints are currently free** during open beta. No API key required. EVM wallet is optional (needed for x402 payment flow testing).3233---3435## What can it do?3637**Ask your agent:**3839- "빗썸에서 바이낸스로 500만원 USDC 만들려면 가장 싼 방법이 뭐야?" → Routing engine evaluates 13 bridge coins across 14 exchanges, returns optimal path with fees40- "지금 한국-글로벌 스프레드 얼마야?" → Real-time price spread between Korean and global exchanges for 13 crypto pairs41- "일본이랑 태국 프리미엄 비교해줘" → Asian Premium Index across Korea, Japan, Indonesia, Thailand42- "오늘 한국 시장 브리핑해줘" → Morning Brief bundle: route spread + FX + headlines4344**For developers/agents:**4546- `find_optimal_route` — cheapest/fastest/balanced path across Bithumb, Upbit, Coinone, GoPax, bitFlyer, WazirX, bitbank, Indodax, Bitkub, Binance, OKX, Bybit, KuCoin, Coinbase using 13 bridge coins (BTC, ETH, XRP, SOL, DOGE, ADA, DOT, LINK, AVAX, TRX, KAIA, SUI, APT)47- `get_kimchi_premium` — real-time Korean vs. global route spread48- `compare_exchange_prices` — live Bithumb KRW vs Binance USD price comparison49- `call_paid_service` — call any paid API with automatic x402 USDC payment (currently free during open beta)50- Asian Premium endpoints — Japan, Indonesia, Thailand crypto premiums vs global markets5152---5354## Why CrossFin?5556**Korean exchanges are a walled garden.** Korean-language APIs, IP restrictions, real-name bank account requirements (실명확인 계좌제), and no English documentation. AI agents can't access them — unless they go through CrossFin.5758**Prices differ across exchanges.** The same BTC can be 2-3% more expensive on Korean exchanges (route spread). CrossFin's routing engine finds the cheapest bridge coin and path, factoring in trading fees, withdrawal fees, slippage, and transfer time.5960**x402 ready.** No API keys, no subscriptions, no invoices. All endpoints are currently free during open beta. x402 payment infrastructure (USDC on Base) ready for future activation.6162---6364## Routing Engine6566The core product. Given a source (exchange + currency) and destination, CrossFin evaluates all possible paths:6768```69Input: bithumb:KRW → binance:USDC, ₩5,000,00070Output: Buy AVAX on Bithumb → Transfer to Binance → Sell for USDC71 Cost: 0.07% (₩3,500) | Time: ~3 min | Output: $3,452 USDC7273 Alternatives:74 BTC → 0.33% | ~21 min | $3,44375 DOT → 0.38% | ~6 min | $3,44176```7778Considers: trading fees (0.10–0.25%), withdrawal fees (fixed per coin), orderbook slippage, transfer time, route spread direction.7980Supports bidirectional routing: Korea → Global and Global → Korea.8182**Free preview:** `POST /api/acp/quote` (ACP compatible)83**Full route:** `GET /api/premium/route/find` (free during open beta)8485---8687## MCP Tools (16 total)8889| Tool | What it does |90|------|-------------|91| `find_optimal_route` | Optimal crypto transfer path across 14 exchanges (free) |92| `list_exchange_fees` | Trading + withdrawal fee comparison |93| `compare_exchange_prices` | Live Bithumb KRW vs Binance USD comparison |94| `get_kimchi_premium` | Korean vs. global route spread (free preview) |95| `search_services` | Search registered services |96| `get_guide` | Full agent guide (services, payment flow, examples) |97| `call_paid_service` | Call any paid API with automatic x402 payment |98| `create_wallet` | Local ledger wallet |99| `get_balance` | Check wallet balance |100| `transfer` | Transfer between wallets |101| `list_transactions` | Transaction history |102| `set_budget` | Daily spend limit |103| `list_services` | Browse service catalog |104| `get_service` | Service details |105| `list_categories` | Service categories |106| `get_analytics` | Gateway usage stats |107108---109110## Asian Premium Index (v1.13.0)111112Real-time crypto premium analysis across 4 Asian countries. All free, no API key needed.113114| Endpoint | Description |115|----------|-------------|116| `GET /api/premium/asia/japan` | Japan premium — bitbank.cc JPY vs Binance USD |117| `GET /api/premium/asia/indonesia` | Indonesia premium — Indodax IDR vs Binance USD |118| `GET /api/premium/asia/thailand` | Thailand premium — Bitkub THB vs Binance USD |119| `GET /api/premium/asia/overview` | 4-country overview (Korea + Japan + Indonesia + Thailand) |120121Data sources: bitbank.cc (Japan), Indodax (Indonesia), Bitkub (Thailand), Bithumb (Korea), Binance (Global)122123---124125## API Endpoints (Currently All Free)126127All endpoints are currently free during open beta. x402 payment infrastructure is ready for future activation.128129<details>130<summary><strong>Korean Market APIs</strong></summary>131132| Endpoint | Price | Description |133|----------|-------|-------------|134| `/api/premium/arbitrage/kimchi` | Free | Full Route Spread (13 pairs incl. KAIA, SUI, APT) |135| `/api/premium/arbitrage/opportunities` | Free | Arbitrage indicators (POSITIVE_SPREAD/NEUTRAL/NEGATIVE_SPREAD) |136| `/api/premium/bithumb/orderbook?pair=BTC` | Free | Bithumb orderbook (30 levels) |137| `/api/premium/market/upbit/ticker` | Free | Upbit ticker |138| `/api/premium/market/upbit/orderbook` | Free | Upbit orderbook |139| `/api/premium/market/coinone/ticker` | Free | Coinone ticker |140| `/api/premium/market/fx/usdkrw` | Free | USD/KRW exchange rate |141| `/api/premium/market/korea` | Free | Korean market sentiment |142| `/api/premium/market/cross-exchange` | Free | Cross-exchange arbitrage decision |143| `/api/premium/news/korea/headlines` | Free | Korean headlines |144| `/api/premium/arbitrage/kimchi/history` | Free | Route spread history (7 days) |145| `/api/premium/bithumb/volume-analysis` | Free | Bithumb volume analysis |146| `/api/premium/market/upbit/signals` | Free | Upbit trading signals |147| `/api/premium/crypto/korea/5exchange` | Free | Cross-exchange price comparison |148| `/api/premium/crypto/korea/exchange-status` | Free | Deposit/withdrawal status |149| `/api/premium/crypto/korea/fx-rate` | Free | Real-time KRW/USD (Upbit CRIX) |150| `/api/premium/crypto/korea/upbit-candles` | Free | Upbit OHLCV candles |151152</details>153154<details>155<summary><strong>Bundle APIs</strong></summary>156157| Endpoint | Price | Description |158|----------|-------|-------------|159| `/api/premium/morning/brief` | Free | Morning Brief (route spread + FX + headlines) |160| `/api/premium/crypto/snapshot` | Free | Crypto Snapshot (4-exchange + route spread + volume + FX) |161| `/api/premium/kimchi/stats` | Free | Route Spread Stats (spreads + trend + arbitrage signal) |162163</details>164165<details>166<summary><strong>Utility APIs (Temporarily Free in Open Beta)</strong></summary>167168| Endpoint | Price | Description |169|----------|-------|-------------|170| `/api/premium/report` | Free | Premium report (agents/wallets/transactions summary) |171| `/api/premium/enterprise` | Free | Enterprise receipt/proof endpoint |172| `/api/legal/disclaimer` | Free | Full legal disclaimer (EN/KO) |173| `/api/analytics/overview` | Free | Gateway analytics overview |174| `/api/analytics/funnel/overview` | Free | Funnel analytics overview |175| `/api/analytics/funnel/events` | Free | Funnel analytics event ingestion |176| `/api/analytics/services/{serviceId}` | Free | Per-service analytics |177| `/api/onchain/usdc-transfers` | Free | On-chain USDC transfer monitor (Base) |178| `/api/proxy/{serviceId}` | Free | Proxy endpoint for registered services |179| `/api/telegram/webhook` | Free | Telegram bot webhook endpoint |180181</details>182183<details>184<summary><strong>Protocol APIs (A2A + ACP)</strong></summary>185186| Endpoint | Price | Description |187|----------|-------|-------------|188| `POST /api/a2a/tasks` | Free | A2A task execution (crypto-routing, route-spread, market data) |189| `GET /api/acp/status` | Free | ACP protocol status and capabilities |190| `POST /api/acp/quote` | Free | ACP-compatible routing quote (preview) |191| `POST /api/acp/execute` | Free | ACP execution endpoint |192193</details>194195<details>196<summary><strong>Routing Engine</strong></summary>197198| Endpoint | Price | Description |199|----------|-------|-------------|200| `GET /api/route/exchanges` | Free | Supported exchanges and coins |201| `GET /api/route/fees` | Free | Fee comparison table |202| `GET /api/route/pairs` | Free | Trading pairs with live prices |203| `GET /api/route/status` | Free | Exchange health check |204| `GET /api/premium/route/find` | Free | Full optimal route analysis |205| `POST /api/acp/quote` | Free | ACP-compatible routing quote (preview) |206207</details>208209<details>210<summary><strong>Registry & Discovery (Free)</strong></summary>211212| Endpoint | Description |213|----------|-------------|214| `GET /api/registry` | List all registered services |215| `GET /api/registry/search?q=...` | Full-text search |216| `GET /api/registry/categories` | Categories with counts |217| `GET /api/registry/stats` | Registry stats (total/crossfin/external) |218| `GET /api/docs/guide` | Structured agent guide |219| `GET /.well-known/crossfin.json` | Agent auto-discovery |220| `GET /.well-known/x402.json` | x402 discovery metadata |221| `GET /.well-known/agent.json` | A2A Agent Card |222| `GET /.well-known/ai-plugin.json` | OpenAI plugin manifest |223| `GET /llms.txt` | LLM-readable site map |224| `GET /api/openapi.json` | OpenAPI 3.1 spec |225226</details>227228---229230## Payment (x402)231232> **Note:** All endpoints are currently free during open beta. The x402 payment code below is for reference when payments are re-enabled.233234No API keys. No subscriptions. Pay per call with USDC on Base.235236```javascript237import { x402Client, wrapFetchWithPayment } from '@x402/fetch'238import { registerExactEvmScheme } from '@x402/evm/exact/client'239import { privateKeyToAccount } from 'viem/accounts'240241const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY)242const client = new x402Client()243registerExactEvmScheme(client, { signer })244245const paidFetch = wrapFetchWithPayment(fetch, client)246const res = await paidFetch('https://crossfin.dev/api/premium/arbitrage/kimchi')247console.log(await res.json())248```249250<details>251<summary><strong>Python</strong></summary>252253```python254import os255from eth_account import Account256from x402 import x402ClientSync257from x402.http.clients import x402_requests258from x402.mechanisms.evm import EthAccountSigner259from x402.mechanisms.evm.exact.register import register_exact_evm_client260261client = x402ClientSync()262account = Account.from_key(os.environ['EVM_PRIVATE_KEY'])263register_exact_evm_client(client, EthAccountSigner(account))264265with x402_requests(client) as session:266 r = session.get('https://crossfin.dev/api/premium/arbitrage/kimchi')267 print(r.json())268```269270</details>271272---273274## Tech Stack275276Cloudflare Workers + Hono, D1 (SQLite), x402 protocol, USDC on Base, MCP SDK, React + Vite (dashboard)277278## Project Structure279280```281apps/282 api/ Cloudflare Workers API283 mcp-server/ MCP Server (16 tools, npm: crossfin-mcp)284 web/ Gateway Dashboard (crossfin.dev)285 live/ Live Demo (live.crossfin.dev)286 docs/ Documentation (docs.crossfin.dev)287```288289## Release Verification290291Run a full pre-deploy verification sweep in one command:292293```bash294npm --prefix apps/api run verify:release295```296297This command runs API contract/catalog verification, builds API/web/docs in parallel, checks production API/page responses, and fails on stale copy patterns in README/docs/web/live/examples.298299## Links300301- [Dashboard](https://crossfin.dev) — Gateway UI302- [Live Demo](https://live.crossfin.dev) — Real-time routing demo303- [Agent Guide](https://crossfin.dev/api/docs/guide) — Structured JSON for agents304- [OpenAPI Spec](https://crossfin.dev/api/openapi.json) — Machine-readable API spec305- [Docs](https://docs.crossfin.dev) — Developer documentation306- [npm: crossfin-mcp](https://www.npmjs.com/package/crossfin-mcp) — MCP server package307308## Built with AI309310CrossFin was built entirely through AI collaboration by a non-developer in 1 week. Zero prior coding experience. This project is proof that AI agents can build production software — and CrossFin is the infrastructure for that future.311
Full transparency — inspect the skill content before installing.