# Houdini documentation

- [About Houdini](https://docs.houdiniswap.com/overview/getting-started/what-is-houdini.md): Understand what Houdini is, how it works, and what makes it different.
- [Core Swap Concepts](https://docs.houdiniswap.com/overview/getting-started/core-swap-concepts.md): Compare Houdini’s non-custodial swap types, including private swaps, no wallet connect swaps, and DEX swaps, and understand the tradeoffs between privacy, speed, and execution across chains.
- [Privacy and Compliance](https://docs.houdiniswap.com/overview/getting-started/privacy-and-compliance.md): How Houdini balances privacy with regulatory compliance
- [Private Swap](https://docs.houdiniswap.com/overview/swaps-and-transfers/private-swaps.md): Privacy-first, non-custodial cross-chain swaps designed to eliminate on-chain traceability.
- [No Wallet Connect](https://docs.houdiniswap.com/overview/swaps-and-transfers/no-wallet-connect.md): Swap without needing to connect your wallet, using a manual deposit address.
- [On-chain DEX or Bridge](https://docs.houdiniswap.com/overview/swaps-and-transfers/on-chain-swaps.md): Swap any token on any chain instantly, securely, and at the best market rates.
- [MultiSwap](https://docs.houdiniswap.com/overview/products-and-features/multi-swap.md): Create multiple private or no-wallet-connect crypto swaps at once with Houdini MultiSwap, using flexible amounts, parallel execution and route rotation.
- [HoudiniPay](https://docs.houdiniswap.com/overview/products-and-features/houdinipay.md): Private crypto payments using shareable payment links
- [Browser Extension](https://docs.houdiniswap.com/untitled-page.md): Swap privately from any tab with the Houdini browser extension, without leaving the page you're on.
- [Chain Coverage & Partners](https://docs.houdiniswap.com/overview/coverage-and-economy/chain-tokens-partners.md): Explore Houdini Swap’s supported chains, tokens and liquidity partners across private swaps, DEX routes and cross-chain bridges.
- [Fees & Pricing](https://docs.houdiniswap.com/overview/coverage-and-economy/monetization-and-fees.md): Understand Houdini Swap’s all-in pricing, including network, protocol and routing fees, swap-type costs, slippage protection and no hidden fees.
- [Media Kit](https://docs.houdiniswap.com/products/swap-transfer/media-kit.md): Brand assets for Houdini. Download logos and wordmarks for use in press, partnerships, and integrations.
- [Privacy Notice](https://docs.houdiniswap.com/products/swap-transfer/privacy-notice.md): Review Houdini Swap’s Privacy Notice, including transaction data collection, 72-hour retention, user deletion rights and personal information use.
- [Terms of Service](https://docs.houdiniswap.com/products/swap-transfer/terms-of-service.md): Review Houdini Swap’s Terms of Service, including user eligibility, restricted jurisdictions, non-custodial transactions, risks, fees and legal conditions.
- [Private Swap Guide](https://docs.houdiniswap.com/guides/how-to/private-swap.md): Learn how to complete a private crypto swap with Houdini, from selecting tokens and routing to adjusting slippage, entering your wallet and sending funds.
- [Onchain DEX / Bridge](https://docs.houdiniswap.com/guides/how-to/swap-on-chain.md): Learn how to swap or bridge crypto on-chain with Houdini using DEX routing, custom slippage, wallet connection and direct transaction approval.
- [Multiswap Guide](https://docs.houdiniswap.com/guides/how-to/multiswap.md): Learn how to use Houdini MultiSwap to split crypto across multiple wallets with private or DEX routing and flexible amount options.
- [Payment Link](https://docs.houdiniswap.com/guides/how-to/create-private-payment-links.md): Learn how to create and share private crypto payment links with Houdini, set the token and amount, customize the URL and receive funds securely.
- [Contact Support Guide](https://docs.houdiniswap.com/guides/how-to/contact-support.md): Learn how to contact Houdini Swap’s 24/7 human support team from your order page or menu and access the support portal on Telegram.
- [Earn rewards / Become an affiliate](https://docs.houdiniswap.com/guides/how-to/earn-rewards.md): Learn how to become a Houdini affiliate, share a custom referral link, track rewards, set a withdrawal wallet and claim your earnings.
- [What You Can Build](https://docs.houdiniswap.com/developer-hub/overview/what-you-can-build.md): Explore the possibilities with Houdini's cross-chain swap infrastructure
- [Architecture Overview](https://docs.houdiniswap.com/developer-hub/overview/architecture.md): Learn how Houdini's intelligent routing engine connects CEXs and on-chain DeFi protocols for optimal swap execution
- [API Keys & Authentication](https://docs.houdiniswap.com/developer-hub/getting-started/authentication.md): Learn how to obtain and use API keys to authenticate with Houdini
- [Quick Start](https://docs.houdiniswap.com/developer-hub/getting-started/quick-start.md): Jump straight into integrating the swap type you need
- [Rate Limits & Tiers](https://docs.houdiniswap.com/developer-hub/getting-started/rate-limits-and-tiers.md): Understand how API usage limits work and how to upgrade your tier.
- [Routing Types](https://docs.houdiniswap.com/developer-hub/core-concepts/routing-types.md): Understand Houdini's routing strategies — private, standard, and DEX — plus the fixed rate and reverse quote options, and when to use each
- [Order Lifecycle](https://docs.houdiniswap.com/developer-hub/core-concepts/order-lifecycle.md): Understanding order states, status transitions, and lifecycle management
- [Tokens & Networks](https://docs.houdiniswap.com/developer-hub/core-concepts/tokens-networks.md): Understanding how tokens and networks are represented and discovered in Houdini
- [Order Status Updates](https://docs.houdiniswap.com/developer-hub/core-concepts/websocket-order-updates.md): Real-time order status updates via WebSocket
- [x402 Payments](https://docs.houdiniswap.com/developer-hub/core-concepts/x402-pay-per-request.md): Pay-per-request API access using USDC stablecoin payments
- [Private Swap](https://docs.houdiniswap.com/developer-hub/swap-flows/private-swap.md): Integrate multi-hop private swaps using the unified v2 quotes and exchanges API
- [Standard Swap](https://docs.houdiniswap.com/developer-hub/swap-flows/standard-swap.md): Integrate standard CEX swaps using the unified v2 quotes and exchanges API
- [DEX Swap](https://docs.houdiniswap.com/developer-hub/swap-flows/dex-swap.md): Integrate on-chain DEX swaps using the unified v2 quotes and exchanges API
- [Fixed Rate & Reverse Quote](https://docs.houdiniswap.com/developer-hub/swap-flows/fixed-rate-swap.md): Lock the exchange rate at quote time, or specify the exact amount the recipient receives
- [Payout Wallet Rotation](https://docs.houdiniswap.com/developer-hub/core-concepts/payout-wallet-rotation.md): Improve swap privacy by rotating provider routing paths across consecutive orders
- [Multi-Swap](https://docs.houdiniswap.com/developer-hub/swap-flows/multi-swap.md): Create and manage multiple swaps in a single batch — supports CEX and anonymous routing
- [Private Send](https://docs.houdiniswap.com/developer-hub/swap-flows/send.md): Send funds to another wallet privately — same token in and out
- [Widget Overview](https://docs.houdiniswap.com/developer-hub/widget/overview.md): Drop-in swap widget you embed into any website with a single iframe
- [Error Codes & Troubleshooting](https://docs.houdiniswap.com/developer-hub/troubleshooting/error-codes-and-troubleshooting.md): Complete reference of error codes, HTTP statuses, and response formats for the HoudiniSwap Partner API v2.
- [Analytics & Settlement (Partner Dashboard)](https://docs.houdiniswap.com/analytics-and-settlement.md): Understand how commissions are calculated, tracked, and withdrawn.
- [Partner Stats](https://docs.houdiniswap.com/developer-hub/core-concepts/partner-stats.md): Query your partner volume, weekly breakdowns, and time-series chart data
- [Partner FAQs](https://docs.houdiniswap.com/partner-faqs.md): Find answers to common Houdini partner questions about commissions, monitoring, support, API features, compliance, risk and security.
- [Get tokens](https://docs.houdiniswap.com/api-reference/private-and-standard-swaps/get-tokens.md): Returns the tokens available for private and standard swaps. Use the returned id as the from / to of a quote.
- [Get quotes](https://docs.houdiniswap.com/api-reference/private-and-standard-swaps/get-quotes.md): Returns the private and standard routes for a token pair and amount.
- [Get quotes by token address](https://docs.houdiniswap.com/api-reference/private-and-standard-swaps/get-quotes-by-token-address.md): Returns private and standard routes using contract addresses instead of token ids.
- [Create exchange](https://docs.houdiniswap.com/api-reference/private-and-standard-swaps/create-exchange.md): Creates a private or standard swap order from a quoteId.
- [Get order details](https://docs.houdiniswap.com/api-reference/private-and-standard-swaps/get-order-details.md): Returns a private or standard swap order created in the last 48 hours.
- [Get tokens](https://docs.houdiniswap.com/api-reference/private-send/get-tokens.md): Returns the tokens you can send privately to another wallet. Use the returned id as the token of a private send quote.
- [Get private send quote](https://docs.houdiniswap.com/api-reference/private-send/get-private-send-quote.md): Quote a private send: send funds to another wallet via a private (two-hop) route. Same token in and out.
- [Create private send order](https://docs.houdiniswap.com/api-reference/private-send/create-private-send-order.md): Send funds to another wallet via a private (two-hop) route. Same token in and out.
- [Get order details](https://docs.houdiniswap.com/api-reference/private-send/get-order-details.md): Track a private send after it is created.
- [Get tokens](https://docs.houdiniswap.com/api-reference/multi-exchange/get-tokens.md): Returns the tokens available for a multi-exchange. Use the returned id as the from / to of each order.
- [Get multi quotes](https://docs.houdiniswap.com/api-reference/multi-exchange/get-multi-quotes.md): Returns the available routes for each swap in a batch.
- [Create multi exchange](https://docs.houdiniswap.com/api-reference/multi-exchange/create-multi-exchange.md): Creates a group of swaps that share one `multiId`. Post the orders straight here — there is no quote step and no `quoteId`.
- [Get batch status](https://docs.houdiniswap.com/api-reference/multi-exchange/get-batch-status.md): Returns the status of all orders belonging to a multi exchange group.
- [Get batch transaction](https://docs.houdiniswap.com/api-reference/bundler-sol/get-batch-transaction.md): Returns one Solana transaction that pays every deposit address in the group.
- [Build batch transaction](https://docs.houdiniswap.com/api-reference/bundler-evm/build-batch-transaction.md): Funds every order in a multi-exchange with one ERC-4337 UserOperation instead of paying each deposit address.
- [Submit signed transaction](https://docs.houdiniswap.com/api-reference/bundler-evm/submit-signed-transaction.md): Sends the batch on-chain, using the signatures from the user's wallet.
- [Retry failed orders](https://docs.houdiniswap.com/api-reference/bundler-evm/retry-failed-orders.md): Retries a failed bundle, returning fresh `txData` to re-sign and submit.
- [Recover stuck assets](https://docs.houdiniswap.com/api-reference/bundler-evm/recover-stuck-assets.md): Finds failed EVM batches for a wallet and returns pre-built withdrawal UserOps. Use this once retry is no longer possible.
- [Get tokens](https://docs.houdiniswap.com/api-reference/on-chain-dex-or-bridge/get-tokens.md): Returns the tokens available for on-chain DEX and bridge swaps. Use the returned id as the from / to of a quote.
- [Get quotes](https://docs.houdiniswap.com/api-reference/on-chain-dex-or-bridge/get-quotes.md): Returns the on-chain DEX and bridge routes for a token pair and amount.
- [Get quotes by token address](https://docs.houdiniswap.com/api-reference/on-chain-dex-or-bridge/get-quotes-by-token-address.md): Returns on-chain DEX and bridge routes using contract addresses instead of token ids.
- [Create exchange](https://docs.houdiniswap.com/api-reference/on-chain-dex-or-bridge/create-exchange.md): Creates an on-chain DEX or bridge swap order from a quoteId.
- [Get token approval data](https://docs.houdiniswap.com/api-reference/on-chain-dex-or-bridge/get-token-approval-data.md): Returns what the wallet must approve before a DEX swap. Call this first — both arrays come back empty when the allowance already covers the swap.
- [Check token allowance](https://docs.houdiniswap.com/api-reference/on-chain-dex-or-bridge/check-token-allowance.md): Check if token allowance is sufficient for a DEX swap
- [Get next chain signature](https://docs.houdiniswap.com/api-reference/on-chain-dex-or-bridge/get-next-chain-signature.md): Returns the next signature in a multi-step chain, for swaps needing more than one (e.g. permit + bridge).
- [Confirm DEX transaction](https://docs.houdiniswap.com/api-reference/on-chain-dex-or-bridge/confirm-dex-transaction.md): Confirms a DEX transaction with the provided transaction hash. This endpoint should be called after the user has signed and submitted the transaction. Without it the Order status may not be determined
- [Get order details](https://docs.houdiniswap.com/api-reference/on-chain-dex-or-bridge/get-order-details.md): Returns an on-chain DEX or bridge order created in the last 48 hours.
- [Get token by ID](https://docs.houdiniswap.com/api-reference/reference-data/get-token-by-id.md): Returns a single token by its `id`. Use this to refresh one token you already know, rather than re-fetching the whole list.
- [Get chains](https://docs.houdiniswap.com/api-reference/reference-data/get-chains.md): Returns the list of available chains for CEX and DEX swaps.
- [Get swap providers](https://docs.houdiniswap.com/api-reference/reference-data/get-swap-providers.md): Returns the list of available swap providers, for both CEX and DEX swaps. Filter with `isDex`.
- [Get min and max amounts](https://docs.houdiniswap.com/api-reference/reference-data/get-min-and-max-amounts.md): Returns the smallest and largest amount you can swap for a token pair, reported separately for standard (`cex`), private, and DEX routes.
- [Get orders](https://docs.houdiniswap.com/api-reference/partner-account/get-orders.md): Returns a paginated list of orders created in the last 48 hours.
- [Get partner profile](https://docs.houdiniswap.com/api-reference/partner-account/get-partner-profile.md): Returns the profile of the partner that owns the API key making the request, including tier, commission rates per route, and default markup.
- [Get rate limits](https://docs.houdiniswap.com/api-reference/partner-account/get-rate-limits.md): Returns the effective rate limits for the authenticated partner, resolved from partner-specific overrides or tier defaults.
- [Get commissions](https://docs.houdiniswap.com/api-reference/partner-account/get-commissions.md): Returns the list of commissions you have earned, newest first. Each entry links to the order that generated it. Filter to one month with `month` (`YYYY-MM`).
- [Get commission summary](https://docs.houdiniswap.com/api-reference/partner-account/get-commission-summary.md): Returns your commission totals — lifetime, pending, processed, and the current and previous month.
- [Get withdrawals](https://docs.houdiniswap.com/api-reference/partner-account/get-withdrawals.md): Returns the list of commission payouts made to your wallet, newest first.
- [Get volume stats](https://docs.houdiniswap.com/api-reference/partner-account/get-volume-stats.md): Returns your lifetime and current-month swap volume and order counts.
- [Get weekly volume](https://docs.houdiniswap.com/api-reference/partner-account/get-weekly-volume.md): Returns volume, order count and commission broken down by ISO week.
- [Get chart stats](https://docs.houdiniswap.com/api-reference/partner-account/get-chart-stats.md): Returns a volume time series for charting, bucketed by day or month. `from` and `to` are ISO 8601 dates and may span at most 730 days.
- [Get system health](https://docs.houdiniswap.com/api-reference/system/get-system-health.md): Returns a public, partner-safe summary of HoudiniSwap API and quote system availability. This endpoint does not require authentication or x402 payment.
- [Migration V1 to V2](https://docs.houdiniswap.com/migration/v1-to-v2.md): Migrate from Partner API v1 to v2
- [API v1 Introduction](https://docs.houdiniswap.com/api-v1/introduction.md): HoudiniSwap Partner API documentation
- [Private Swap (API v1)](https://docs.houdiniswap.com/api-v1/swap-flows/private-swap.md): Complete guide to integrating multi-hop private swaps with maximum privacy
- [Standard Swap (API v1)](https://docs.houdiniswap.com/api-v1/swap-flows/standard-swap.md): Integrate standard swaps with single-hop CEX routing for fast execution
- [DEX Swap (API v1)](https://docs.houdiniswap.com/api-v1/swap-flows/dex-swap.md): Complete guide to integrating on-chain DEX swaps with wallet signatures and approvals
- [Get CEX Tokens](https://docs.houdiniswap.com/api-v1/get-cex-tokens.md): Retrieve supported CEX token list
- [Get CEX Quote](https://docs.houdiniswap.com/api-v1/get-cex-quote.md): Get a price quote for a CEX swap
- [POST CEX Exchange](https://docs.houdiniswap.com/api-v1/post-cex-exchange.md): Initiates an exchange transaction, including sender and receiver information, transaction status, quoted amounts, and token details.
- [Get DEX Tokens](https://docs.houdiniswap.com/api-v1/get-dex-tokens.md): Retrieve supported DEX token list
- [Get DEX Quote](https://docs.houdiniswap.com/api-v1/get-dex-quote.md): Get a price quote for a DEX swap
- [POST DEX Approve](https://docs.houdiniswap.com/api-v1/post-dex-approve.md): Get approval transaction data for a DEX swap
- [POST DEX Confirm Transaction](https://docs.houdiniswap.com/api-v1/post-dex-confirm-tx.md): Confirm a DEX transaction after on-chain submission
- [POST DEX Exchange](https://docs.houdiniswap.com/api-v1/post-dex-exchange.md): Initiate a DEX cryptocurrency swap
- [Get Status](https://docs.houdiniswap.com/api-v1/get-status.md): Check the status of a swap transaction
- [Get Min/Max](https://docs.houdiniswap.com/api-v1/get-min-max.md): Get minimum and maximum exchange amounts for a pair
- [Get Volume](https://docs.houdiniswap.com/api-v1/get-volume.md): Retrieve total swap volume for HoudiniSwap
- [Get Weekly Volume](https://docs.houdiniswap.com/api-v1/get-weekly-volume.md): Retrieve weekly swap volume data for HoudiniSwap
- [Error Codes & Troubleshooting API v1](https://docs.houdiniswap.com/developer-hub/troubleshooting/errors.md): Common errors, their causes, and how to resolve them
- [Release notes](https://docs.houdiniswap.com/changelog/release-notes.md): Stay up to date with Houdini Swap release notes, including new integrations, swap improvements, API updates, security enhancements and platform fixes.
- [FAQs](https://docs.houdiniswap.com/support-and-faqs/faqs.md): Find answers to common Houdini Swap questions about private and standard swaps, fees, delays, safety, recovery, privacy and support.
- [Contact Support](https://docs.houdiniswap.com/faqs/contact-support.md): Contact Houdini Swap’s 24/7 human support team for help with private cross-chain swaps, account questions and secure troubleshooting.

## OpenAPI Specs

- [openapi](https://api-partner.houdiniswap.com/v2/openapi.json)


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