Agent Skills
Prerequisites
Requirements for using OpenOcean Skills.
Reference Files
Skills read references/token-registry.md and references/api-reference.md from the workspace root. Ensure these files are present.
Quote and Build Skills
quote and swap-build only require the ability to send GET requests, such as mcp_web_fetch or curl. No local installation is needed.
Execute Skills
swap-execute and swap-execute-fast require:
- Foundry (
cast) installed - RPC URL configured (
ETH_RPC_URL) - Wallet configuration (environment variables, Ledger, Trezor, or keystore)
Troubleshooting
If something goes wrong, check:
- Correct workspace with
references/folder present - API requests use integer-string
amountDecimals(no decimal point) - User-facing
slippage 100means 100 bps = 1%, while the API parameter uses percent (1= 1%) - Foundry is installed and
ETH_RPC_URLplus wallet settings are configured for on-chain execution
Rate Limits
Free tier is limited to 2 requests per second. If you receive a 429 (rate limit) or 5xx (server error) response, wait briefly before retrying and increase the wait time with each retry. For higher request volumes, please apply for an API key or Enterprise plan via our API group, submit a request form or through the developer portal.