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.

​
Tiers

API usage is governed by tier-based, endpoint-specific rate limits.

​
Free Tier

Default limits apply upon registration.

​
Pro Tier

Higher default limits apply. For Pro tier partners, limits can be adjusted per agreement. Tier upgrades are handled manually.
Contact the Houdini team through the Partner Portal to request an upgrade.

​
Endpoint Limits

Rate limits are enforced per endpoint.

​
Free Tier Limits

EndpointMinHourDay
quote52050
exchange1510

​
Pro Tier Limits

EndpointMinHourDay
quote50020005000
exchange505002000

​
Rate Limit Enforcement

When rate limits are exceeded, the API will throw an error with HTTP status code 429:
Example: 
{
  "errors": [
    {
      "message": "Too many quote requests. Try again in 45 seconds.",
      "extensions": {
        "code": 429,
        "type": "RATE_LIMIT_EXCEEDED",
        "retryAfter": 45,
        "limit": 45,
        "windowMs": 60000
      }
    }
  ]
}
Response Fields:
FieldDescription
codeHTTP status code (429)
typeError type: RATE_LIMIT_EXCEEDED
messageOperation-specific message indicating when to retry
retryAfterSeconds until the rate limit resets
limitMaximum requests allowed in the time window
windowMsTime window in milliseconds (e.g., 60000 = 1 minute)
Best Practice: Implement exponential backoff when handling rate limit errors. Always respect the retryAfter value provided in the response.