A specialized skill for fetching real-time, optimized cryptocurrency swap quotes across multiple blockchain networks using the OKX DEX Aggregator API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install dex-quote
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install dex-quote using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OKX DEX Aggregator Quote?
This skill enables developers and AI agents to programmatically access the OKX DEX Aggregator API v6 to find the best trading prices across hundreds of liquidity sources. By integrating this into Openclaw Skills, users can automate the complex process of cross-chain price discovery, handling everything from HMAC-SHA256 authentication to precise token decimal conversions. It acts as a bridge to the OKX Web3 ecosystem, providing high-fidelity data for Ethereum, Solana, BSC, and over 20 other chains.
Beyond simple price fetching, the skill emphasizes security and transparency. It automatically retrieves detailed routing paths, estimates gas fees in USD, and monitors for security risks like honeypots or high buy/sell taxes. This ensures that any application or agent powered by these Openclaw Skills can execute informed and safe decentralized finance operations.
OKX DEX Aggregator Quote Use Cases
- Comparing real-time token swap rates across different liquidity pools and blockchain networks.
- Building automated trading scripts that require precise gas estimates and price impact analysis.
- Screening tokens for security risks such as honeypot flags before performing a trade.
- Integrating professional-grade DEX routing into custom DeFi dashboards or AI-driven portfolios.
How OKX DEX Aggregator Quote Works
- Validate the user's input parameters including the Chain ID, token contract addresses, and the intended trade volume.
- Convert human-readable token amounts into raw units based on specific token decimals to ensure precision.
- Construct a secure request by generating a timestamped HMAC-SHA256 signature using provided API credentials.
- Execute an authenticated GET request to the OKX Web3 API aggregator endpoint.
- Process the JSON response to extract the best output amount, routing logic, and security metadata.
- Format the findings into a developer-friendly summary with exchange rates, gas costs, and safety warnings.
OKX DEX Aggregator Quote Setup
To use this skill with Openclaw Skills, you must first obtain API credentials from the OKX Web3 Developer portal.
- Set your environment variables:
export OKX_ACCESS_KEY='your_api_key'
export OKX_SECRET_KEY='your_secret_key'
export OKX_PASSPHRASE='your_passphrase'
- Ensure your development environment has the necessary dependencies (e.g.,
requestsfor Python oraxiosfor Node.js). - Use the provided chainIndex IDs (e.g., 1 for Ethereum, 501 for Solana) to route requests correctly.
OKX DEX Aggregator Quote Data Schema & Taxonomy
The skill interacts with the OKX DEX Aggregator schema, organizing data as follows:
| Parameter | Description |
|---|---|
chainIndex |
The unique identifier for the blockchain (e.g., 1, 56, 137). |
toTokenAmount |
The raw amount of tokens to be received after the swap. |
priceImpactPercent |
The estimated loss in value due to pool liquidity constraints. |
dexRouterList |
An array detailing the specific DEX protocols used for the trade route. |
isHoneyPot |
A safety flag indicating if the token is a known scam contract. |
tradeFee |
The estimated network gas fee represented in USD. |
OKX DEX Aggregator Quote Advanced Features
- Multi-chain support covering 20+ EVM-compatible networks and Solana.
- Advanced security filtering including honeypot detection and token tax rate monitoring.
- Support for
exactInandexactOutswap modes for flexible trade execution. - Customizable
feePercentparameters allowing integrators to include their own commission logic. - Detailed price impact protection settings to prevent high-slippage trades in volatile markets.
SKILL.md
Loading
Related Openclaw Skills
OpenBot ClawHub
A specialized skill for OpenClaw agents to inhabit and interact within a persistent 3D ocean-floor social environment as autonomous AI lobsters.
Soul Digital Identity
A sophisticated framework for AI agents to adopt and maintain consistent digital identities, worldviews, and writing styles.
Iterative Code Evolution
A systematic framework for evolving code quality through disciplined analysis-mutation-evaluation loops.
Aave Credit Delegation Skill
A sophisticated tool that allows AI agents to autonomously borrow and repay funds on Aave V2/V3 by utilizing credit delegated from a primary wallet.
OKX DEX Swap & Broadcast
A comprehensive tool for executing end-to-end on-chain token swaps with MEV protection and automated slippage via the OKX DEX Aggregator.
Apple Media Control
A comprehensive command-line integration for managing Apple TV, HomePod, and AirPlay devices using the pyatv library.
Featured*
