DEX API
使用 iFrame

使用 iFrame#

步骤一:申请域名白名单#

为防止跨域攻击,保证用户资产安全,DEX iFrame 的使用者均需在接入前向欧易 DEX 提交申请,将使用方域名加入白名单。

请发送域名白名单申请邮件至 dex@okx.com,我们将在 1-3 个工作日内给予回复。

步骤二:接入 iFrame#

代码示例#

  1. 兑换

兑换:将 Ethereum 网络中的 ETH 兑换为 USDT。

<iframe
  src="https://www.okx.com/web3/dex-swap#inputChain=1&inputCurrency=ETH&outputChain=1&outputCurrency=0xdac17f958d2ee523a2206206994597c13d831ec7"
/>

分佣兑换:将 Ethereum 网络中的 ETH 兑换为 USDT 时,1% 的 ETH 数量将被发送到 referrerAddress,其余 99% 的 ETH 数量将执行兑换。

<iframe
    src="https://www.okx.com/web3/dex-swap?inputChain=1&inputCurrency=ETH&outputChain=1&outputCurrency=0xdac17f958d2ee523a2206206994597c13d831ec7&referrerAddress=0x6f9ffea7370310cd0f890dfde5e0e061059dcfd9&feePercent=1"
/>
  1. 跨链兑换

将 Ethereum 网络中的 USDT 兑换为 Arbitrum 网络中的 USDT。

<iframe
   src="https://www.okx.com/web3/dex-swap#inputChain=1&inputCurrency=0xdac17f958d2ee523a2206206994597c13d831ec7&outputChain=42161&outputCurrency=0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9"
/>
  1. 限价单

使用欧易 DEX 限价单功能,在 Ethereum 网络中进行限价挂单,将 WETH 兑换为 USDC。

<iframe
   src="https://www.okx.com/web3/dex-swap/limit#inputLimitChain=1&inputLimitCurrency=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&outputLimitChain=1&outputLimitCurrency=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
/>

参数#

参数描述
inputChain询价币种所属链的链 ID (如1: Ethereum,更多可查看数据字典)
inputCurrency询价币种合约地址 (如 0xdac17f958d2ee523a2206206994597c13d831ec7
如币种为当前链的主网币,则使用币种 symbol(如ETH,更多币种 symbol 可查看数据字典
outputChain目标币种所属链的链 ID (如1: Ethereum,更多可查看数据字典)
outputCurrency目标币种合约地址 (如 0xa892e1fef8b31acc44ce78e7db0a2dc610f92d00
如币种为当前链的主网币,则使用币种 symbol(如ETH,更多币种 symbol 可查看数据字典)
referrerAddress分佣地址 (如 0x6f9ffea7370310cd0f890dfde5e0e061059dcfd9) (可选)
feePercent发送到分佣地址的询价币种数量百分比 最小百分比:0 最大百分比:3 (可选)
如同时设定 referrerAddress 和 feePercent,分佣百分比的询价币种数量将发送至分佣地址,其余币种数量将进行兑换 (注:跨链、限价单交易无法使用分佣功能)
inputLimitChain限价单卖出币种所属链的链 ID (如1: Ethereum,更多可查看数据字典)
限价单仅支持在 Ethereum、BNB Chain、OKTC、Polygon、Avalanche C、Fantom、Arbitrum、Optimism 链上交易。
inputLimitCurrency限价单卖出币种的合约地址 (如 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2)
outputLimitChain限价单买入币种所属链的链 ID (如1: Ethereum,更多可查看数据字典)
限价单仅支持在 Ethereum、BNB Chain、OKTC、Polygon、Avalanche C、Fantom、Arbitrum、Optimism 链上交易。
outputLimitCurrency限价单买入币种的合约地址 (如 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48)
限价单不支持使用主网币交易。

数据字典#

链 ID主网币 symbol
Ethereum1ETH
zkSync Era324ERA_ETH
Optimism10OP_ETH
Polygon137MATIC
OKTC66OKT
Avalanche C43114AVAX
Fantom250FTM
Arbitrum42161ARB_ETH
Linea59144LINEA_ETH
Conflux eSpace1030CFX
Base8453BASE_ETH
Mantle5000MNT
Scroll534352SCROLL_ETH
Polygon zkEVM1101POLYGON_ETH
Ethereum PoW10001ETHW
Stacks5757STX
Solana501SOL
Cronos25CRO
Tron195TRON
SUI784SUI
Starknet9004STARKNET_ETH
Aptos637APT