Everything is one connection string.
No SDK, no client library, no API key ceremony. The product and TLS profile live in the username, the routing options in the password — point any HTTP or HTTPS client at your product's port and you are live. Every option is all encoded in the proxy password — point any HTTP or SOCKS5 client at the gateway and you are live.
Gateway endpoints
One hostname, one port per protocol. The gateway resolves to the nearest edge automatically — there is nothing region-specific to configure.
gw.ludaxproxy.com:7777
HTTP and HTTPS, CONNECT tunnelling
gw.ludaxproxy.com:9999
HTTP and HTTPS, TLS profile set in the username
gw.ludaxproxy.com:8080
HTTP and HTTPS · SOCKS5 on gw.ludaxproxy.com:1080
gw.ludaxproxy.com:8081
HTTP and HTTPS, TLS profile set in the username
Credential syntax
The username carries the product prefix and, on TLS products, the ALPN flag and TLS profile. Routing options are appended to the password as -key-value pairs, in the order below: session block first, then country (with optional state and city on Residential), then ASN on Premium.
resi-user_a1f9c2-AE-chrome145:yourpass-session-7f3ac1-time-10-country-de
username prefix
resi- · premi-
Every username starts with the product prefix: resi- for Residential and Residential TLS, premi- for Residential Premium and Premium TLS.
-<AE|NAE>-<profile>
AE-chrome145 · NAE-firefox151
TLS products only, appended to the username. AE sends Ludax header emulation with the handshake, NAE passes your own headers through. Use auto to let the gateway pick a profile.
-session-
any 3–24 chars
Holds the same IP for the session. Reuse the token to keep the IP, change it to rotate. Omit for per-request rotation.
-time-
1 … 1000
Session lifetime in minutes, following -session-. Up to 1000 on every product.
-sameip
flag
Optional, inside the session block on TLS products: holds the upstream exit IP as well as the handshake profile.
-country-
us · de · jp · br · …
Two-letter ISO code for the exit country. Residential covers 137 countries, Residential Premium 177; the union of both lists is 181 countries and territories.
-state- / -city-
bavaria · berlin
Residential and Residential TLS only, and only after -country-. Availability follows the published locations dataset; there is no ZIP-level selector.
-asn-
2516 · 3320
Residential Premium and Premium TLS only. Routes the exit inside one autonomous system.
Quickstart
Copy one of these, swap in the credentials from your dashboard, and you have a working request.
TLS profiles
On Residential TLS plans the gateway rewrites your handshake — cipher order, extensions, ALPN, GREASE, HTTP/2 settings frame — to match a real browser build. Omit -profile and we auto-select a plausible profile for the exit country and rotate it with the IP.
chrome145
chrome142
edge148
firefox151
firefox145
safari_18_4
safari_ios_26
opera_118
okhttp_5
+118 more
Pin a profile that matches the User-Agent header you send. A Chrome 145 handshake paired with a Firefox user agent is a stronger bot signal than sending no proxy at all.
Gateway status codes
200
OK
Request routed and returned. Bandwidth is metered on both directions of the transfer.
407
Proxy auth required
Username or password is wrong, or your client stripped the credentials. Check the password suffix has no spaces and no stray quotes.
402
Balance exhausted
Your prepaid balance is used up. Top up in the dashboard; access resumes on confirmation.
502
Exit unreachable
The selected exit dropped mid-request. Retry — without a session token you get a fresh IP automatically.
503
No capacity for selector
The country, city, ASN or profile combination has no free exits right now. Widen the selector or drop -city- / -asn-.
Stuck on something specific?
Send us the request you are trying to make and the response you get. We debug real traffic with customers on Telegram every day.