Skip to main content

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.

​
API v1

API v1 is for existing integrators only. If you are building a new integration, use API v2 — it offers unified endpoints, improved token handling, and WebSocket order updates.
Never expose your API key and secret publicly. This API is meant to be used in a backend environment, not a frontend UI directly.

​
Overview

The HoudiniSwap Partner API enables you to integrate private cryptocurrency swaps into your platform. The API supports both CEX (centralized) and DEX (decentralized) swap flows.

​
Base URL

https://api-partner.houdiniswap.com/

​
Authentication

All requests require an Authorization header using the format: 
Authorization: <your API KEY>:<your API SECRET>

​
Mandatory Fields

All exchange requests must include the following fields for compliance:
FieldDescription
ipUser’s IP address
userAgentBrowser user agent string
timezoneUser’s timezone (e.g., UTC)

​
Core Workflow

  1. Authentication – Verify your API credentials
  2. Get Currencies – Retrieve supported tokens and network information
  3. Get Quote – Obtain pricing data for a swap, including exchange rates and validity windows
  4. Initiate Exchange – Execute the transaction with source/destination currencies and recipient address
  5. Get Status – Monitor swap progress from initiation through completion