openocean

OpenOcean DEX aggregator. Best swap rates across 25+ blockchains with cross-chain support.

Quality

60%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./public/skills/0xterrybit/openocean/SKILL.md

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

ALWAYS display swap details before execution
WARN if price impact > 1%
CHECK token allowance before swap
VERIFY cross-chain destination address
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