Limits
Deze handleiding is in het Engels geschreven.
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.