Skip to main content

Tiers, Commission & Monitoring

All accounts start on Free. Pro comes with higher rate limits, which can be customized per agreement.Upgrades are handled manually. Contact the Houdini team through the Partner Portal to request one.See: Rate Limits & Tiers
Commissions are paid in USDC.Earnings accumulate automatically as eligible swaps settle and are reflected in:
  • Commission Balance
  • Withdrawable Balance
Withdrawals are initiated manually by the partner through the dashboard. There is no automatic payout schedule. Funds are available for withdrawal once reflected as withdrawable.See: Analytics & Settlement
The Partner Dashboard displays:
  • All-time volume
  • Swap count
  • Commission balance
  • Withdrawable balance
  • Daily and monthly charts
The same data is available via API through the Partner Stats endpoints.See: Analytics & Settlement

Operational & Support

A stuck transaction can have multiple causes, including:
  • Network congestion
  • Liquidity provider maintenance
  • Compliance review
  • Routing delays
Recommended process:
  1. Confirm the transaction hash and Order ID.
  2. Check order status via the status endpoint.
  3. If the issue is not resolved automatically, escalate to Houdini support with the Order ID.
Partners may choose one of two models:
  • Redirect users directly to Houdini support.
  • Handle first-line support internally and escalate cases to Houdini when needed.

Product Scope & Customization

Yes. You can create and manage multiple swaps in a single batch, using CEX or private routing, through the Partner API.See: Multi-Swap
Yes. API partners can enable route rotation for private swaps.When rotation is enabled:
  • The route used for the previous user is excluded from selection.
  • The routing engine selects the next best available route.
  • Selection is constrained by a configurable price deviation threshold defined in the API request.
If no alternative routes exist within the defined deviation threshold, the original route is returned to the rotation pool and routing continues normally.This ensures:
  • Users are not consistently routed through the same execution path.
  • Pricing remains within acceptable limits defined by the partner.
See: Payout Wallet Rotation and Routing Types
Asset and network support is managed by Houdini. If additional tokens or chains are required, contact the team to request integration.See: Tokens & Networks

Risk & Compliance

Partners integrate through the Houdini Partner API:
  • Partner: builds the UI and sends API requests.
  • Exchange providers: execute the swap, run AML/KYT screening, hold funds while the swap is in progress, and issue refunds.
  • Houdini: non-custodial. Handles routing, orchestration, order records and user support.
HoudiniPay does not have a partner API yet. It is on the roadmap and is currently available only in the Houdini web app.
Houdini Swap is a non-custodial liquidity aggregator. We do not pool funds and we do not operate mixer contracts.Compliance enforcement is built into the routing perimeter and executed through vetted exchange partners:
  • Primary screening is performed by execution partners at the deposit stage using real-time AML/AFT screening tools.
  • Houdini maintains a strict partner due diligence process (KYB requirements, compliance officers and policies, law enforcement cooperation).
  • Houdini also enforces structural safeguards such as transaction limits, geo restrictions and sanctioned-address checks at the API level.
See: Privacy and Compliance
Each provider runs its own KYT screening on the funds it receives:
  • Exchange 1 screens the original sender wallet and source asset.
  • Exchange 2 screens the funds it receives from the first leg.
Houdini keeps the full order record, linking both legs, the source wallet and the transaction hashes. This record is provided to providers or authorities through valid legal or compliance request processes, so the full path stays traceable end-to-end.
No upfront KYC. The model is KYT first: deposits are screened on-chain as they arrive.KYC and enhanced due diligence (EDD) are triggered only when risk is flagged. The provider that flagged the transaction collects and verifies the user’s information.
If a deposit is flagged, the provider asks the user to complete KYC:
  • If the user passes, the swap goes ahead.
  • If not, the provider refunds the funds, less network fees.
The provider holding the funds at the time of failure is responsible for the refund. Houdini’s 24/7 support team coordinates refunds with the user.
If a deposit is linked to sanctioned wallets or illicit activity, the provider holding the funds applies its own AML policy under its compliance obligations and applicable law. Depending on the case, it may:
  • Hold the funds
  • Request KYC/EDD
  • Refund the funds
  • Freeze and report the funds where required by law
Houdini never takes custody of user funds. Houdini’s role is to ensure swaps route only through compliant partners and to enforce platform-level safeguards, including:
  • Partner oversight and continuous review
  • Transaction limits
  • Blocking access from restricted jurisdictions
  • Rejecting sanctioned destination addresses at the API level (422 ADDRESS_TO_SANCTIONED)
Responsibility and handling procedures are further defined in the partner agreement.See: Privacy and Compliance and Error Codes & Troubleshooting
Houdini applies perimeter controls designed to prevent usage from restricted jurisdictions:
  • Access from the US and EU sanctioned countries is blocked on the website.
  • Private swaps route through vetted partners that maintain internal auditability and comply with lawful requests.
API partners must ensure their own distribution complies with applicable laws and must pass the required compliance signals through request headers.See: Privacy and Compliance and API Keys & Authentication

Security & Audit

Houdini is currently in the process of obtaining SOC 2 certification with Deloitte, focused on security, availability, and operational controls.For detailed security documentation or enterprise discussions, contact the Houdini team.