Choose Your Integration Path
Houdini offers three types of swaps, each optimized for different use cases. Select the integration guide that matches your needs:Private Swaps
Multi-hop CEX routing for maximum privacy
- 15-45 minute completion
- No wallet connection needed
- Maximum transaction privacy
- Best for: Privacy-focused applications
Standard Swaps
Fast single-hop CEX swaps
- 3-30 minute completion
- No wallet connection needed
- Good privacy with speed
- Best for: Faster execution needs
DEX Swaps
On-chain decentralized swaps
- Seconds to minutes
- Wallet connection required
- Fully transparent on-chain
- Best for: DeFi applications
Integration Overview
All swap flows follow a similar pattern:
All swap types share the same
/quotes and /exchanges endpoints — the type field on each quote determines the routing. Follow the detailed guide for your chosen integration path.
Quick Reference
Endpoints by Swap Type
In API v2, all swap types share the same/quotes and /exchanges endpoints. Use the types parameter to filter which quote types are returned.
| Swap Type | Tokens Endpoint | Quote Endpoint | Execute Endpoint |
|---|---|---|---|
| Standard | /v2/tokens?hasCex=true | /quotes?types=standard | /exchanges |
| Private | /v2/tokens?hasCex=true | /quotes?types=private | /exchanges |
| DEX | /v2/tokens?hasDex=true | /quotes?types=dex | /exchanges |
Omit
types to receive all available quote types in a single response. Filter by types field on each quote object to select the one you want.What You’ll Need
Before starting any integration:API Credentials
Get your API key and secret from the Houdini team
Required Headers
All requests need:
Authorization: {key}:{secret}x-user-ip: {user_ip}x-user-agent: {user_agent}x-user-timezone: {timezone}
Complete Code Examples
Ready-to-run Next.js examples for all swap types:GitHub: houdini-nextjs-example
Complete, runnable Next.js examples for Private, Standard, and DEX swaps