SuperAPI AI 工具集

1inch-orderbook

智能体与模型

查看项目

更新于 10-13 14:31

技能介绍

1inch Orderbook(限价订单)

用途 用于通过 1inch MCP 的已认证工具 orderbook 操作限价订单(Limit Order Protocol v4.1)。适用场景为用户希望按目标价格买入或卖出资产,或需要查询、取消自己的限价订单。

主要能力 orderbook 工具的必需字段为 action,取值为 build、create、list、cancel。

  • build:服务端返回 EIP-712 typedData、orderHash、orderData。金额使用最小单位;资产可填写地址或符号。
  • create:提交 orderHash、signature、orderData。
  • list:listMode 支持 by_maker、by_hash、all。
  • cancel:加载链上取消指引(不通过 HTTP 取消)。 签名使用 eth_signTypedData_v4,由 maker 钱包完成。

使用方式 使用前需先调用 authenticate;如果尚未成为真实用户(initialize 返回 200 仍为匿名),需先认证。 推荐流程:先连接用户钱包(WalletConnect)。除非用户希望用自有工具签名,否则在 build 之前提供 WalletConnect:通过 walletconnect 工具配对(参见 1inch-walletconnect 技能),然后以 action: "build" 调用 orderbook。会话激活后 execute 默认为 true,工具会一步完成 EIP-712 类型数据签名并通过已连接钱包提交订单(必要时包含一次性 approve 交易),用户只需在钱包应用中批准提示。 若设置 execute: false,则返回类型数据以便在其他地方签名。

手动流程(无钱包会话)

  1. build:服务器返回 EIP-712 typedData、orderHash、orderData。
  2. sign:使用 eth_signTypedData_v4,由 maker 钱包签名。
  3. create:提交 orderHash、signature、orderData。
  4. list:listMode 为 by_maker、by_hash 或 all。
  5. cancel:加载链上取消指引(无 HTTP 取消)。 如果 build 返回授权区块,需先广播 approveTx(使用原生 gas),再进行签名。

适用场景与示例提示

  • "在以太坊上构建一个卖出 1 WETH 换取 USDC 的限价订单"
  • "列出 0x… 的未结限价订单"

限制与补充 不通过 HTTP 方式取消订单,取消需依据链上取消指引。其余参数、授权与 gas、列表模式、链 ID 等完整说明参见 references/WORKFLOW.md;对于可读取资源的客户端,同一内容以 MCP 资源 file://1inch-mcp/guides/orderbook-workflow 实时提供。