Limits & errors
Updated:
Limits
Limit | Value |
|---|---|
Account API calls | About 50 per minute per user, short bursts allowed. The Proxy-Seller API itself allows ~60/min per API key. |
Documentation tools | Not counted against the account limit — they have their own ceiling of about 300 per minute |
Access token lifetime | 15 minutes, refreshed automatically |
Proxy replacement | Once per day per proxy |
Residential list size | 1–1000 ports |
Errors
Errors come back to the assistant as a message it relays to you. Other tools in the same request keep working.
What you see in the chat | Meaning | What to do |
|---|---|---|
Your Proxy-Seller account does not have a Client API key yet… | The Client API key could not be issued for the account | Retry; if it persists, contact support |
The Proxy-Seller Client API is temporarily unavailable… | API disabled or under maintenance | Retry in a few minutes; docs tools still work |
Could not reach the Proxy-Seller authorization service… | Server-side problem | Retry shortly |
You are sending requests faster than this server allows… | MCP rate limit | Wait a few seconds |
Rate limit hit (~60 requests/min per API key)… | Proxy-Seller API rate limit | Wait a moment |
Proxy-Seller API error (code N): … | The API rejected the request (e.g. insufficient balance, invalid parameter) | Read the message; the assistant usually corrects the parameters |
Network error talking to Proxy-Seller… | Temporary connection problem | Retry |
The assistant says a tool is not available | Permission not granted | Reconnect and grant the needed permission — see Permissions |
| Session expired or revoked | Reconnect the server — see Quick start |
| The service could not verify your access | Retry in a minute; the account tools are unaffected |
The two ceilings are separate: running the documentation tools hard cannot exhaust the account limit, and vice versa.
Replacement and list-size limits belong to individual tools — see their entries for the exact rule.
Affected tools: replace_proxy, add_resident_list.