Skip to main content

How quotas work

Every API key has a daily quota that resets at midnight UTC. Every request to /api/v1/* counts as one.

Rate limit headers

Every response includes three headers:
The rate_limit field in the response body contains the same information:

Handling 429 responses

When you exceed your quota:

Planning your quota

The underlying GEX data updates every 15 minutes (Lambda capture). Polling more often than that doesn’t yield new data. A typical trading bot pattern:
  • term-oi for BTC + ETH every 15 min = 2 × 4 = 8 req/hour
  • by-strike-enhanced for 2-3 expirations every 15 min = ~10 req/hour
  • Discovery endpoints (rare, cached locally) = 1-2 req/day
Total: ~430 req/day for a busy bot — comfortably within the 500/day Pro quota.

Running out of quota?

  • Cache responses locally. The data only changes every 15 min.
  • Use the virtual all exchange instead of calling each exchange separately.
  • Reduce polling frequency to once every 30 min if you don’t need sub-15-min latency.
  • Contact us at admin@gammaflip.io if you need a higher custom limit.