Rate Limits

Limits by tier

Requests are rate-limited using a 60-second sliding window, keyed to your API key.

Tier	Limit	Price
Free	60 requests/min	$0
Starter	120 requests/min	$5.99/mo
Pro	300 requests/min	$9.99/mo

Response headers

Every API response includes rate limit headers:

Header	Description	Example
`X-RateLimit-Limit`	Max requests allowed per window	`300`
`X-RateLimit-Remaining`	Requests remaining in current window	`298`
`Retry-After`	Seconds until window resets (only on 429)	`42`

Rate limit exceeded

When you exceed the limit, the API returns 429 Too Many Requests:

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Max 60 requests per minute."
  }
}

Retry strategy

async function fetchWithRetry(url, headers, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, { headers });

    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get("Retry-After") || "60");
      await new Promise((r) => setTimeout(r, retryAfter * 1000));
      continue;
    }

    return response;
  }
  throw new Error("Max retries exceeded");
}

import time
import requests

def fetch_with_retry(url, headers, max_retries=3):
    for _ in range(max_retries):
        response = requests.get(url, headers=headers)

        if response.status_code == 429:
            retry_after = int(response.headers.get("Retry-After", "60"))
            time.sleep(retry_after)
            continue

        return response

    raise Exception("Max retries exceeded")

Optimization tips

Cached responses still count toward your quota — optimize on your side to avoid redundant requests.

Batch requests. Use mode=full to get all bazaar data in a single call instead of fetching items one at a time.
Respect update intervals. Bazaar data refreshes every ~5 seconds. Polling faster than that wastes quota with no new data.
Cache locally. Check the meta.cached field to understand freshness and implement client-side caching.
Use the right mode. If you only need item IDs, use mode=list instead of mode=full.
Monitor headers. Check X-RateLimit-Remaining to proactively throttle before hitting limits.

Usage tracking

Every API request is logged. View your usage breakdown by endpoint and time period in the Developer Dashboard.

Getting started

Guides

Limits by tier

Response headers

Rate limit exceeded

Retry strategy

Optimization tips

Usage tracking