# Openocean

> OpenOcean DEX aggregator: quote and execute swaps with balance-delta verification. Use when comparing routes or executing a swap via OpenOcean (e.g. quote DAI→USDC, swap with slippage check, verify post-trade balance).

- Skill: `starchild-ai-agent/openocean` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds add starchild-ai-agent/openocean`
- Raw SKILL.md: https://api.skillmd.com/api/skills/starchild-ai-agent/openocean/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: starchild-ai-agent (https://skillmd.com/u/starchild-ai-agent)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/starchild-ai-agent/openocean

---


# OpenOcean Skill (Starchild Adapter)

Use this skill when user asks to:
- get OpenOcean quote
- execute swap via OpenOcean route
- run OpenOcean trade through Starchild wallet

## Runtime Mode

Script-only. Does not register tools.

Imports:
`from skills.openocean.exports import openocean_gas_price, openocean_quote, openocean_swap`

## Functions

- `openocean_gas_price(chain='ethereum')`
- `openocean_quote(chain, in_token, out_token, amount_wei, slippage='1')`
- `openocean_swap(chain, in_token, out_token, amount_wei, slippage='1', verify_timeout_seconds=90, poll_interval_seconds=5)`

## Current Scope

- Ethereum mainnet execution path tested (ETH -> ERC20 and ERC20 -> ETH)
- Uses Starchild wallet runtime (`/agent/transfer`) to broadcast
- Built-in ERC20 approval flow (checks allowance and sends approve when needed)
- Verifies result by balance delta (works when tx hash is delayed)

## Safety Checklist

1. First call `openocean_quote` and show output.
2. Confirm amount and slippage with user.
3. Execute with small amount first.
4. Require verification result (`verified_by_balance_delta=true`) before claiming success.