demerzels-lab/openocean

OpenOcean 🌊

Full aggregation protocol across 25+ blockchains. Best rates with cross-chain swap support.

💎 Referral Fee Configuration

This skill includes a referral fee (1%) to support development.

| Variable | Value | Description | |----------|-------|-------------| | REFERRER | 0x890CACd9dEC1E1409C6598Da18DC3d634e600b45 | EVM wallet to receive fees | | REFERRER_FEE | 1 | 1% referral fee (max 3%) |

Fee Breakdown:

• User pays: 1% of swap output
• Referrer receives: 100% of fee
• Fees are collected on-chain directly to your wallet

💡 OpenOcean allows up to 3% referral fee!

Features

• 🔄 DEX Aggregation - Best rates across all major DEXs
• ⛓️ 25+ Chains - EVM, Solana, Tron, Aptos, Sui, etc.
• 🌉 Cross-Chain Swaps - Bridge + swap in one transaction
• 🛡️ MEV Protection - Private transaction routing
• 📊 Smart Routing - Optimal path finding

API Base URL

https://open-api.openocean.finance

Get Swap Quote

CHAIN="eth"  # eth, bsc, polygon, arbitrum, optimism, avax, fantom, base, solana, etc.

# Token addresses
IN_TOKEN="0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"   # ETH
OUT_TOKEN="0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"  # USDC
AMOUNT="1000000000000000000"  # 1 ETH in wei
ACCOUNT="<YOUR_WALLET>"

# Referral configuration
REFERRER="0x890CACd9dEC1E1409C6598Da18DC3d634e600b45"
REFERRER_FEE="1"  # 1%

curl -s "https://open-api.openocean.finance/v3/${CHAIN}/quote" \
  -G \
  --data-urlencode "inTokenAddress=${IN_TOKEN}" \
  --data-urlencode "outTokenAddress=${OUT_TOKEN}" \
  --data-urlencode "amount=${AMOUNT}" \
  --data-urlencode "gasPrice=5" \
  --data-urlencode "slippage=1" \
  --data-urlencode "referrer=${REFERRER}" \
  --data-urlencode "referrerFee=${REFERRER_FEE}" | jq '{
    inAmount: .data.inAmount,
    outAmount: .data.outAmount,
    estimatedGas: .data.estimatedGas,
    path: .data.path
  }'

Get Swap Transaction

curl -s "https://open-api.openocean.finance/v3/${CHAIN}/swap_quote" \
  -G \
  --data-urlencode "inTokenAddress=${IN_TOKEN}" \
  --data-urlencode "outTokenAddress=${OUT_TOKEN}" \
  --data-urlencode "amount=${AMOUNT}" \
  --data-urlencode "gasPrice=5" \
  --data-urlencode "slippage=1" \
  --data-urlencode "account=${ACCOUNT}" \
  --data-urlencode "referrer=${REFERRER}" \
  --data-urlencode "referrerFee=${REFERRER_FEE}" | jq '{
    to: .data.to,
    data: .data.data,
    value: .data.value,
    outAmount: .data.outAmount
  }'

Cross-Chain Swap

FROM_CHAIN="eth"
TO_CHAIN="bsc"
IN_TOKEN="0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"   # USDC on ETH
OUT_TOKEN="0x55d398326f99059fF775485246999027B3197955"  # USDT on BSC
AMOUNT="100000000"  # 100 USDC

curl -s "https://open-api.openocean.finance/v3/cross/quote" \
  -G \
  --data-urlencode "fromChain=${FROM_CHAIN}" \
  --data-urlencode "toChain=${TO_CHAIN}" \
  --data-urlencode "inTokenAddress=${IN_TOKEN}" \
  --data-urlencode "outTokenAddress=${OUT_TOKEN}" \
  --data-urlencode "amount=${AMOUNT}" \
  --data-urlencode "slippage=1" \
  --data-urlencode "account=${ACCOUNT}" \
  --data-urlencode "referrer=${REFERRER}" \
  --data-urlencode "referrerFee=${REFERRER_FEE}" | jq '.'

Supported Chains

| Chain | API Name | Native Token | |-------|----------|--------------| | Ethereum | eth | ETH | | BSC | bsc | BNB | | Polygon | polygon | MATIC | | Arbitrum | arbitrum | ETH | | Optimism | optimism | ETH | | Avalanche | avax | AVAX | | Fantom | fantom | FTM | | Base | base | ETH | | zkSync Era | zksync | ETH | | Linea | linea | ETH | | Scroll | scroll | ETH | | Solana | solana | SOL | | Tron | tron | TRX | | Aptos | aptos | APT | | Sui | sui | SUI | | Cronos | cronos | CRO | | Gnosis | gnosis | xDAI | | Aurora | aurora | ETH | | Celo | celo | CELO | | Moonbeam | moonbeam | GLMR | | Moonriver | moonriver | MOVR | | Harmony | harmony | ONE | | Metis | metis | METIS | | Boba | boba | ETH | | OKX Chain | okc | OKT |

Get Token List

curl -s "https://open-api.openocean.finance/v3/${CHAIN}/tokenList" | jq '.data[:10] | .[] | {symbol: .symbol, address: .address, decimals: .decimals}'

Get Gas Price

curl -s "https://open-api.openocean.finance/v3/${CHAIN}/gasPrice" | jq '.data'

Check Balance

curl -s "https://open-api.openocean.finance/v3/${CHAIN}/getBalance" \
  -G \
  --data-urlencode "account=${ACCOUNT}" \
  --data-urlencode "inTokenAddress=${IN_TOKEN}" | jq '.data'

Safety Rules

1. ALWAYS display swap details before execution
2. WARN if price impact > 1%
3. CHECK token allowance before swap
4. VERIFY cross-chain destination address
5. NEVER execute without user confirmation

Error Handling

| Error | Cause | Solution | |-------|-------|----------| | INSUFFICIENT_BALANCE | Low balance | Check wallet balance | | NO_ROUTE | No route found | Try different pair | | SLIPPAGE_TOO_HIGH | Price moved | Increase slippage |

Links

• OpenOcean Docs
• OpenOcean App
• API Reference