Blog

Beatae error blanditiis libero

November 22, 2024 No comments yet
Manage your Polygon API quota effectively — from the free 5 req/sec tier to enterprise Pro plans with unlimited calls.

Understanding the Polygon Scan API rate limits is essential for building stable, production-ready applications. All plans enforce per-second rate limits and, on the free tier, daily call quotas. Exceeding these limits results in HTTP 429 responses that must be handled gracefully in your application code.

Free Plan Rate Limits

The free plan is designed for development and light production workloads:

  • Rate limit: 5 API calls per second
  • Daily quota: 100,000 API calls per day
  • API keys: up to 3 keys per account
  • Support: community forums
Paid Plan Options

Paid plans remove the daily call quota and increase the per-second rate limit. Plans typically range from $199/month for the Standard tier to higher tiers for enterprise workloads:

  • Standard: 10 calls/sec, unlimited daily calls, PRO endpoints, email support
  • Advanced: 20 calls/sec, all PRO endpoints, priority support, extended history
  • Enterprise: Custom limits, dedicated infrastructure, SLA guarantees
Handling HTTP 429 – Rate Limit Exceeded

When your application exceeds the rate limit, the API returns HTTP 429. Implement the following strategies to handle this gracefully:

  • Exponential back-off: wait 1s, retry; if still 429 wait 2s, 4s, 8s
  • Request queuing: use a token bucket algorithm to pace your API calls
  • Retry-After header: read the Retry-After response header if present
  • Circuit breaker: pause all requests for 60 seconds after 3 consecutive 429 errors
Best Practices for API Call Efficiency

Minimize your API call count with these techniques:

  • Use balancemulti instead of calling balance 20 times for 20 addresses
  • Cache responses client-side for data that changes infrequently (token metadata, contract ABIs)
  • Use block range filtering to fetch only the data you need, not full history
  • Batch paginated requests in parallel where possible, respecting the rate limit
Monitoring Your API Usage

Log in to your polygonscanapi.com dashboard to view real-time API call counts per key, per day, and per endpoint. Set up usage alerts to be notified before you approach your daily quota.

PolygonScanAPI