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=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&outputChain=1&outputCurrency=0xdac17f958d2ee523a2206206994597c13d831ec7"
/>

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

<iframe
    src="https://www.okx.com/web3/dex-swap?inputChain=1&inputCurrency=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&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
如币种为当前链的主网币,可查看数据字典获取合约地址。
outputChain目标币种所属链的链 ID (如1: Ethereum,更多可查看数据字典)
outputCurrency目标币种合约地址 (如 0xa892e1fef8b31acc44ce78e7db0a2dc610f92d00
如币种为当前链的主网币,可查看数据字典获取合约地址。
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主网币合约地址
Ethereum10xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
zkSync Era3240xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Optimism100xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Polygon1370xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
OKTC660xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Avalanche C431140xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Fantom2500xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Arbitrum421610xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Linea591440xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Conflux eSpace10300xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Base84530xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Mantle50000xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Scroll5343520xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Polygon zkEVM11010xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Ethereum PoW100010xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Stacks5757STX
Solana50111111111111111111111111111111111
Cronos250xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Tron195T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb
SUI7840x2::sui::SUI
Starknet90040x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7
Aptos6370x1::aptos_coin::AptosCoin
Metis10880xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE