> ## Documentation Index
> Fetch the complete documentation index at: https://docs.houdini.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Jump straight into integrating the swap type you need

## Choose Your Integration Path

Houdini offers multiple swap types, each optimized for different use cases. Select the integration guide that matches your needs:

> [card] [Private Swap](https://docs.houdini.com/developer-hub/swap-flows/private-swap.md)
>
> **Multi-hop CEX routing for maximum privacy**
>
> * 15-45 minute completion
> * No wallet connection needed
> * Maximum transaction privacy
> * Best for: Privacy-focused applications

> [card] [Standard Swap](https://docs.houdini.com/developer-hub/swap-flows/standard-swap.md)
>
> **Fast single-hop CEX swaps**
>
> * 3-30 minute completion
> * No wallet connection needed
> * Good privacy with speed
> * Best for: Faster execution needs

> [card] [Fixed Rate & Reverse Quote](https://docs.houdini.com/developer-hub/swap-flows/fixed-rate-swap.md)
>
> **Guaranteed output — rate locked at quote time**
>
> * 3-30 minute completion
> * No wallet connection needed
> * Price certainty regardless of market movement
> * Best for: High-value swaps, price-sensitive users

> [card] [DEX Swap](https://docs.houdini.com/developer-hub/swap-flows/dex-swap.md)
>
> **On-chain decentralized swaps**
>
> * Seconds to minutes
> * Wallet connection required
> * Fully transparent on-chain
> * Best for: DeFi applications

> [card] [Split](https://docs.houdini.com/developer-hub/swap-flows/split.md)
>
> **Batch multiple orders in one request**
>
> * CEX and anonymous routing
> * All orders tracked under one `multiId`
> * Solana batch transaction support
> * Best for: Payouts, airdrops, bulk distributions

## 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 Type | Tokens Endpoint | Quote Endpoint | Execute Endpoint |
| - | - | - | - |
| **Standard** | `/v2/tokens?hasCex=true` | `/quotes?types=standard` | `/exchanges` |
| **Fixed Rate** | `/v2/tokens?hasCex=true` | `/quotes?fixed=true` | `/exchanges` (requires `refundAddress`) |
| **Private** | `/v2/tokens?hasCex=true` | `/quotes?types=private` | `/exchanges` |
| **Private with on-chain hop** | `/v2/tokens?hasCex=true` | `/quotes?types=private` | `/exchanges` (requires `intermediateRefundAddress`) — see [guide](https://docs.houdini.com/developer-hub/swap-flows/private-onchain-hop.md) |
| **DEX** | `/v2/tokens?hasDex=true` | `/quotes?types=dex` | `/exchanges` |
| **Split** | `/v2/tokens?hasCex=true` | — | `/exchanges/multi` |

> [!NOTE]
>
> 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:

> [card] API Credentials
>
> Get your API key and secret from the Houdini team

> [card] 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:

> [card] [GitHub: houdini-nextjs-example](https://github.com/HoudiniSwap/houdini-api-examples/tree/main/nextjs-example)
>
> Complete, runnable Next.js examples for Private, Standard, and DEX swaps

## Additional Resources

> [card] [Tokens & Networks](https://docs.houdini.com/developer-hub/core-concepts/tokens-networks.md)
>
> Token identifiers and network support

> [card] [Order Lifecycle](https://docs.houdini.com/developer-hub/core-concepts/order-lifecycle.md)
>
> Status codes and swap state management

> [card] [Routing Types](https://docs.houdini.com/developer-hub/core-concepts/routing-types.md)
>
> Deep dive into each routing strategy

> [card] [API v2 Reference](https://docs.houdini.com/api-reference)
>
> Complete API endpoint documentation


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.