October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk4 min

How to Set FRED API Request Limits and Handle Rate-Limit Errors

FRED API v1 and v2 have different documented request thresholds. Learn how to pace requests, diagnose 429 errors, and retry without creating a request storm.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

FRED documents different request thresholds for its two API versions: up to 120 requests per minute for API v1 and up to 2 requests per second for API v2, before a 429 Too Many Requests response. These are version-specific thresholds, not a guaranteed sustained throughput. Set a separate client-side limiter for the version you use, and slow down if you receive a 429; FRED warns that ignoring throttling can lead to a temporary block.

FRED API rate limits by version

Choose a limit only after identifying the endpoint version your application calls. FRED publishes separate thresholds in its API v1 Errors documentation and API v2 Errors documentation.

API version Published threshold before HTTP 429 Authentication Error response formats
v1 Up to 120 requests per minute, according to FRED’s current v1 Errors page, accessed in 2026. Registered API key passed in the api_key request variable. XML or JSON.
v2 Up to 2 requests per second, according to FRED’s current v2 Errors page, accessed in 2026. API key in the HTTP Authorization: Bearer … header. JSON or XML.

The figures are thresholds stated by FRED, not permission to sustain that exact rate indefinitely. The API overview describes v1 for customizable, incremental series-level retrieval from FRED and ALFRED, and v2 for bulk observations across a release and full histories. Choose the endpoint that fits the retrieval task, then apply that version’s threshold and key requirements. See the FRED API overview.

What a 429 means—and what it does not

HTTP 429 is FRED’s documented signal that the request threshold has been exceeded. FRED says, “Not complying with the throttling can result in a temporary block.” The warning appears on both version-specific errors pages. The documentation does not give a guaranteed unblock time or prescribe a retry schedule.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Do not treat every failed request as a rate-limit error. FRED documents other status codes whose meaning depends on the API version: for example, 400 for a bad request, 404 for a missing resource, and 500 for an internal server error. The v1 page also lists 423 Locked; the v2 page lists 401 for missing or invalid credentials and 406 for an invalid format. Error responses use standard HTTP status codes and include a body describing the error.

Set a client-side request limiter

FRED’s documentation gives server-side thresholds, not a user-configurable quota or a required client implementation. Use an application-level queue or limiter to pace requests below the applicable threshold. That headroom is your implementation choice—not a published FRED safety margin—and helps avoid bursts when multiple workers run at once.

  1. Identify the version. Check the endpoint your code calls and keep independent limiter settings for v1 and v2; their units are not interchangeable.
  2. Route requests through one queue. Make concurrent workers share the limiter rather than letting each worker send at the full application rate.
  3. Include every request. Count retries and pagination calls as requests. For large v2 release-observation pulls, use the endpoint’s next_cursor pagination when a response exceeds the observation limit, and pace each subsequent call through the same limiter. See the v2 observations endpoint documentation.
  4. Track outcomes. Record the endpoint version, HTTP status, and error message so you can distinguish throttling from a bad parameter or credential problem.

Handle 429 responses without creating a request storm

On a 429, pause the affected request flow rather than immediately retrying at its previous pace. A conventional client-side approach is bounded exponential backoff with jitter: increase the delay between retries, add randomness so clients do not all resume together, and cap the number of attempts. This is engineering guidance based on FRED’s throttling and temporary-block warning, not a FRED-mandated or tested retry recipe. FRED’s cited documentation does not specify exact wait durations or document a guaranteed Retry-After behavior.

  • Retry only when the status and response body indicate that retrying is appropriate.
  • Limit attempts and surface a persistent failure to the application instead of retrying indefinitely.
  • After a 429, reduce the sending rate and review concurrency or queued work before resuming.

Diagnose other errors before retrying

Parse the error body in the format actually returned by the endpoint, and log its description along with the HTTP status. Redact API keys and other credentials from logs. Then fix the underlying issue rather than repeatedly resending the same request.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • 400 Bad Request: check the request parameters and endpoint.
  • 401 on v2: verify that a valid key is present in the Bearer authorization header.
  • 406 on v2: check the requested response format.
  • 423 on v1: the resource is locked; inspect the response description before deciding what to do.
  • 500: the server reported an internal error; use a bounded retry policy rather than an unending loop.

Authentication differs between versions. For v1, FRED requires a registered 32-character lowercase alphanumeric key in the api_key request variable; its terms say requests with an invalid key are blocked. For v2, every web-service request needs a key in the Authorization: Bearer … header. FRED recommends a distinct key for each application and says each application user should use their own key. Follow the API key instructions, and keep keys out of source repositories, published examples, and client-visible logs.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

If your workload needs more capacity

If a legitimate workload cannot fit within the documented threshold, FRED’s errors pages say to contact it. That is not a promise that a higher rate will be approved. The FRED API terms also reserve the St. Louis Fed’s ability to set or adjust transaction and bandwidth limits, and prohibit unreasonable bandwidth use or use that adversely affects service stability or other applications. Do not evade throttling by distributing requests across accounts or credentials.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.