Usage Guidelines
- Returns metadata for all supported decentralized exchanges across all networks
- Each exchange includes
address,name,networkId, and optional branding info (iconUrl,color,tradeUrl) - Use
exchangeVersionto distinguish between different versions of the same protocol (e.g., Raydium V4, Uniswap V2 vs V3) - The
idfield combinesaddress:networkIdfor unique identification - Set
showNameless: trueto include exchanges with incomplete metadata (missing name or icon) - Use this query to populate exchange filters or display exchange logos in your UI
Troubleshooting Tips
How do I filter exchanges by network?
How do I filter exchanges by network?
getExchanges returns all exchanges across all networks. Filter the results client-side by networkId to get exchanges for a specific chain. For example, filter by networkId: 1399811149 for Solana exchanges only.What is the exchangeVersion field?
What is the exchangeVersion field?
exchangeVersion indicates the protocol version or variant. For example, Raydium has V4, CPMM, and CLMM versions. Orca has Whirlpool. Uniswap has V2 and V3. This helps distinguish pools with different mechanics on the same protocol.Why are some fields null?
Why are some fields null?
Not all exchanges have complete metadata. Fields like
iconUrl, color, tradeUrl, and even name may be null for newer or less common exchanges. By default, showNameless: false filters out exchanges missing key fields.How do I match an exchange to a pair?
How do I match an exchange to a pair?
Pairs include an
exchangeHash field that corresponds to the exchange’s address. Use getExchanges to build a lookup table mapping exchange addresses to their metadata (name, icon, etc.).