> ## Documentation Index
> Fetch the complete documentation index at: https://docs.houdiniswap.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:

<CardGroup cols={2}>
  <Card title="Private Swaps" icon="user-secret" href="/developer-hub/swap-flows/private-swap">
    **Multi-hop CEX routing for maximum privacy**

    * 15-45 minute completion
    * No wallet connection needed
    * Maximum transaction privacy
    * Best for: Privacy-focused applications
  </Card>

  <Card title="Standard Swaps" icon="bolt" href="/developer-hub/swap-flows/standard-swap">
    **Fast single-hop CEX swaps**

    * 3-30 minute completion
    * No wallet connection needed
    * Good privacy with speed
    * Best for: Faster execution needs
  </Card>

  <Card title="Fixed Rate Swaps" icon="lock" href="/developer-hub/swap-flows/fixed-rate-swap">
    **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>

  <Card title="DEX Swaps" icon="arrows-rotate" href="/developer-hub/swap-flows/dex-swap">
    **On-chain decentralized swaps**

    * Seconds to minutes
    * Wallet connection required
    * Fully transparent on-chain
    * Best for: DeFi applications
  </Card>

  <Card title="Multi-Swap" icon="layer-group" href="/developer-hub/swap-flows/multi-swap">
    **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
  </Card>
</CardGroup>

## Integration Overview

All swap flows follow a similar pattern:

<Steps>
  <Step title="Get Available Assets">
    Fetch supported tokens and networks
  </Step>

  <Step title="Request Quote">
    Get swap rates and routing information
  </Step>

  <Step title="Create Swap">
    Submit the swap order
  </Step>

  <Step title="Monitor Status">
    Track swap progress to completion
  </Step>
</Steps>

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`                            |
| **DEX**        | `/v2/tokens?hasDex=true` | `/quotes?types=dex`      | `/exchanges`                            |
| **Multi-Swap** | `/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.
</Note>

## What You'll Need

Before starting any integration:

<CardGroup cols={2}>
  <Card title="API Credentials" icon="key">
    Get your API key and secret from the Houdini team
  </Card>

  <Card title="Required Headers" icon="code">
    All requests need:

    * `Authorization: {key}:{secret}`
    * `x-user-ip: {user_ip}`
    * `x-user-agent: {user_agent}`
    * `x-user-timezone: {timezone}`
  </Card>
</CardGroup>

## Complete Code Examples

Ready-to-run Next.js examples for all swap types:

<Card title="GitHub: houdini-nextjs-example" icon="github" href="https://github.com/HoudiniSwap/houdini-api-examples/tree/main/nextjs-example">
  Complete, runnable Next.js examples for Private, Standard, and DEX swaps
</Card>

## Additional Resources

<CardGroup cols={2}>
  <Card title="Tokens & Networks" icon="coins" href="/developer-hub/core-concepts/tokens-networks">
    Token identifiers and network support
  </Card>

  <Card title="Order Lifecycle" icon="rotate" href="/developer-hub/core-concepts/order-lifecycle">
    Status codes and swap state management
  </Card>

  <Card title="Routing Types" icon="route" href="/developer-hub/core-concepts/routing-types">
    Deep dive into each routing strategy
  </Card>

  <Card title="API v2 Reference" icon="book" href="/api-reference">
    Complete API endpoint documentation
  </Card>
</CardGroup>