CtrlK
BlogDocsLog inGet started
Tessl Logo

openocean

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

45

Quality

48%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./public/skills/0xterrybit/openocean/SKILL.md
SKILL.md
Quality
Evals
Security

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.

VariableValueDescription
REFERRER0x890CACd9dEC1E1409C6598Da18DC3d634e600b45EVM wallet to receive fees
REFERRER_FEE11% 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

ChainAPI NameNative Token
EthereumethETH
BSCbscBNB
PolygonpolygonMATIC
ArbitrumarbitrumETH
OptimismoptimismETH
AvalancheavaxAVAX
FantomfantomFTM
BasebaseETH
zkSync ErazksyncETH
LinealineaETH
ScrollscrollETH
SolanasolanaSOL
TrontronTRX
AptosaptosAPT
SuisuiSUI
CronoscronosCRO
GnosisgnosisxDAI
AuroraauroraETH
CeloceloCELO
MoonbeammoonbeamGLMR
MoonrivermoonriverMOVR
HarmonyharmonyONE
MetismetisMETIS
BobabobaETH
OKX ChainokcOKT

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

ErrorCauseSolution
INSUFFICIENT_BALANCELow balanceCheck wallet balance
NO_ROUTENo route foundTry different pair
SLIPPAGE_TOO_HIGHPrice movedIncrease slippage

Links

  • OpenOcean Docs
  • OpenOcean App
  • API Reference
Repository
Demerzels-lab/elsamultiskillagent
Path

public/skills/0xterrybit/openocean/SKILL.md

Commit

f45fcb5

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill