# Ludax proxies in AdsPower: guide for AI assistants

> Give this file to your AI assistant (ChatGPT, Claude, Cursor, Copilot) and it can set up AdsPower profiles with Ludax residential proxies. Human-readable version: https://ludaxproxy.com/docs/adspower

You are helping someone put Ludax residential proxies behind AdsPower profiles. The steps come from AdsPower's own documentation (November 2026; menus can move between versions); the values come from the Ludax gateways.

## Rules

- Host `gw.ludaxproxy.com`. HTTP: Residential `gw.ludaxproxy.com:7777`, Premium `gw.ludaxproxy.com:8080`. SOCKS5: Residential `gw.ludaxproxy.com:7575`, Premium `gw.ludaxproxy.com:1080`. Both log in from AdsPower.
- **One sticky IP per profile:** `-session-<TOKEN>-time-1000` in the password, a different TOKEN (3 to 24 letters or digits, for example the profile's name) for every profile. The same token keeps the same IP for up to 1000 minutes; a new token is a new IP. Never let two profiles share a token, and do not leave the session out for logged-in accounts (every new connection would get a new IP).
- When the 1000 minutes run out the profile gets a new IP: keep the same `-country-` (and `-city-`) so it stays local.
- Match the profile to the IP: time zone, language and geolocation from the IP; on Premium `-os-windows`, `-os-macos`, `-os-android` or `-os-ios` to match the profile's system, and `-asn-<number>` for an ISP.
- Do **not** use the TLS gateways: the antidetect browser has its own fingerprint, and they have no SOCKS5.
- A failed check is usually a 407 (wrong password, `resi-` on a Premium port or the reverse, plan used up). 30 failed logins in 5 minutes block the client IP for 10 minutes: test one profile before checking many.

## AdsPower

- Profile: **New Profile** (or edit) → **Proxy** section → **Custom** → proxy type **HTTP** or **Socks 5**.
- Paste `host:port:username:password` into **Host:Port**; AdsPower fills **Proxy username** and **Proxy Password**. Leave **Change IP URL** empty: with Ludax a new IP is a new session token.
- Do not pick the **HTTPS** type: the gateways are HTTP proxies that carry HTTPS sites.
- **Check Proxy** must say "Connection test passed". Bulk: **Proxies** → **Add Proxy**, one line per profile; pick it under **Saved Proxies**, not by random assignment.

## Credentials

- **Username:** the product prefix (`resi-` or `premi-`), then the developer's account name from the dashboard (Generate), for example `resi-lx_k3m9q2p7xa`. The account name is `lx_` and 10 characters, the same for every plan. Never invent one: ask the developer, or use a placeholder such as `YOUR_USERNAME`.
- **Password:** the plan's own password (16 hexadecimal characters, one per plan), then the options, in this order: `-session-<TOKEN>-time-<MINUTES>`, then `-country-<cc>`, `-state-<code>`, `-city-<name>` (and `-asn-<number>`, `-os-<device>` on Premium). Use a placeholder such as `YOUR_PASSWORD`, or read it from an environment variable. Never put options in the username.
- **Sessions:** without `-session-` every new connection leaves from a new IP. `-session-<TOKEN>-time-<MINUTES>` keeps one IP for every connection that sends the same token (TOKEN: 3 to 24 letters or digits; MINUTES: 1 to 1000; Premium holds a session at least 3 minutes). Always send `-time-`: without it a session lasts 1 minute. On the TLS gateways add `-sameip` after the time, or only the browser profile is held.
- **Location:** `-country-` takes a lower-case ISO code (`us`, `de`, `jp`); `-state-` and `-city-` follow it (`-country-de-state-by-city-munich`); on Premium the state is its name without spaces (`-country-us-state-illinois-city-chicago`), in any of 219 countries. `-os-` (Premium) takes `windows`, `android`, `ios` or `macos`. With no free exit in that city or region the request falls back to the country. Codes for every country: https://ludaxproxy.com/locations
- **The port picks the product:** a plan's password works only on its own product's gateway, and the prefix must match it.

## Products and gateways in force

| Product | Username prefix | HTTP and HTTPS | SOCKS5 | Browser TLS | Sticky session |
| --- | --- | --- | --- | --- | --- |
| Residential | `resi-` | `gw.ludaxproxy.com:7777` | `gw.ludaxproxy.com:7575` | No | up to 1000 min |
| Residential TLS | `resi-` | `gw.ludaxproxy.com:9999` | none | Yes | up to 1000 min |
| Residential Premium | `premi-` | `gw.ludaxproxy.com:8080` | `gw.ludaxproxy.com:1080` | No | up to 1000 min |
| Residential Premium TLS | `premi-` | `gw.ludaxproxy.com:8081` | none | Yes | up to 1000 min |

## Check the connection

Open `https://api.ludaxproxy.com/whoami` inside the profile. `GET https://api.ludaxproxy.com/whoami` through the proxy returns JSON: `ip`, `country` (full name), `type`, `tls_profile` (the browser the TLS handshake matches) and `latency_ms`. Add `?full=1` for a `debug` block with the JA4 fingerprint, the HTTP/2 fingerprint, the ASN and the User-Agent that arrived.

## Ready values

The same values as on https://ludaxproxy.com/docs/adspower, in the form AdsPower reads. Replace `lx_k3m9q2p7xa` and `YOUR_PASSWORD` with the user's credentials and `shop1` with the profile's name.

### One profile, Residential over HTTP

```
gw.ludaxproxy.com:7777:resi-lx_k3m9q2p7xa:YOUR_PASSWORD-session-shop1-time-1000-country-us
```

### Five profiles, five IPs (bulk import)

```
gw.ludaxproxy.com:7777:resi-lx_k3m9q2p7xa:YOUR_PASSWORD-session-shop1-time-1000-country-us
gw.ludaxproxy.com:7777:resi-lx_k3m9q2p7xa:YOUR_PASSWORD-session-shop2-time-1000-country-us
gw.ludaxproxy.com:7777:resi-lx_k3m9q2p7xa:YOUR_PASSWORD-session-shop3-time-1000-country-us
gw.ludaxproxy.com:7777:resi-lx_k3m9q2p7xa:YOUR_PASSWORD-session-shop4-time-1000-country-us
gw.ludaxproxy.com:7777:resi-lx_k3m9q2p7xa:YOUR_PASSWORD-session-shop5-time-1000-country-us
```

### A new IP for one profile (new token)

```
gw.ludaxproxy.com:7777:resi-lx_k3m9q2p7xa:YOUR_PASSWORD-session-shop1b-time-1000-country-us
```

### A city, for accounts tied to one place

```
gw.ludaxproxy.com:7777:resi-lx_k3m9q2p7xa:YOUR_PASSWORD-session-shop1-time-1000-country-de-state-by-city-munich
```

### Rotating, for scraping profiles only

```
gw.ludaxproxy.com:7777:resi-lx_k3m9q2p7xa:YOUR_PASSWORD-country-us
```

### Residential Premium with a Windows exit device

```
gw.ludaxproxy.com:8080:premi-lx_k3m9q2p7xa:YOUR_PASSWORD-session-shop1-time-1000-country-us-os-windows
```

### SOCKS5

```
gw.ludaxproxy.com:7575:resi-lx_k3m9q2p7xa:YOUR_PASSWORD-session-shop1-time-1000-country-us
```

### What the sites see

```
https://api.ludaxproxy.com/whoami
```

## Plans and help

- Prepaid, no subscription: 1 GB of Residential Proxies costs $0.99. The smallest plan is the test; there is no free trial. Every plan: https://ludaxproxy.com/pricing
- Credentials: dashboard, Generate (https://ludaxproxy.com/dashboard). A plan's password can be reset there.
- Full reference: https://ludaxproxy.com/docs. Whole site for AI: https://ludaxproxy.com/llms.txt
- Support: Telegram https://t.me/LudaxProxy, email support@ludaxproxy.com.