查询价格
在 Kroko DEX 上有多种方式查询代币价格,具体取决于你的使用场景。
方法 1:报价 API(推荐)
获取价格最准确的方式是请求交换报价。这会考虑所有可用路由,并给出实际执行价格。
const params = new URLSearchParams({
tokenIn: '0xTokenA',
tokenOut: '0xTokenB',
amountIn: '1000000000000000000', // 1 个代币
tradeType: '0'
});
const res = await fetch(`https://dex.kasplex.org/swap-api/api/v1/quote?${params}`);
const quote = await res.json();
console.log(`价格:1 TokenA = ${quote.executionPrice} TokenB`);
console.log(`价格影响:${quote.priceImpact}%`);
最适合: 实时交换定价,向用户展示将收到的数量。
执行价格会因价格影响随交易规模变化。如需参考价格,请使用较小的金额。
方法 2:价格 API
无需指定金额即可直接获取价格:
// 单个代币价格
const res = await fetch('https://dex.kasplex.org/swap-api/api/v1/price/0xTokenAddress');
// 交易对价格
const res = await fetch('https://dex.kasplex.org/swap-api/api/v1/price/pair/0xToken0/0xToken1');
最适合: 仪表盘展示、投资组合估值。
方法 3:链上查询 (V2)
直接读取 V2 池的储备量:
const PAIR_ABI = [
'function getReserves() view returns (uint112, uint112, uint32)',
'function token0() view returns (address)'
];
const pair = new ethers.Contract(pairAddress, PAIR_ABI, provider);
const [reserve0, reserve1] = await pair.getReserves();
const token0 = await pair.token0();
// token0 以 token1 计价的价格
const price = Number(reserve1) / Number(reserve0);
最适合: 无需信任的链上价格读取、预言机类用例。
方法 4:链上查询 (V3)
从 V3 池读取当前价格:
const POOL_ABI = [
'function slot0() view returns (uint160, int24, uint16, uint16, uint16, uint8, bool)'
];
const pool = new ethers.Contract(poolAddress, POOL_ABI, provider);
const [sqrtPriceX96, tick] = await pool.slot0();
// 将 sqrtPriceX96 转换为价格
const price = (Number(sqrtPriceX96) / 2 ** 96) ** 2;
// 如果代币精度不同,需要调整
const adjustedPrice = price * (10 ** (decimals0 - decimals1));
最适合: V3 专用价格数据、tick 级精度。
历史价格
获取历史 K 线数据:
const res = await fetch(
'https://dex.kasplex.org/swap-api/api/v1/price/history/0xPoolAddress?limit=100'
);
| 方法 | 精度 | 延迟 | 信任模型 | 最适合 |
|---|
| 报价 API | 最高(考虑路由) | ~100ms | 中心化 API | 交换界面 |
| 价格 API | 高 | ~50ms | 中心化 API | 仪表盘 |
| 链上 V2 | 池级别 | ~2s(RPC) | 无需信任 | 预言机 |
| 链上 V3 | 池级别 | ~2s(RPC) | 无需信任 | 高级分析 |