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.
1---2name: openocean3description: 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.4---56# OpenOcean Skills78Skills for interacting with the [OpenOcean Aggregator API](https://apis.openocean.finance/). Fetch swap quotes, build transaction calldata, and execute swaps across 40+ chains (EVM, Solana, Sui).910## Entry Point and Sub-Skills1112This skill package is the **entry point**. Detailed workflows live in the following files under `skills/`:1314| User intent | Skill file | When to use |15|-------------|------------|-------------|16| Get quote / check price | `skills/quote/SKILL.md` | "get a swap quote", "check swap price", "how much would I get for" |17| Build transaction | `skills/swap-build/SKILL.md` | "build a swap", "prepare swap transaction", "get swap calldata" |18| Execute (with confirmation) | `skills/swap-execute/SKILL.md` | "execute swap", "broadcast swap", "send transaction" |19| Execute fast (no confirmation) | `skills/swap-execute-fast/SKILL.md` | "swap fast", "execute immediately" — use with extreme caution |20| Errors and troubleshooting | `skills/error-handling/SKILL.md` | API errors, token resolution failures, execution failures |2122**Reference files** (read before calling APIs):2324- `references/token-registry.md` — Token addresses and decimals per chain25- `references/api-reference.md` — OpenOcean API specification2627All paths above are relative to the **workspace root** (the directory that contains this `SKILL.md`).2829Path resolution rule (strict, to avoid noisy "file not found" errors):301. **Always run glob discovery first**:31 - `**/token-registry.md`32 - `**/api-reference.md`332. If a unique match is found, read that matched path directly.343. Do not attempt to read hardcoded `references/...` paths before glob.354. Only report an error if no match is found (or multiple ambiguous matches are found).3637## Prerequisites3839- **Quote / Build**: Only need GET request capability (e.g. `mcp_web_fetch`).40- **Execute**: Require [Foundry](https://getfoundry.sh/) (`cast`), RPC URL, and wallet (env, Ledger, Trezor, or keystore).4142## Quick Examples4344```45/quote 1 ETH to USDC on ethereum46/swap-build 100 USDC to ETH on arbitrum from 0xYourAddress47/swap-execute48```4950For full workflows, confirmation prompts, and error handling, follow the corresponding `skills/*/SKILL.md` file.
openocean-finance