# CrossFin

> Cross-border crypto routing engine for AI agents. Routes capital across 14 Korean and global exchanges with x402 USDC micropayments.

## Docs

- [Agent Guide](https://crossfin.dev/api/docs/guide): Complete onboarding guide for AI agents
- [API Reference](https://docs.crossfin.dev/api): Full endpoint documentation
- [OpenAPI Spec](https://crossfin.dev/api/openapi.json): Machine-readable API specification
- [MCP Server](https://www.npmjs.com/package/crossfin-mcp): 16 tools for any MCP client

## Free Endpoints

- [Route Spread Demo](https://crossfin.dev/api/arbitrage/demo): Top 3 Korean-vs-global price spreads
- [Exchange List](https://crossfin.dev/api/route/exchanges): 14 supported exchanges and coins
- [Fee Table](https://crossfin.dev/api/route/fees): Trading and withdrawal fees
- [Exchange Prices](https://crossfin.dev/api/route/pairs): Live bridge coin prices
- [Exchange Status](https://crossfin.dev/api/route/status): Network health
- [Optimal Route](https://crossfin.dev/api/routing/optimal): Free routing graph data
- [Service Registry](https://crossfin.dev/api/registry): 184+ discoverable services
- [ACP Quote](https://crossfin.dev/api/acp/quote): Free routing quote (POST)

## Paid Endpoints (x402 USDC on Base)

- Optimal Route Finding: $0.10
- Route Spread Index (13 pairs): $0.05
- Arbitrage Opportunities: $0.10
- Bithumb/Upbit/Coinone Orderbooks: $0.02
- USD/KRW Rate: $0.01
- KOSPI/KOSDAQ Indices: $0.03
- Morning Brief Bundle: $0.20
- Crypto Snapshot Bundle: $0.15

## Discovery

- [`.well-known/crossfin.json`](https://crossfin.dev/.well-known/crossfin.json): CrossFin discovery
- [`.well-known/x402.json`](https://crossfin.dev/.well-known/x402.json): Payment discovery
- [`.well-known/agent.json`](https://crossfin.dev/.well-known/agent.json): A2A Agent Card
- [`.well-known/ai-plugin.json`](https://crossfin.dev/.well-known/ai-plugin.json): OpenAI plugin manifest
- [`.well-known/glama.json`](https://crossfin.dev/.well-known/glama.json): Glama.ai ownership verification

## Quick Start

1. Check health: GET https://crossfin.dev/api/health
2. See exchanges: GET https://crossfin.dev/api/route/exchanges
3. Get spread: GET https://crossfin.dev/api/arbitrage/demo
4. Find route: GET https://crossfin.dev/api/routing/optimal?from=bithumb:KRW&to=binance:USDC&amount=5000000
5. Install MCP: npx -y crossfin-mcp