On this page
Connection guide
Rotating residential proxies
Connect over HTTP or SOCKS5 with one credential, and change the IP behind it whenever you need.
How it works
A key is a fixed token and secret pair, used as the proxy username and password. The gateway address never changes; what changes is the Vietnamese IP your traffic leaves from.
There is no need to re-read an endpoint after every rotation, and no window where your software points at an address that has already moved on.
Connect
curl -x http://TOKEN:SECRET@gw.serpupdate.com:8080 https://api.ipify.orgcurl --socks5-hostname TOKEN:SECRET@gw.serpupdate.com:1080 https://api.ipify.orgHTTP proxying works with HTTPS sites as well. In software with a settings form, enter the host (gw.serpupdate.com) and the port (8080 for HTTP, 1080 for SOCKS5) separately, with the token as the username and the secret as the password.
Both are shown on each key in My proxies, along with ready-to-paste snippets. To confirm the proxy works, paste it into the proxy checker.
Rotate the IP
Press Rotate IP on the key in My proxies. The key moves to a new IP and the page shows it. Rotations must be at least 60 seconds apart; until then the button shows the seconds left.
If you do not rotate, the key moves to a new IP after at most 30 minutes. The host, port, token and secret stay the same either way, so nothing needs reconfiguring.
To check which IP you are on right now, ask an IP echo service through the proxy:
curl -x http://TOKEN:SECRET@gw.serpupdate.com:8080 https://api.ipify.orgKey lifecycle
- Keys are sold by the day: choose any term from 1 to 365 days, up to 50 keys per order. A key stops working at its expiry.
- Renew in place from the key card, even after expiry, for up to 7 days. The token and secret do not change, so nothing needs re-pasting into your software.
- Past that window, renewal is refused and you buy a new key.
Software that cannot log in to a proxy
Some emulators and tools only accept ip:port with no username or password. The free Proxy Tool for Windows turns your key into a local 127.0.0.1:PORT with no password, rotates the IP in one click, and gives each emulator window its own port.
Error codes
| Field | Value | Description |
|---|---|---|
| 407 | Proxy Auth Required | Unknown key, wrong secret, expired or revoked. Check the credentials and the expiry in My proxies. |
| 429 | Too Many Requests | Too many requests. Wait a moment and try again. |
| 502 | Bad Gateway | The current IP could not be reached. Rotate the IP to move to another one. |
| 503 | Service Unavailable | The key is valid but has no IP assigned yet, or it has reached 200 concurrent connections. |
Limits
| Field | Value | Description |
|---|---|---|
| Term | 1–365 days | Choose any number of days when you buy or renew. |
| Keys per order | 50 | Place another order for more. |
| Concurrent connections | 200 | Per key. Further connections are refused with 503 until one closes. |
| Bandwidth | Unlimited | Traffic is measured and shown in My proxies, but not billed or capped. |
| Minimum between rotations | 60 s | Per key. |
| Automatic rotation | 30 min | If you do not rotate, the key moves to a new IP after at most 30 minutes. |
Acceptable use and logging
We do not record the content, URLs or history of the websites you visit through the proxy. The system keeps only technical connection records (time, key, source IP, exit IP, destination domain and port, data volume) for the period the law requires, and provides them only to competent state authorities on lawful request.
