Limits
هذا الدليل مكتوب باللغة الإنجليزية.
We start with low limits on purpose, so nobody can drain or scrape the shop, and raise them for partners who need more: write to us. Every answer carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
| Limit | New key (first 7 days) | After that |
|---|---|---|
| Read requests per key and minute | 120 | 600 |
| Write requests per key and minute | 30 | 120 |
| Read requests per key and day | 10,000 | 50,000 |
| Write requests per key and day | 1,000 | 5,000 |
| Read requests per IP address and minute (all keys) | 1,200 | 1,200 |
| Write requests per IP address and minute (all keys) | 240 | 240 |
| Full catalogue pages per key and hour (no updatedSince) | 60 | 60 |
| Key reveals per key and minute | 30 | 30 |
| Key reveals per key and day | 500 | 500 |
| Daily order limit (default) | €250.00 | €250.00 |
| Daily order limit (highest you can set) | €250.00 | €5,000.00 |
Seller keys read as fast as their seller level allows (new 60, verified 300, trusted 1200 a minute). MCP calls count as reads; orders through MCP still meet the daily order limit.
Over a limit
The answer is 429 rate_limited with Retry-After in seconds. Wait that long. Back off with jitter; do not retry in a loop.
Daily order limit
The all-in totals of the orders a key made today (UTC), plus the new order, must stay at or under its limit. Over it: 409 spend_cap_reached. Set it under "Settings" on the key page. A new key cannot go above the default.
Automatic freeze
These patterns freeze the key at once. A frozen key answers 403 api_key_frozen to every call, the shop owner is told and reviews it. Your other keys keep working, but no new key can be made until the review.
| Pattern | Threshold |
|---|---|
| Many unknown ids (404) on id routes | 60 in 10 minutes |
| Failed checks with a real key (IP list, permission, signature) | 20 in 10 minutes |
| Key reveals | 120 in one hour |
| Calls that go on after 429 | 100 answers 429 in 10 minutes |
Unknown keys: an address that sends 300 unknown keys in 10 minutes gets 429 too_many_failed_auth.