Rate limiting in FastAPI

Introduction

Rate limiting helps control how many times a user or client can use an API in a set time. It stops overload and keeps the service fair for everyone.

To prevent a user from sending too many requests and slowing down the server.

To protect an API from being overwhelmed by bots or attackers.

To make sure all users get a fair chance to use the service.

To avoid extra costs from too many requests in cloud services.

Syntax

FastAPI

from fastapi import FastAPI, Request, HTTPException, Depends
from fastapi_limiter import FastAPILimiter
from fastapi_limiter.depends import RateLimiter
import aioredis

app = FastAPI()

@app.on_event("startup")
async def startup():
    redis = await aioredis.from_url("redis://localhost", encoding="utf8", decode_responses=True)
    await FastAPILimiter.init(redis)

@app.get("/items", dependencies=[Depends(RateLimiter(times=5, seconds=60))])
async def read_items():
    return {"message": "You can call this 5 times per minute."}

You need Redis running because rate limiting stores counts there.

Use times and seconds to set how many calls are allowed in that time.

Examples

This limits login attempts to 3 per minute to prevent brute force attacks.

FastAPI

from fastapi import FastAPI, Depends
from fastapi_limiter.depends import RateLimiter

app = FastAPI()

@app.get("/login", dependencies=[Depends(RateLimiter(times=3, seconds=60))])
async def login():
    return {"message": "Max 3 login attempts per minute."}

This limits data requests to 10 per hour for each user.

FastAPI

from fastapi import FastAPI
from fastapi_limiter.depends import RateLimiter

app = FastAPI()

@app.get("/data", dependencies=[Depends(RateLimiter(times=10, seconds=3600))])
async def get_data():
    return {"message": "Max 10 calls per hour."}

Sample Program

This FastAPI app limits the /hello endpoint to 2 calls every 30 seconds per user. If you call it more, it will block you temporarily.

FastAPI

from fastapi import FastAPI, Depends
from fastapi_limiter import FastAPILimiter
from fastapi_limiter.depends import RateLimiter
import aioredis

app = FastAPI()

@app.on_event("startup")
async def startup():
    redis = await aioredis.from_url("redis://localhost", encoding="utf8", decode_responses=True)
    await FastAPILimiter.init(redis)

@app.get("/hello", dependencies=[Depends(RateLimiter(times=2, seconds=30))])
async def say_hello():
    return {"message": "Hello! You can call this endpoint 2 times every 30 seconds."}

Important Notes

Make sure Redis is installed and running before starting the FastAPI app.

Rate limiting works per client IP or user depending on your setup.

You can customize limits per route using the RateLimiter dependency.

Summary

Rate limiting controls how often users can call API endpoints.

It helps protect your app from overload and abuse.

FastAPI uses external Redis storage to track request counts for limits.

Practice

1.

What is the main purpose of rate limiting in a FastAPI application?

easy

A. To speed up database queries

B. To control how often users can call API endpoints

C. To add more routes automatically

D. To change the API response format

Solution

1. Step 1: Understand rate limiting concept

   Rate limiting restricts the number of requests a user can make in a time period.

2. Step 2: Identify the purpose in FastAPI

   It protects the app from overload and abuse by controlling request frequency.

3. Final Answer:

   To control how often users can call API endpoints -> Option B

4. Quick Check:

   Rate limiting = Control request frequency [OK]

Hint: Rate limiting means controlling request frequency [OK]

Common Mistakes:

• Thinking it speeds up queries
• Confusing with routing features
• Assuming it changes response format

2.

Which of the following is the correct way to import a rate limiter middleware in FastAPI?

from fastapi import FastAPI
from _____ import RateLimiterMiddleware

app = FastAPI()
app.add_middleware(RateLimiterMiddleware, max_requests=5, window_seconds=60)

easy

A. fastapi_utils

B. fastapi.middleware

C. fastapi_rate_limit

D. fastapi_limiter

Solution

1. Step 1: Recall FastAPI rate limiting libraries

   FastAPI commonly uses the external package 'fastapi_limiter' for rate limiting middleware.

2. Step 2: Match import statement

   The correct import is from 'fastapi_limiter' to get RateLimiterMiddleware.

3. Final Answer:

   fastapi_limiter -> Option D

4. Quick Check:

   RateLimiterMiddleware import = fastapi_limiter [OK]

Hint: Rate limiter middleware comes from fastapi_limiter package [OK]

Common Mistakes:

• Using built-in fastapi.middleware (no rate limiter there)
• Confusing with unrelated packages
• Misspelling package names

3.

Given this FastAPI code snippet using fastapi_limiter:

from fastapi import FastAPI
from fastapi_limiter import FastAPILimiter
from fastapi_limiter.depends import RateLimiter
import aioredis

app = FastAPI()

@app.on_event("startup")
async def startup():
    redis = await aioredis.from_url("redis://localhost")
    await FastAPILimiter.init(redis)

@app.get("/items", dependencies=[Depends(RateLimiter(times=3, seconds=10))])
async def read_items():
    return {"message": "Success"}

What happens if a user calls /items 4 times within 10 seconds?

medium

A. The server crashes due to Redis error

B. All 4 requests succeed with message 'Success'

C. The 4th request is blocked with a 429 Too Many Requests error

D. The 4th request is delayed but eventually succeeds

Solution

1. Step 1: Understand RateLimiter parameters

   RateLimiter(times=3, seconds=10) allows 3 requests every 10 seconds per user.

2. Step 2: Analyze 4 requests in 10 seconds

   The 4th request exceeds the limit and triggers a 429 error response.

3. Final Answer:

   The 4th request is blocked with a 429 Too Many Requests error -> Option C

4. Quick Check:

   Requests > limit = 429 error [OK]

Hint: Requests over limit cause 429 error response [OK]

Common Mistakes:

• Assuming all requests succeed
• Thinking server crashes on limit
• Believing requests get delayed instead of blocked

4.

Identify the error in this FastAPI rate limiting setup:

from fastapi import FastAPI
from fastapi_limiter import FastAPILimiter
import aioredis

app = FastAPI()

@app.on_event("startup")
async def startup():
    redis = aioredis.from_url("redis://localhost")
    await FastAPILimiter.init(redis)

@app.get("/data", dependencies=[Depends(RateLimiter(times=2, seconds=5))])
async def get_data():
    return {"data": "info"}

medium

A. Missing await before aioredis.from_url call

B. RateLimiter times parameter must be 5 or more

C. FastAPILimiter.init should not be awaited

D. Redis URL must use http:// instead of redis://

Solution

1. Step 1: Check aioredis.from_url usage

   aioredis.from_url is an async function and must be awaited to get the Redis client.

2. Step 2: Identify missing await

   The code calls aioredis.from_url without await, causing a coroutine object instead of Redis client.

3. Final Answer:

   Missing await before aioredis.from_url call -> Option A

4. Quick Check:

   Async calls need await [OK]

Hint: Always await async Redis client creation [OK]

Common Mistakes:

• Forgetting await on async functions
• Misunderstanding RateLimiter parameters
• Using wrong Redis URL scheme

5.

You want to limit users to 10 requests per minute globally across multiple FastAPI instances behind a load balancer. Which setup is best?

1. Use in-memory counters in each instance
2. Use Redis with fastapi_limiter shared by all instances
3. Use local file storage for counts
4. Disable rate limiting

hard

A. Option 2: Use Redis with fastapi_limiter shared by all instances

B. Option 1: Use in-memory counters in each instance

C. Option 3: Use local file storage for counts

D. Option 4: Disable rate limiting

Solution

1. Step 1: Understand distributed rate limiting need

   Multiple FastAPI instances require a shared store to track request counts globally.

2. Step 2: Evaluate options

   In-memory counters are local to each instance, causing inconsistent limits. Local files are not suitable for concurrency. Disabling rate limiting removes protection.

3. Step 3: Choose Redis shared by all instances

   Redis is a fast, centralized store that all instances can use to enforce limits consistently.

4. Final Answer:

   Option 2: Use Redis with fastapi_limiter shared by all instances -> Option A

5. Quick Check:

   Distributed rate limiting needs shared Redis [OK]

Hint: Use shared Redis for consistent limits across instances [OK]

Common Mistakes:

• Using local memory causing inconsistent limits
• Using file storage which is slow and unsafe
• Disabling rate limiting ignoring abuse risks