OpenOcean

🛠 Connector Info

• Exchange Type: Decentralized Exchange (DEX)
• Market Type: Automatic Market Maker (AMM)
• Maintenance Tier:
• Maintainer:

Currently, OpenOcean is a Bronze exchange, as voted by HBOT holders in each quarterly Epoch. This means Hummingbot Foundation does not maintain the components below, but community members may submit Proposals to fund development bounties and approve pull requests to fix bugs and add enhancements to them.

Component	Status	Notes
2️⃣ AMM Connector	✅
3️⃣ Range AMM Connector	Not built
🕯 AMM Data Feed	✅

ℹ️ Exchange Info

• Website: https://openocean.finance
• CoinMarketCap: https://coinmarketcap.com/exchanges/openocean/
• CoinGecko: https://www.coingecko.com/en/exchanges/openocean_finance
• Fees: https://docs.openocean.finance/protocol/introduction/fees-overview

🔑 How to Connect

Create a wallet on one of the supported networks below:

Chain	Networks
avalanche	avalanche
ethereum	mainnet
polygon	mainnet
harmony	mainnet
binance smart chain	mainnet
cronos	mainnet

From inside the Hummingbot client, run gateway connect openocean in order to connect your wallet:

Which chain do you want openocean to connect to? (avalanche, ethereum, polygon, harmony) >>>
Which network do you want openocean to connect to? (mainnet) >>>
Enter your polygon-mainnet private key >>>>

If connection is successful:

The openocean connector now uses wallet [pubKey] on polygon-mainnet

2️⃣ AMM Connector

Integration to this DEX's swap pricing and execution endpoints

• ID: openocean
• Connection Type: REST via Gateway
• API Docs: https://openocean.finance/api/api-sdk/
• Folder: https://github.com/hummingbot/gateway/tree/main/src/connectors/openocean
• Default Configs: https://github.com/hummingbot/gateway/blob/main/src/templates/openocean.yml

Endpoints

• /amm/price
• /amm/trade

For more info, run Gateway and go to in your browser to see detailed documentation for each endpoint.

🕯 AMM Data Feed

Data feed of this exchange's real-time prices

• ID: openocean_[CHAIN]_[NETWORK]
• Connection Type: REST via Gateway
• Folder: https://github.com/hummingbot/hummingbot/blob/master/hummingbot/data_feed/amm_gateway_data_feed.py

Usage

from hummingbot.data_feed.amm_gateway_data_feed import AmmGatewayDataFeed
prices = AmmGatewayDataFeed(
        connector_chain_network="openocean_avalanche_avalanche",
        trading_pairs={"USDC-DAI", "USDC-ETH"},
        order_amount_in_base=Decimal("1"),
    )