Vietnam Dedicated Proxy: Forcing a New Exit IP
The Vietnam Dedicated proxy rotates its exit IP roughly every three minutes on its own. When you need a new one sooner, one authenticated request forces it. Your host, port, username and password never change.
Avery BennettThis page covers the product listed on the shelf as Vietnam Dedicated Rotating Residential Proxy, sold in one, seven and thirty day terms. It is the same product some listings and older guides call VN Exclusive. If you are looking for that name in the catalogue you will not find it, so search for Vietnam Dedicated instead.
It does not cover the Vietnam Rotating Residential Sharing proxy, which is a different product. The endpoint below will refuse a Sharing account, because that account has no key of its own to rotate.
It already changes IP without you
Worth knowing before you write any code against this, because it changes whether you need to. The Dedicated proxy rotates its exit IP roughly every three minutes on its own. That is the product, and it is stated on the listing.
What the request below does is force that rotation early, for the times when waiting out the cycle is not acceptable. It is not the only way to get a new IP; it is the way to get one now.
Two things stay put throughout. Your host and port do not change, and neither do your username and password. You keep using the same host:port:username:password exactly as before, and only the address your traffic exits from is different.
What you need
- The proxy username and password from your order, the same pair in
host:port:username:password. - The API base URL,
https://proxy-api.lunaproxy.online.
The request
- Method:
POST - Path:
/api/v1/proxy/change-ip - Authentication: HTTP Basic, using your proxy username and password. There is no API key and no token to fetch first.
- Response: JSON, shaped
{"success": true|false, "message"?: string, "error"?: string}
As a single command, with your own credentials in place of the placeholders:
curl -X POST "https://proxy-api.lunaproxy.online/api/v1/proxy/change-ip" \
-u "YOUR_PROXY_USERNAME:YOUR_PROXY_PASSWORD"Note that the credentials go in the Basic auth header, which is what -u builds, and not in the body. There is no request body at all.
What the responses mean
| Result | HTTP | What to do |
|---|---|---|
| Accepted | 200 | {"success":true,"message":"Change-IP request sent"}. Requests you send through the proxy after this use the new exit IP. |
| Not authenticated | 401 | The Basic auth header is missing or the credentials are not accepted. Sending no header at all returns Basic auth required (proxy username:password). Check you are using the proxy credentials rather than your site login. |
| Not eligible | 400 | The account is not a Vietnam Dedicated proxy, or it has no key assigned. A Sharing proxy lands here. If you believe you bought the Dedicated product, raise it with support. |
| Order not found | 404 | The order was deleted or never existed. Contact support. |
| Too soon | 429 | You are inside the cooldown. Read the Retry-After response header, which gives the wait in seconds, and use that rather than a fixed guess. See below for why the wait exists. |
| Upstream busy | 502 | No new IP is available at that moment. Wait and retry. |
| Service error | 503 | An upstream or internal fault. Read the error field in the body. |
| Server error | 500 | Unexpected. Read the error field, retry once, and contact support if it persists. |
Why there is a cooldown
Because the rotation cycle underneath is about three minutes long, and forcing a change does not shorten that cycle, it only pulls your position within it forward. Ask again immediately and there is nothing new to give you yet, which is what the 429 is saying.
So build the wait in rather than retrying in a loop. The Retry-After header on the 429 tells you how long, and it is the only figure worth trusting; the exact number moves. A loop that ignores it produces a run of 429s and no faster result.
If it does not work
- 401 on every call. Confirm you are sending the proxy username and password, not your account login here. They are different credentials and the proxy pair is the one printed on your order.
- 400 on every call. Check which Vietnam product you bought. Only the Dedicated one has a key to rotate; the Sharing one does not.
- 200, but the IP looks unchanged. Check it through the proxy rather than in a browser that may be holding a connection open. An established connection is not rebuilt by a rotation.
- Nothing works at all from the first hour. Raise it the same day. The warranty on these listings is twelve hours from delivery, which is shorter than most people expect, and it runs whether or not you have got round to testing.
