内容
# CrossFin
**AI 智能体访问亚洲加密货币市场的唯一途径**
CrossFin 是 AI 智能体的金融路由器。它可以找到跨 14 个交易所（Bithumb、Upbit、Coinone、GoPax、bitFlyer、WazirX、bitbank、Indodax、Bitkub、Binance、OKX、Bybit、KuCoin、Coinbase）最便宜的资金转移路径，使用加密货币支付 API（x402 协议），并为智能体提供实时市场数据，这些数据通常被限制在韩语界面和 IP 限制后面。
**在线访问：** [crossfin.dev](https://crossfin.dev) | **演示：** [live.crossfin.dev](https://live.crossfin.dev)
---
## 30 秒安装
将以下内容添加到您的 MCP 客户端配置中：
```json
{
"mcpServers": {
"crossfin": {
"command": "npx",
"args": ["-y", "crossfin-mcp"],
"env": {
"EVM_PRIVATE_KEY": "0x..."
}
}
}
}
```
重启您的 MCP 客户端。完成。16 种工具立即可用。
> **所有 API 端点目前免费**，在开放测试期间。无需 API 密钥。EVM 钱包是可选的（需要用于 x402 支付流程测试）。
---
## CrossFin 能做什么？
**询问您的智能体：**
- "从 Bithumb 转移 500 万韩元到 Binance 创建 USDC，最便宜的方法是什么？" → 路由引擎评估 13 种桥接币在 14 个交易所的路径，返回带有费用的最优路径
- "目前韩元和全球交易所的价差是多少？" → 韩国和全球交易所的 13 个加密货币对的实时价格价差
- "比较日本和泰国的溢价情况" → 韩国、日本、印度尼西亚和泰国的亚洲溢价指数
- "今天给我韩国市场的简报" → 早晨简报包：路由价差 + 外汇 + 头条新闻
**对于开发者/智能体：**
- `find_optimal_route` — 跨 Bithumb、Upbit、Coinone、GoPax、bitFlyer、WazirX、bitbank、Indodax、Bitkub、Binance、OKX、Bybit、KuCoin、Coinbase 使用 13 种桥接币（BTC、ETH、XRP、SOL、DOGE、ADA、DOT、LINK、AVAX、TRX、KAIA、SUI、APT）的最便宜/最快/平衡路径
- `get_kimchi_premium` — 实时韩元与全球路线价差
- `compare_exchange_prices` — 实时 Bithumb KRW 与 Binance USD 价格比较
- `call_paid_service` — 调用任何付费 API 并自动使用 x402 USDC 支付（目前在开放测试期间免费）
- 亚洲溢价端点 — 日本、印度尼西亚、泰国加密货币溢价与全球市场
---
## 为什么选择 CrossFin？
**韩国交易所是一个封闭的花园。** 韩语 API、IP 限制、实名银行账户要求（实名확인 계좌제），以及没有英文文档。AI 智能体无法访问它们 — 除非它们通过 CrossFin。
**不同交易所的价格不同。** 同一 BTC 在韩国交易所可能贵 2-3%（路线价差）。CrossFin 的路由引擎找到最便宜的桥接币和路径，同时考虑交易费用、提款费用、滑点和转移时间。
**支持 x402。** 无需 API 密钥、无需订阅、无需发票。所有端点目前在开放测试期间免费。x402 支付基础设施（Base 上的 USDC）已准备好供未来激活。
---
## 路由引擎
核心产品。给定源（交易所 + 货币）和目的地，CrossFin 评估所有可能的路径：
```
输入： bithumb:KRW → binance:USDC, ₩5,000,000
输出： 在 Bithumb 购买 AVAX → 转移到 Binance → 卖出为 USDC
费用： 0.07% (₩3,500) | 时间： ~3 分钟 | 输出： $3,452 USDC
替代方案：
BTC → 0.33% | ~21 分钟 | $3,443
DOT → 0.38% | ~6 分钟 | $3,441
```
考虑因素：交易费用（0.10–0.25%）、提款费用（每币固定）、订单簿滑点、转移时间、路线价差方向。
支持双向路由：韩国 → 全球 和 全球 → 韩国。
**免费预览：** `POST /api/acp/quote` （ACP 兼容）
**完整路线：** `GET /api/premium/route/find` （在开放测试期间免费）
---
## MCP 工具（共 16 种）
| 工具 | 功能 |
|------|-------------|
| `find_optimal_route` | 跨 14 个交易所的最优加密货币转移路径（免费） |
| `list_exchange_fees` | 交易 + 提款费用比较 |
| `compare_exchange_prices` | 实时 Bithumb KRW 与 Binance USD 比较 |
| `get_kimchi_premium` | 韩元与全球路线价差（免费预览） |
| `search_services` | 搜索已注册的服务 |
| `get_guide` | 完整的智能体指南（服务、支付流程、示例） |
| `call_paid_service` | 调用任何付费 API 并自动使用 x402 支付 |
| `create_wallet` | 本地账本钱包 |
| `get_balance` | 检查钱包余额 |
| `transfer` | 钱包之间转移 |
| `list_transactions` | 交易历史 |
| `set_budget` | 每日支出限额 |
| `list_services` | 浏览服务目录 |
| `get_service` | 服务详情 |
| `list_categories` | 服务类别 |
| `get_analytics` | 网关使用统计 |
---
## 亚洲溢价指数（v1.18.0）
跨 4 个亚洲国家的实时加密货币溢价分析。所有免费，无需 API 密钥。
| 端点 | 描述 |
|----------|-------------|
| `GET /api/premium/asia/japan` | 日本溢价 — bitbank.cc JPY 与 Binance USD |
| `GET /api/premium/asia/indonesia` | 印度尼西亚溢价 — Indodax IDR 与 Binance USD |
| `GET /api/premium/asia/thailand` | 泰国溢价 — Bitkub THB 与 Binance USD |
| `GET /api/premium/asia/overview` | 4 国概览（韩国 + 日本 + 印度尼西亚 + 泰国） |
数据源：bitbank.cc（日本）、Indodax（印度尼西亚）、Bitkub（泰国）、Bithumb（韩国）、Binance（全球）
---
## API 端点（目前全部免费）
所有端点目前在开放测试期间免费。x402 支付基础设施已准备好供未来激活。
<details>
<summary><strong>韩国市场 API</strong></summary>
| 端点 | 价格 | 描述 |
|----------|-------|-------------|
| `/api/premium/arbitrage/kimchi` | 免费 | 完整路线价差（13 对，包括 KAIA、SUI、APT） |
| `/api/premium/arbitrage/opportunities` | 免费 | 套利指标（POSITIVE_SPREAD/NEUTRAL/NEGATIVE_SPREAD） |
| `/api/premium/bithumb/orderbook?pair=BTC` | 免费 | Bithumb 订单簿（30 级） |
| `/api/premium/market/upbit/ticker` | 免费 | Upbit 交易行情 |
| `/api/premium/market/upbit/orderbook` | 免费 | Upbit 订单簿 |
| `/api/premium/market/coinone/ticker` | 免费 | Coinone 交易行情 |
| `/api/premium/market/fx/usdkrw` | 免费 | USD/KRW 汇率 |
| `/api/premium/market/korea` | 免费 | 韩国市场情绪 |
| `/api/premium/market/cross-exchange` | 免费 | 跨交易所套利决策 |
| `/api/premium/news/korea/headlines` | 免费 | 韩国头条新闻 |
| `/api/premium/arbitrage/kimchi/history` | 免费 | 路线价差历史（7 天） |
| `/api/premium/bithumb/volume-analysis` | 免费 | Bithumb 交易量分析 |
| `/api/premium/market/upbit/signals` | 免费 | Upbit 交易信号 |
| `/api/premium/crypto/korea/5exchange` | 免费 | 跨交易所价格比较 |
| `/api/premium/crypto/korea/exchange-status` | 免费 | 存提款状态 |
| `/api/premium/crypto/korea/fx-rate` | 免费 | 实时 KRW/USD（Upbit CRIX） |
| `/api/premium/crypto/korea/upbit-candles` | 免费 | Upbit OHLCV 蜡烛图 |
</details>
<details>
<summary><strong>捆绑 API</strong></summary>
| 端点 | 价格 | 描述 |
|----------|-------|-------------|
| `/api/premium/morning/brief` | 免费 | 早晨简报（路线价差 + 外汇 + 头条新闻） |
| `/api/premium/crypto/snapshot` | 免费 | 加密货币快照（4 个交易所 + 路线价差 + 交易量 + 外汇） |
| `/api/premium/kimchi/stats` | 免费 | 路线价差统计（价差 + 趋势 + 套利信号） |
</details>
<details>
<summary><strong>实用 API（开放测试期间临时免费）</strong></summary>
| 端点 | 价格 | 描述 |
|----------|-------|-------------|
| `/api/premium/report` | 免费 | 高级报告（智能体/钱包/交易总结） |
| `/api/premium/enterprise` | 免费 | 企业收据/证明端点 |
| `/api/legal/disclaimer` | 免费 | 完整法律免责声明（EN/KO） |
| `/api/analytics/overview` | 免费 | 网关分析概览 |
| `/api/analytics/funnel/overview` | 免费 | 漏斗分析概览 |
| `/api/analytics/funnel/events` | 免费 | 漏斗分析事件摄入 |
| `/api/analytics/services/{serviceId}` | 免费 | 每项服务分析 |
| `/api/onchain/usdc-transfers` | 免费 | 链上 USDC 转移监控（Base） |
| `/api/proxy/{serviceId}` | 免费 | 已注册服务的代理端点 |
| `/api/telegram/webhook` | 免费 | Telegram 机器人 webhook 端点 |
</details>
<details>
<summary><strong>协议 API（A2A + ACP）</strong></summary>
| 端点 | 价格 | 描述 |
|----------|-------|-------------|
| `POST /api/a2a/tasks` | 免费 | A2A 任务执行（加密货币路由、路线价差、市场数据） |
| `GET /api/acp/status` | 免费 | ACP 协议状态和功能 |
| `POST /api/acp/quote` | 免费 | ACP 兼容的路由报价（预览） |
| `POST /api/acp/execute` | 免费 | ACP 执行端点 |
</details>
<details>
<summary><strong>路由引擎</strong></summary>
| 端点 | 价格 | 描述 |
|----------|-------|-------------|
| `GET /api/route/exchanges` | 免费 | 支持的交易所和币种 |
| `GET /api/route/fees` | 免费 | 费用比较表 |
| `GET /api/route/pairs` | 免费 | 带有实时价格的交易对 |
| `GET /api/route/status` | 免费 | 交易所健康检查 |
| `GET /api/premium/route/find` | 免费 | 完整的最优路线分析 |
| `POST /api/acp/quote` | 免费 | ACP 兼容的路由报价（预览） |
</details>
<details>
<summary><strong>注册和发现（免费）</strong></summary>
| 端点 | 描述 |
|----------|-------------|
| `GET /api/registry` | 列出所有已注册的服务 |
| `GET /api/registry/search?q=...` | 全文搜索 |
| `GET /api/registry/categories` | 类别和计数 |
| `GET /api/registry/stats` | 注册统计（总数/CrossFin/外部） |
| `GET /api/docs/guide` | 结构化智能体指南 |
| `GET /.well-known/crossfin.json` | 智能体自动发现 |
| `GET /.well-known/x402.json` | x402 发现元数据 |
| `GET /.well-known/agent.json` | A2A 智能体卡 |
| `GET /.well-known/ai-plugin.json` | OpenAI 插件清单 |
| `GET /llms.txt` | LLM 可读站点地图 |
| `GET /api/openapi.json` | OpenAPI 3.1 规范 |
</details>
---
## 支付（x402）
> **注意：** 所有端点目前在开放测试期间免费。下面提供的 x402 支付代码仅供参考，当支付重新启用时使用。
无需 API 密钥。无需订阅。按调用付费，使用 Base 上的 USDC。
```javascript
import { x402Client, wrapFetchWithPayment } from '@x402/fetch'
import { registerExactEvmScheme } from '@x402/evm/exact/client'
import { privateKeyToAccount } from 'viem/accounts'
const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY)
const client = new x402Client()
registerExactEvmScheme(client, { signer })
const paidFetch = wrapFetchWithPayment(fetch, client)
const res = await paidFetch('https://crossfin.dev/api/premium/arbitrage/kimchi')
console.log(await res.json())
```
<details>
<summary><strong>Python</strong></summary>
```python
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client
client = x402ClientSync()
account = Account.from_key(os.environ['EVM_PRIVATE_KEY'])
register_exact_evm_client(client, EthAccountSigner(account))
with x402_requests(client) as session:
r = session.get('https://crossfin.dev/api/premium/arbitrage/kimchi')
print(r.json())
```
</details>
---
## 技术栈
Cloudflare Workers + Hono, D1 (SQLite), x402 协议, Base 上的 USDC, MCP SDK, React + Vite（仪表盘）
## 项目结构
```
apps/
api/ Cloudflare Workers API
mcp-server/ MCP 服务器（16 种工具，npm：crossfin-mcp）
web/ 网关仪表盘（crossfin.dev）
live/ 实时演示（live.crossfin.dev）
docs/ 文档（docs.crossfin.dev）
```
## 发布验证
一键运行完整的预部署验证扫描：
```bash
npm --prefix apps/api run verify:release
```
该命令运行 API 合同/目录验证，并行构建 API/web/docs，检查生产 API/页面响应，并在 README/docs/web/live/examples 中出现过时复制模式时失败。
## 链接
- [仪表盘](https://crossfin.dev) — 网关 UI
- [实时演示](https://live.crossfin.dev) — 实时路由演示
- [智能体指南](https://crossfin.dev/api/docs/guide) — 结构化 JSON 用于智能体
- [OpenAPI 规范](https://crossfin.dev/api/openapi.json) — 机器可读 API 规范
- [文档](https://docs.crossfin.dev) — 开发者文档
- [npm：crossfin-mcp](https://www.npmjs.com/package/crossfin-mcp) — MCP 服务器包
## 使用 AI 构建
CrossFin 完全由非开发者在 1 周内通过 AI 协作构建。零先前编码经验。该项目证明 AI 智能体可以构建生产软件 — 而 CrossFin 是该未来的基础设施。
