| name | OpenOcean |
| description | OpenOcean-skills is a skill package for interacting with the OpenOcean Aggregator API. Use it to get swap quotes, build swap transactions, execute swaps, and troubleshoot OpenOcean workflows across 40+ chains, including EVM, Solana, and Sui. |
| metadata | {"tags":["openocean-skills","openocean","defi","dex-aggregator","swap","quote","transaction-build","swap-execution","evm","solana","sui"],"provider":"OpenOcean","homepage":"https://openocean.finance"} |
OpenOcean Skills
Skills for interacting with the OpenOcean Aggregator API. Fetch swap quotes, build transaction calldata, and execute swaps across 40+ chains (EVM, Solana, Sui).
Entry Point and Sub-Skills
This skill package is the entry point. Detailed workflows live in the following files under skills/:
| User intent | Skill file | When to use |
|---|
| Get quote / check price | skills/quote/SKILL.md | "get a swap quote", "check swap price", "how much would I get for" |
| Build transaction | skills/swap-build/SKILL.md | "build a swap", "prepare swap transaction", "get swap calldata" |
| Execute (with confirmation) | skills/swap-execute/SKILL.md | "execute swap", "broadcast swap", "send transaction" |
| Execute fast (no confirmation) | skills/swap-execute-fast/SKILL.md | "swap fast", "execute immediately" — use with extreme caution |
| Errors and troubleshooting | skills/error-handling/SKILL.md | API errors, token resolution failures, execution failures |
Reference files (read before calling APIs):
references/token-registry.md — Token addresses and decimals per chainreferences/api-reference.md — OpenOcean API specification
All paths above are relative to the workspace root (the directory that contains this SKILL.md).
Path resolution rule (strict, to avoid noisy "file not found" errors):
- Always run glob discovery first:
**/token-registry.md**/api-reference.md
- If a unique match is found, read that matched path directly.
- Do not attempt to read hardcoded
references/... paths before glob.
- Only report an error if no match is found (or multiple ambiguous matches are found).
Prerequisites
- Quote / Build: Only need GET request capability (e.g.
mcp_web_fetch).
- Execute: Require Foundry (
cast), RPC URL, and wallet (env, Ledger, Trezor, or keystore).
Quick Examples
/quote 1 ETH to USDC on ethereum
/swap-build 100 USDC to ETH on arbitrum from 0xYourAddress
/swap-execute
For full workflows, confirmation prompts, and error handling, follow the corresponding skills/*/SKILL.md file.
