name: router
description: “智能订单路由,基于最佳价格、流动性和执行质量”
emoji: “🔀”
Router - 完整 API 参考
基于价格、流动性、费用和执行质量,将订单路由到最佳平台。
聊天命令
路由订单
/route "Trump 2028" YES 1000 为1000美元寻找最佳路由
/route BTCUSDT long 0.5 路由期货订单
/route --mode best-price "Fed" YES 优化价格
/route --mode best-liquidity ... 优化填充率
比较路由
/route compare "Trump" YES 1000 比较所有平台
/route fees "Trump" 比较费用结构
/route liquidity "Trump" 比较订单簿深度
执行
/route execute <route-id> 执行路由订单
/route split "Trump" YES 5000 跨平台拆分订单
TypeScript API 参考
创建智能路由
import { createSmartRouter } from 'clodds/router';
const router = createSmartRouter({
// 支持的平台
platforms: ['polymarket', 'kalshi', 'manifold'],
// 默认模式
defaultMode: 'balanced',
// 费用结构
fees: {
polymarket: { maker: -0.005, taker: 0.01 },
kalshi: { maker: 0, taker: 0.01 },
manifold: { maker: 0, taker: 0 },
},
});
寻找最佳路由
const route = await router.findBestRoute({
market: 'trump-win-2028',
side: 'YES',
size: 1000,
mode: 'best-price', // 'best-price' | 'best-liquidity' | 'lowest-fee' | 'balanced'
});
console.log(`最佳平台: ${route.platform}`);
console.log(`预期价格: ${route.expectedPrice}`);
console.log(`预期滑点: ${route.expectedSlippage}%`);
console.log(`费用: $${route.fees}`);
console.log(`净成本: $${route.netCost}`);
console.log(`填充概率: ${route.fillProbability}%`);
比较所有平台
const comparison = await router.compare({
market: 'trump-win-2028',
side: 'YES',
size: 1000,
});
console.log('平台比较:');
for (const platform of comparison) {
console.log(`
${platform.name}:`);
console.log(` 价格: ${platform.price}`);
console.log(` 流动性: $${platform.liquidity}`);
console.log(` 滑点: ${platform.slippage}%`);
console.log(` 费用: $${platform.fees}`);
console.log(` 净成本: $${platform.netCost}`);
console.log(` 分数: ${platform.score}`);
}
跨平台拆分订单
// 大订单拆分以优化执行
const split = await router.splitOrder({
market: 'trump-win-2028',
side: 'YES',
size: 10000,
maxSlippage: 0.02,
});
console.log('订单拆分:');
for (const leg of split.legs) {
console.log(` ${leg.platform}: $${leg.size} @ ${leg.price}`);
}
console.log(`总滑点: ${split.totalSlippage}%`);
console.log(`平均价格: ${split.avgPrice}`);
执行路由
// 执行路由订单
const result = await router.execute(route);
console.log(`订单ID: ${result.orderId}`);
console.log(`平台: ${result.platform}`);
console.log(`填充价格: ${result.fillPrice}`);
console.log(`滑点: ${result.actualSlippage}%`);
console.log(`费用: $${result.fees}`);
路由模式
// 最佳价格 - 最小化支付价格
const priceRoute = await router.findBestRoute({
...order,
mode: 'best-price',
});
// 最佳流动性 - 最大化填充概率
const liquidityRoute = await router.findBestRoute({
...order,
mode: 'best-liquidity',
});
// 最低费用 - 最小化交易成本
const feeRoute = await router.findBestRoute({
...order,
mode: 'lowest-fee',
});
// 平衡 - 加权优化
const balancedRoute = await router.findBestRoute({
...order,
mode: 'balanced',
weights: {
price: 0.4,
liquidity: 0.3,
fees: 0.3,
},
});
费用分析
const fees = await router.analyzeFees({
market: 'trump-win-2028',
side: 'YES',
size: 1000,
});
for (const platform of fees) {
console.log(`${platform.name}:`);
console.log(` 做市商费用: ${platform.makerFee}%`);
console.log(` 吃单费用: ${platform.takerFee}%`);
console.log(` 此订单费用: $${platform.totalFee}`);
console.log(` 是否有返佣: ${platform.hasRebate}`);
}
流动性分析
const liquidity = await router.analyzeLiquidity({
market: 'trump-win-2028',
side: 'YES',
});
for (const platform of liquidity) {
console.log(`${platform.name}:`);
console.log(` 最佳买入价: ${platform.bestBid}`);
console.log(` 最佳卖出价: ${platform.bestAsk}`);
console.log(` 价差: ${platform.spread}%`);
console.log(` 1%深度: $${platform.depth1Pct}`);
console.log(` 2%深度: $${platform.depth2Pct}`);
}
路由模式
| 模式 |
优化目标 |
最佳使用场景 |
best-price |
最低价格 |
小订单 |
best-liquidity |
填充概率 |
大订单 |
lowest-fee |
最小化费用 |
高频交易 |
balanced |
加权组合 |
默认选择 |
平台比较
| 平台 |
做市商费用 |
吃单费用 |
备注 |
| Polymarket |
0% |
0% |
大多数市场零费用;15分钟加密货币市场有动态费用 |
| Kalshi |
~0.17% |
~1.2% |
基于公式的费用,上限约2% |
| Manifold |
0% |
0% |
游戏货币 |
最佳实践
- 交易前比较 — 始终检查替代方案
- 使用做市商订单 — 在Polymarket上支付零费用(相对于15分钟加密货币市场的动态费用)
- 拆分大订单 — 减少滑点
- 检查流动性 — 不要在薄市场交易
- 考虑费用 — Polymarket:大多数市场0%;Kalshi:平均约1.2%