Skip to main content

​
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:
1

Get Available Assets

Fetch supported tokens and networks
2

Request Quote

Get swap rates and routing information
3

Create Swap

Submit the swap order
4

Monitor Status

Track swap progress to completion
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 TypeTokens EndpointQuote EndpointExecute 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

​
Additional Resources

Tokens & Networks

Token identifiers and network support

Order Lifecycle

Status codes and swap state management

Routing Types

Deep dive into each routing strategy

API v2 Reference

Complete API endpoint documentation