Rate Limits and Quotas

FutPicks APIs are rate-limited to protect the scoring, data, and operations layers.

Rate limit policies

Policy	Limit	Applies to
public-read	120 requests/min	Public endpoints
auth	20 requests/min	Authenticated endpoints
register	5 requests/hour	Registration

429 responses

When a limit is exceeded, the response includes a Retry-After header indicating the number of seconds to wait before retrying:

HTTP/1.1 429 Too Many Requests
Retry-After: 60

Prefer exports

If you need many pages of historical data, use async exports instead of consuming quota with repeated list requests.

Usage endpoints

Use the Data API usage endpoints to inspect current-period consumption and quota state:

curl https://futpicks.com/api/v1/data/usage \
  -H "Authorization: Bearer $FUTPICKS_TOKEN"