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

```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="<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

```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)