跳转到主要内容

​
Swap API

生成可直接使用的交易 calldata，通过 Universal Router 执行交换。返回的响应可以直接作为交易发送。

​
POST /api/v1/swap

​
请求体

{
  "tokenIn": "0xB190a6A7fC2873f1Abf145279eD664348d5Ef630",
  "tokenOut": "0x3Ac3B30b7f18AEFD4590D7FE4d9C5944aaeB7220",
  "amountIn": "1000000000000000000",
  "tradeType": 0,
  "slippage": 0.5,
  "recipient": "0xYourAddress",
  "deadline": 1200
}
字段类型必填描述
tokenInstring是输入代币地址
tokenOutstring是输出代币地址
amountInstring条件必填输入数量，tradeType=0 时必填
amountOutstring条件必填输出数量，tradeType=1 时必填
tradeTypenumber否0 = 精确输入（默认），1 = 精确输出
slippagenumber否滑点容忍度（百分比，默认：0.5）
recipientstring是接收输出代币的地址
deadlinenumber否过期时间（秒，默认：1200 = 20 分钟）

​
响应

{
  "to": "0x440d7f5FE865eFCcfdCB1ee9a000C114163689ba",
  "data": "0x3593564c...",
  "value": "0",
  "gasEstimate": "100000",
  "tradeType": 0,
  "quote": {
    "tokenIn": "0xb190...",
    "tokenOut": "0x3ac3...",
    "amountIn": "1000000000000000000",
    "amountOut": "1007249042881810956",
    "minAmountOut": "1002212797667401901",
    "priceImpact": 0.3,
    "protocol": "v2",
    "path": ["0xb190...", "0x3ac3..."],
    "fees": [0],
    "hops": 1
  },
  "deadline": "1764573986",
  "slippage": 0.5,
  "permit2": "0xc320bc492Bb56169aBE18D3C0a2048c45febC897"
}
字段描述
toUniversal Router 地址——用作交易的 to 字段
data编码后的 calldata——用作交易的 data 字段
value原生 KAS 数量——用作交易的 value 字段（当输入代币为 KAS 时不为零）
gasEstimate预估 Gas 用量
quote.minAmountOut最低输出数量（精确输入时）——链上滑点保护
quote.maxAmountIn最高输入数量（精确输出时）——链上滑点保护
permit2Permit2 合约地址

​
滑点保护

交易类型字段计算公式
精确输入 (0)minAmountOutamountOut × (1 - slippage / 100)
精确输出 (1)maxAmountInamountIn × (1 + slippage / 100)
这些限制由 Universal Router 在链上强制执行。如果实际执行超出滑点范围，交易将会回滚。

​
使用方式

// 1. 获取 calldata
const res = await fetch('/swap-api/api/v1/swap', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    tokenIn, tokenOut, amountIn,
    tradeType: 0,
    slippage: 0.5,
    recipient: userAddress,
    deadline: 1200
  })
});
const swapData = await res.json();

// 2. 发送交易
const tx = await signer.sendTransaction({
  to: swapData.to,
  data: swapData.data,
  value: swapData.value
});

​
示例

{
  "tokenIn": "0xB190a6A7fC2873f1Abf145279eD664348d5Ef630",
  "tokenOut": "0x3Ac3B30b7f18AEFD4590D7FE4d9C5944aaeB7220",
  "amountIn": "1000000000000000000",
  "tradeType": 0,
  "slippage": 0.5,
  "recipient": "0xUserAddress",
  "deadline": 1200
}