When it comes to decentralized finance (DeFi), one of the most critical operations users perform is swapping tokens across blockchains. To ensure efficiency, accuracy, and cost-effectiveness, accessing reliable swap quotes is essential. The OKX DEX API provides developers and traders with a powerful tool to retrieve optimized swap quotes in real time — all through a simple, well-documented endpoint.
This guide dives deep into the Get Quotes functionality of the OKX DEX API, explaining how to use its parameters effectively, interpret response data, and integrate it seamlessly into DeFi applications or trading bots.
👉 Discover how to access real-time swap quotes with just one API call.
Understanding the Get Quotes Endpoint
The Get Quotes endpoint allows you to fetch the best possible quote for a token swap based on current liquidity across supported decentralized exchanges (DEXs). Whether you're building a wallet, aggregator, or automated trading system, this API ensures you get accurate pricing, fee estimates, and route details.
Before making a request, it's important to understand the required and optional parameters that shape your query.
Required Parameters
| Parameter | Type | Description |
|---|---|---|
chainIndex | String | Unique identifier for the blockchain (e.g., 1 for Ethereum). See full list here. |
amount | String | Input amount in minimal divisible units (e.g., 1 USDT = 1,000,000). Use Tokenlist to find decimals. |
swapMode | String | Either exactIn (fixed input) or exactOut (fixed output). Default: exactIn. |
fromTokenAddress | String | Contract address of the token being sold. Use 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee for native tokens like ETH. |
toTokenAddress | String | Contract address of the token being bought. |
These fields are mandatory because they define the core swap operation — what you’re trading, how much, and on which chain.
Optional Parameters for Advanced Control
| Parameter | Type | Description |
|---|---|---|
dexIds | String | Restrict quotes to specific DEXs by ID (comma-separated, e.g., 1,50,180). |
directRoute | Boolean | If true, limits routing to a single pool. Only active for Solana swaps. Default: false. |
priceImpactProtectionPercentage | String | Sets maximum allowable price impact (0–1.0). Default: 0.9. A value of 1.0 disables protection. |
feePercent | String | Referral fee percentage (max 10% on Solana, 3% on other chains). Rounded to two decimals. |
Using these options gives developers granular control over routing logic, slippage tolerance, and affiliate revenue models.
Interpreting the Response Data
Once you send a request, the API returns a comprehensive JSON response with detailed swap information.
Key Response Fields
fromTokenAmount/toTokenAmount: The actual input and output amounts in base units.tradeFee: Estimated network cost in USD.estimateGasFee: Gas consumption in smallest chain units (e.g., wei for Ethereum).router: Primary DEX used in the swap path.routerPercent: Percentage of the trade routed through this path.subRouterList: Array of secondary routes and their distribution percentages.
Each route includes protocol-level details such as:
dexProtocol: Name of the liquidity protocol (e.g., Verse).percent: Share of funds handled by that protocol.dexName: Human-readable DEX name.
👉 See how multi-protocol routing boosts your swap efficiency.
Token Metadata and Safety Checks
Security is paramount in DeFi. The OKX DEX API enhances safety by returning detailed metadata about both input and output tokens.
FromToken & ToToken Objects
Each contains:
tokenContractAddress: Verified contract address.tokenSymbol: Ticker symbol (e.g., USDT).tokenUnitPrice: Real-time USD price derived from on-chain and exchange data. (Note: May return null in edge cases.)decimal: Number of token decimals. Useful for formatting but subject to change.isHoneyPot: Boolean flag indicating if the token is a honeypot (traps users from selling).taxRate: Selling or buying tax rate (e.g., 0.05 = 5%). Returns 0 for standard tokens.
This layer of insight helps prevent scams and informs smart contract interactions — especially crucial when dealing with newer or lesser-known tokens.
Quote Comparison Across Routes
The API also returns a quoteCompareList, allowing side-by-side comparison of different swap paths:
dexName,dexLogo: Identifies each DEX.amountOut: Output amount for that route.priceImpactPercentage: Measures deviation due to pool depth:(Received Value – Paid Value) / Paid Value
A negative value indicates slippage loss; positive values may occur in rebasing or incentivized pools.
Developers can use this data to present users with multiple options or programmatically select the optimal route.
Core Keywords for SEO Optimization
To align with search intent and improve visibility, here are the core keywords naturally integrated throughout this content:
- DEX API
- Swap API
- Get Quotes
- Token Swap
- Decentralized Exchange
- API Reference
- Trade API
- Blockchain Integration
These terms reflect high-intent queries from developers and DeFi enthusiasts looking to integrate or understand cross-chain swap solutions.
Frequently Asked Questions (FAQ)
What is the difference between chainIndex and chainId?
While both identify a blockchain, chainIndex is the preferred identifier used by OKX DEX API. The chainId parameter will be deprecated soon and should not be relied upon for future integrations.
How do I convert human-readable token amounts to minimal units?
Multiply the amount by 10^decimals. For example, 1 DAI (18 decimals) = 1 * 10^18 = 1000000000000000000. You can retrieve decimal values via the Tokenlist API.
Can I prevent high slippage trades?
Yes. Use the priceImpactProtectionPercentage parameter to set a threshold. If estimated price impact exceeds your limit (e.g., 25%), the API returns an error instead of a quote.
What does isHoneyPot: true mean?
It means the token likely contains malicious code that prevents holders from selling — a common scam tactic. Avoid swapping into such tokens unless thoroughly audited.
Is there a referral program for using this API?
Yes. By setting feePercent, you can earn a commission on trades routed through your integration. Max rates are 3% on most chains and 10% on Solana.
Why does tokenUnitPrice sometimes return null?
This occurs when real-time pricing data isn't available — often due to low liquidity or newly launched tokens. Always implement fallback logic in your app.
Final Thoughts: Why Choose OKX DEX API?
The Get Quotes endpoint stands out for its robustness, security features, and developer-friendly design. With real-time pricing, multi-route comparisons, tax detection, and honeypot checks, it empowers applications to offer safer, more efficient swaps.
Whether you're building a DeFi dashboard, crypto wallet, or arbitrage bot, integrating this API streamlines access to deep liquidity across major blockchains.