交易 API

做市商集成#

概览#

OKX DEX 的 RFQ 系统构建于链上,专为专业做市商设计,旨在提供高效且具有竞争力的报价。我们致力于通过链下报价和链上结算,为 DeFi 交易者提供最佳执行体验。

做市商与 OKX DEX 集成,持续提供定价数据,这些数据随后由我们的智能订单路由器进行处理,为用户带来最佳交易。

在 OKX DEX 成为做市商#

要在 OKX DEX 上成为做市商,你必须通过我们的专用 API 套件进行连接,并满足以下要求:

  • 每 10 秒实时推送一次价格水平
  • 询价响应时间低于 500 ms
  • 返回吃单者执行的签名

订单执行模式#

OKX DEX 仅支持吃单。在此类订单中,当用户收到做市商确认且可执行的报价后,将直接签名并提交交易。

吃单订单具有以下特点:

  • 做市商无需提供 Gas 费用估算
  • 报价和签名同时提交
  • 吃单负责执行

价格水平#

做市商必须至少每 10 秒向 OKX DEX 服务器发送一次针对每个代币对的价格水平。任何超过 10 秒的价格水平都将被视为过期报价,并将被忽略。

  • 报价必须是非累积式且逐级发送
  • 报价的累计价值必须超过 200 USD。否则,系统将忽略报价
  • OKX DEX 每秒都会在每条链上请求价格水平,因此必须频繁更新报价以确保响应速度和准确性

聚合和智能路由#

OKX DEX 汇聚多个挂单平台和 AMM 池的流动性,并根据最优价格和成交能力路由订单。我们的路由机制会动态地将订单拆分到各个来源,以最大限度地降低成本并提高效率。

  • 所有挂单平台的订单簿统一
  • 根据你的深度,可能会请求部分成交

授权#

OKX DEX 支持通过用户和做市商的配额进行资产转移。 我们支持两种授权方式:通过 Permit2 审批或直接审批 OKX DEX 结算合约。 做市商必须确保已向 OKX DEX 结算合约或 Permit2 合约授予足够的审批权限,以覆盖其流动性水平和提供的报价规模。

签名#

OKX DEX 在 EVM 上支持 2 种签名:

  • EIP-712
  • EIP-1271

OKX DEX 在 Solana 上仅支持 Base58 编码的签名。

交易过期时间#

我们设置了一个强制执行的交易过期时间:EVM 为 60 秒,Solana 为 40 秒。这个设置简化了集成,因为做市商无需在报价请求中指定自定义过期时间,从而在所有报价和交易中确保一致性,并在流程的不同阶段建立明确的超时边界。

做市商要求#

  1. 必须“/firm-order”可保持 200 RPS,“ /pricing”保持 50 RPS
  2. 对于 /pricing 终端,做市商必须在 10 秒内更新每个代币对的报价。我们将每秒 ping 你的终端一次。如果超过 10 秒,则相应链上该代币对的报价将被视为无效
  3. 确认订单的响应时间最佳为 200 ms 以下,最大不可超过 500 ms。任何超过此时间的响应都将被丢弃并标记为响应失败
  4. 必须保持 90% 以上的成功响应率,至少 90% 的订单在链上成功执行

结算合约地址#

const contractAddress = {
    ETH: '0xf0bc45115dd1e609aef685f828f2ace209abd0c6'
    ARB: '0x11939393f0cadfc06194ae983dafba2dcdf7308b'
    Base: '0x52bb195bc89a660073d890ff9edc6726f97a981b'
    Solana: 'RFQ1uATMXfRXemLnbYCF8JZhVfELp2K53jSEAGbsAKX'
};

Permit2 合约地址#

const contractAddress = {
    ETH: '0x000000000022D473030F116dDEE9F6B43aC78BA3'
    ARB: '0x000000000022D473030F116dDEE9F6B43aC78BA3'
    Base: '0x000000000022D473030F116dDEE9F6B43aC78BA3'
};

RFQ API 模式#

为了方便集成到 OKX DEX RFQ 模块,你需要提供一个终端,以便我们返回具有相应请求和响应格式的定价和确定订单终端。

端点方式URL描述
基本-
https://your-api-endpoint.com/OKXDEX/rfq
将注册到我们的 API 中的示例 URL。
价格水平GET
https://your-api-endpoint.com/OKXDEX/rfq/pricing
定价端点从做市商获取价格。你的级别将用于确定用户订单是否有路径。
确定订单POST
https://your-api-endpoint.com/OKXDEX/rfq/firm-order
每当交易者发出报价请求时,OKX DEX 服务器都会确定在现有做市商之间路由该 RFQ 的最佳方式。获胜的做市商会收到消息并返回订单和签名。

API 密钥#

我们需要 API 密钥才能访问你的终端。请在注册过程中提供该密钥。API 密钥将作为标头X-API-KEY传递给端点 。