Rate limits
OpenStock Docs
Hourly per-key limits and the X-RateLimit headers.
Write endpoints are rate limited per API key in fixed one-hour windows.
| API | Limit |
|---|---|
| Create checkout session | 100 requests / hour |
| Create withdrawal | 50 requests / hour |
| Add or deduct customer balance | 100 requests / hour |
Headers#
Rate-limited responses include headers describing the current window:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 2026-03-04T19:00:00.000ZWhen the limit is reached the API answers 429 with a Retry-After header (seconds) and a matching retry_after field. Wait that long before retrying.