--- name: openocean-22b126cb5b63 description: OpenOcean DEX aggregator. Best swap rates across 25+ blockchains with cross-chain support. metadata: {"clawdbot":{"emoji":"🌊","always":true,"requires":{"bins":["curl","jq"]}}} --- # 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 ```bash 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="" # 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 ```bash 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 ```bash 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 ```bash curl -s "https://open-api.openocean.finance/v3/${CHAIN}/tokenList" | jq '.data[:10] | .[] | {symbol: .symbol, address: .address, decimals: .decimals}' ``` ## Get Gas Price ```bash curl -s "https://open-api.openocean.finance/v3/${CHAIN}/gasPrice" | jq '.data' ``` ## Check Balance ```bash 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](https://docs.openocean.finance/) - [OpenOcean App](https://app.openocean.finance/) - [API Reference](https://docs.openocean.finance/dev/aggregator-api-and-sdk) --- Source attribution: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/0xterrybit/openocean/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 clawdbot Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/0xterrybit/openocean/SKILL.md Attribution basis: Source repository record Fields of work: Marketing, Sales Roles: Business Development, Growth Marketer, Product Marketer Specialties: API Tools: Curl, Jq Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 03c58caa86b0210aad3a29bb552d19bf2eb3eab9e5e20cf92260494e06ca3512