代币交换（同链/跨链）

兑换代理是执行密集型的，必须优先考虑有效性和路径安全。

is_token_swappable

示例请求

示例响应

{ "tokenIn": "WETH", "tokenOut": "USDC", "chainIn": 8453, // 应同时接受链名称和链 ID "chainOut": 8453 // 应同时接受链名称和链 ID }

## 如果可交易 { "tokenIn": { "symbol": "WETH", "address": "0x4200000000000000000000000000000000000006", "chainId": 8453, "chainName": "Base" }, "tokenOut": { "symbol": "USDC", "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chainId": 8453, "chainName": "Base" } "isSwappable": true, "isCrossChain": false, "checkedAt": "2025-01-14T11:05:44Z" } ## 如果不可交易 { "tokenIn": { "symbol": "XYZ", "address": "0x5100000000000000000000000000000000000006", "chainId": 8453, "chainName": "Base" }, "tokenOut": { "symbol": "USDC", "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chainId": 8453, "chainName": "Base" } "isSwappable": false, "isCrossChain": false, "reasonCode": "PAIR_NOT_SUPPORTED", "checkedAt": "2025-01-14T11:05:44Z" }

get_swap_quote

示例请求

示例响应

{ "tokenIn": "WETH", // 应同时接受代币符号和代币地址 "tokenOut": "USDC", // 应同时接受代币符号和代币地址 "amountIn": 0.75, "slippageTolerance": "0.50%", "chainIn": 8453, // 应同时接受链名称和链 ID "chainOut": 42161 // 应同时接受链名称和链 ID }

{ "tokenIn": { "symbol": "WETH", "address": "0x4200000000000000000000000000000000000006", "chainId": 8453, "chainName": "Base", "amount": 0.75, "usdValue": 2535.10 }, "tokenOut": { "symbol": "USDC", "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chainId": 42161, "chainName": "Arbitrumn One", "expectedAmount": 2535.20, "minimumReceivedAmount": 2533.90, "minimumReceivedUsdValue": 2533.80 } "priceImpact": "0.28%", "quoteExpiresAt": "2025-01-14T11:05:44Z" }

get_swap_history

示例请求

示例响应

{ "chainIn": 42161, // 留空以显示所有链，应同时接受链名称和链 ID "chainOut": 8453 // 留空以显示所有链，应同时接受链名称和链 ID }

{ "swaps": [ { "swapId": "swap_662190", "tokenIn": { "symbol": "WETH", "address": "0x4200000000000000000000000000000000000006", "chainId": 8453, "chainName": "Base", "amount": 0.50, "usdValue": 1695.70 }, "tokenOut": { "symbol": "USDC", "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chainId": 42161, "chainName": "Arbitrum One", "amount": 1695.80, "usdValue": 1695.70 }, "usdFeePaid": 0.75, "txHash": "0xabc789...", "status": "success", "executedAt": "2025-01-14T11:05:44Z" }, { "swapId": "swap_661875", "tokenIn": { "symbol": "USDC", "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chainId": 8453, "chainName": "Base", "amount": 1000.00, "usdValue": 999.90 }, "tokenOut": { "symbol": "WETH", "address": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1", "chainId": 42161, "chainName": "Arbitrum One", "amount": 0.2934, "usdValue": 999.90 }, "usdFeePaid": 0.75, "txHash": "0xdef456...", "status": "success", "executedAt": "2025-01-14T11:05:44Z" } ] }

get_swap_status

示例请求

示例响应

{ "orderId": "order_882901" }

{ "orderId": "order_882901", "status": "bridge_initiated", "progress": { "currentStep": 3, "completedSteps": 2, "totalSteps": 4 }, "completedSteps": [ "source_chain_transfer", "bridge_initiated" ], "pendingSteps": [ "destination_chain_confirmation", "funds_delivered" ], "tokenIn": { "symbol": "USDC", "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chainId": 8453, "chainName": "Base", "amount": 1000.00, "usdValue": 999.90 }, "tokenOut": { "symbol": "WETH", "address": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1", "chainId": 42161, "chainName": "Arbitrum One", "amount": 0.2934, "usdValue": 999.90 }, "txHash": "0xabc123...", "updatedAt": "2025-01-15T10:15:42Z" }