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 intentSkill fileWhen to useGet quote / check priceskills/quote/SKILL.md"get a swap quote", "check swap price", "how much would I get for"Build transactionskills/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 cautionErrors and troubleshootingskills/error-handling/SKILL.mdAPI errors, token resolution failures, execution failures

Reference files (read before calling APIs):

• references/token-registry.md — Token addresses and decimals per chain
• references/api-reference.md — OpenOcean API specification

All paths above are relative to the workspace root (the directory that contains this SKILL.md).

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#

text

/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.