mcpField
D
Dex Quotes X402

Dex Quotes X402

远程服务
github.com金融数据08 周前更新

关于 Dex Quotes X402

Dex Quotes X402 是面向 AI Agent 的 MCP 服务,用于交易前查询代币兑换报价。它比较多个 DEX 的路径,并通过 x402 按次收取 Base 上的 USDC。

主要功能

  1. 01比较 Uniswap、SushiSwap 和 Aerodrome 报价
  2. 02返回价格影响和最低到账量
  3. 03显示兑换路径和预估 Gas 费用
  4. 04提供 GET 和 POST 报价接口
  5. 05使用 USDC 按次进行 x402 支付

适用场景

  1. 01兑换代币前比较 DEX 报价
  2. 02交易前查看价格影响和滑点

MCP 相关

通过远程 MCP 端点向 MCP 客户端提供 dex_get_swap_quote 工具。调用采用 x402 方式按次支付 Base 上的 USDC。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://dex-quotes.api.klymax402.com/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

DEX Swap Quotes API

MCP Server x402 License: MIT

获取 Uniswap、SushiSwap、Aerodrome 上的最佳兑换报价,包括价格影响、路径和滑点。交易前必备。通过 x402 按次付费(在 Base L2 上使用 USDC)——无需 API 密钥、无需注册,也没有速率限制墙。

属于 klymax402 市场的一部分——面向 AI Agent 的 100 个 x402 小额支付 API,只需一个钱包,即可在 Base 上使用 USDC。

快速开始——MCP

添加到 MCP 客户端配置中(Claude Desktop、Cursor、ElizaOS 等):

{
  "mcpServers": {
    "dex-quotes": {
      "url": "https://dex-quotes.api.klymax402.com/mcp"
    }
  }
}

快速开始——HTTP(x402)

curl "https://dex-quotes.api.klymax402.com/api/quote?tokenIn=...&tokenOut=...&amount=..."
# -> 402 Payment Required, with an x402 payment challenge in the response body

任何支持 x402 的客户端(@x402/fetch、x402-agent-tools、ATXP)都会自动处理 402 -> 签名 -> 重试流程。

工具

工具方法路径价格说明
dex_get_swap_quoteGET/api/quote$0.012获取多个 DEX 上的最佳兑换报价
dex_get_swap_quotePOST/api/quote$0.012获取多个 DEX 上的最佳兑换报价(POST 变体)
dex_get_swap_quote

在链上交易代币前需要兑换报价时使用。以 JSON 格式返回多个 DEX 上的最佳价格。

参数

名称类型必填说明
tokenInstring是输入代币的合约地址(例如,Base 上 USDC 的地址为 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
tokenOutstring是输出代币的合约地址(例如,Base 上 WETH 的地址为 0x4200000000000000000000000000000000000006)
amountstring是输入代币的原始单位数量(wei/最小单位,例如,1000000 代表 1 USDC)
chainstring否区块链网络:base 或 ethereum(默认:base)

返回值

  • bestDex —— 提供最佳汇率的 DEX(Uniswap、SushiSwap、Aerodrome)
  • amountOut —— 预期输出的代币数量
  • priceImpact —— 此次交易的价格影响百分比
  • minimumReceived —— 考虑滑点容差后的最小输出量
  • route —— 兑换路径(例如,USDC -> WETH -> TOKEN)
  • gasEstimateUsd —— 预估 Gas 费用(美元)

示例响应:

{"bestDex":"Uniswap V3","amountOut":"0.3215","priceImpact":"0.12%","minimumReceived":"0.3183","route":["USDC","WETH"],"gasEstimateUsd":0.04}

适用场景:执行任何代币兑换,以查找最佳汇率并估算滑点。是确定交易规模和比较 DEX 的必备工具。

不适用场景:仅估算 Gas 费用(使用 gas_get_current_price)、查找收益机会(使用 defi_find_best_yields)、查询钱包余额(使用 wallet_get_portfolio)。

dex_get_swap_quote

在链上交易代币前需要获取兑换报价时使用。以 JSON 格式返回多个 DEX 中的最优价格。dex_get_swap_quote 的 POST 变体——参数通过 JSON 请求体传递,而非查询字符串。

参数

名称类型必填说明
tokenInstring是输入代币的合约地址(例如,Base 上 USDC 的地址为 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
tokenOutstring是输出代币的合约地址(例如,Base 上 WETH 的地址为 0x4200000000000000000000000000000000000006)
amountstring是输入代币的原始单位数量(wei/最小单位,例如 1 USDC 为 1000000)
chainstring否区块链网络:base 或 ethereum(默认值:base)

返回值

  • bestDex -- 提供最优汇率的 DEX(Uniswap、SushiSwap、Aerodrome)
  • amountOut -- 预期的输出代币数量
  • priceImpact -- 此笔交易的价格影响百分比
  • minimumReceived -- 扣除滑点容差后的最低输出量
  • route -- 兑换路径(例如 USDC -> WETH -> TOKEN)
  • gasEstimateUsd -- 预估 Gas 费用(美元)

响应示例:

{"bestDex":"Uniswap V3","amountOut":"0.3215","priceImpact":"0.12%","minimumReceived":"0.3183","route":["USDC","WETH"],"gasEstimateUsd":0.04}

适用场景:执行任何代币兑换,以查找最优汇率并估算滑点。对于确定交易规模和比较 DEX 至关重要。

不适用于:仅估算 Gas 费用(使用 gas_get_current_price)、查找收益机会(使用 defi_find_best_yields)、查询钱包余额(使用 wallet_get_portfolio)。

Agent 提示词示例

  • “在链上交易代币前获取兑换报价”
  • “在链上交易代币前获取兑换报价”

付款

  • 协议:x402 -- 原生支持 HTTP 的按次付费,无需注册或 API 密钥
  • 网络:Base L2(eip155:8453)
  • 资产:USDC
  • 结算服务商:Coinbase CDP(主要)、PayAI(备用)
  • 也可通过 ATXP 访问(采用 OAuth 封装的 x402,受 RFC 9728 受保护资源元数据保护)

属于 klymax402

面向 AI Agent 的 100 个 x402 微支付 API——一个钱包、Base 上的 USDC、无需注册。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。