Rate Limits & Tiers

Tiers

API usage is governed by tier-based, endpoint-specific rate limits. Every Partner API account starts on the Free tier.

	Free	Pro
Rate limits	Default limits (see below)	Higher limits, customizable per agreement
Commission	Per partner agreement	Per partner agreement

Tier upgrades are handled manually. Contact the Houdini team through the Partner Portal to request an upgrade.

You can see your current tier in the Partner Dashboard.

Endpoint Limits

Rate limits are enforced per endpoint.

Free Tier Limits

Endpoint	Min	Hour	Day
quote	10	20	50
exchange	5	15	10

Pro Tier Limits

Endpoint	Min	Hour	Day
quote	500	2000	5000
exchange	50	500	2000

Pro limits are defaults. They can be adjusted per partner agreement. Use Get rate limits to see the limits that apply to your account.

Rate Limit Enforcement

When rate limits are exceeded, the API returns HTTP status code 429: GraphQL

{
  "errors": [
    {
      "message": "Too many quote requests. Try again in 45 seconds.",
      "extensions": {
        "code": 429,
        "type": "RATE_LIMIT_EXCEEDED",
        "retryAfter": 45,
        "limit": 45,
        "windowMs": 60000
      }
    }
  ]
}

REST API

{
  "code": 429,
  "type": "RATE_LIMIT_EXCEEDED",
  "message": "Too many quote requests. Try again in 45 seconds.",
  "extensions": {
    "retryAfter": 45,
    "limit": 45,
    "windowMs": 60000
  }
}

Response Fields:

Field	Description
`code`	HTTP status code (429)
`type`	Error type: `RATE_LIMIT_EXCEEDED`
`message`	Operation-specific message indicating when to retry
`retryAfter`	Seconds until the rate limit resets
`limit`	Maximum requests allowed in the time window
`windowMs`	Time 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.

Overview

Getting Started

Core Concepts

Swap Flow Guides

Widget Integration

Troubleshooting

Partner Operations

Tiers

Endpoint Limits

Free Tier Limits

Pro Tier Limits

Rate Limit Enforcement

​Tiers

​Endpoint Limits

​Free Tier Limits

​Pro Tier Limits

​Rate Limit Enforcement

Tiers

Endpoint Limits

Free Tier Limits

Pro Tier Limits

Rate Limit Enforcement