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:
| Field | Description |
|---|
ip | User’s IP address |
userAgent | Browser user agent string |
timezone | User’s timezone (e.g., UTC) |
Core Workflow
- Authentication – Verify your API credentials
- Get Currencies – Retrieve supported tokens and network information
- Get Quote – Obtain pricing data for a swap, including exchange rates and validity windows
- Initiate Exchange – Execute the transaction with source/destination currencies and recipient address
- Get Status – Monitor swap progress from initiation through completion
