Rate limiting

​

Limits by endpoint

​

Response headers

​

Handling rate limits

async function fetchWithRetry(url, options) {
  const response = await fetch(url, options);

  if (response.status === 429) {
    const resetSeconds = parseInt(response.headers.get('X-RateLimit-Reset'), 10);
    await new Promise(resolve => setTimeout(resolve, resetSeconds * 1000));
    return fetch(url, options);
  }

  return response;
}

​

Recommendations

• Cache rate quotes — Use the quote ID to retrieve rates later instead of making repeated rate requests.
• Use streaming — The /rates/ltl/stream endpoint returns rates as they arrive via SSE, reducing the need for polling.
• Batch operations — Group related items into a single rate request rather than making separate requests per item.