Extracting and using proxies

This chapter covers generating and using Rotating Proxies and Static Proxies: parameters, connection rules, and advanced tips.

Rotating Proxies

I bought rotating traffic. How do I generate an endpoint and use it?

Three steps:

Create credentials: sign in, open the network console (for example Residential), go to Users & Whitelist, and create Username/Password (for example prefix user1 plus a password).
Generate endpoints: open Endpoint generator (or Endpoint generator):
- On Web generator, pick the order, protocol (HTTP or SOCKS5), country/city, and session mode (rotate every request or sticky);
- Click Generate now and copy from the result list.
Put it in the client:
- Host: always gate.joyproxy.com
- Port: always 9001
- Username: the full generated string (do not edit or shorten it)
- Password: the proxy password you set in step 1

Why do all Rotating connections use gate.joyproxy.com:9001?

That is the shared rotating gateway. gate.joyproxy.com:9001 is the global entry.

When the client connects with a specific username, the gateway parses country, city, and session ID from that username and picks a matching broadband node. You get throughput and failover without maintaining a huge host list.

Why is the generated username so long? Can I shorten it?

Do not edit it. A Rotating username is a routing string, not a simple login. Typical shape:

user1-zone-resi-region-us-city-los_angeles-session-ab12cd-sessTime-30

Each segment is a rule:

user1: your proxy user
region-us / city-...: exit geo
session-...: sticky session id
sessTime-30: sticky lifetime in minutes

If you truncate or change it, the gateway cannot route you. You get 407 or a random country.

Rotate every request vs sticky session?

Rotate every request: a new exit IP on each HTTP/HTTPS request. Best for large crawls so no single IP takes all the load.
Sticky session (hold IP stable):
- Console slider duration: supports 1–1440 minutes (up to 24 hours / 1 full day). While the window is open, every request using that generated long username keeps the same exit IP.
- Custom sticky duration (no upper limit): for longer sessions (e.g., 3 days, 7 days), you are not restricted by the UI slider. Directly modify the sesstime-<minutes> segment in the generated proxy username (e.g., sesstime-10080 for 7 days). There is no hardcoded ceiling.
- Best for high-purity requirements: for social account management, e-commerce checkouts, and AI platforms where residential purity is strictly required, combining Rotating/Mobile Proxies with long sticky sessions delivers the highest trust score.

What happens if the exit IP fails during the sticky window?

Rotating Residential and Mobile Proxies are routed from real residential home broadband and mobile cellular networks worldwide. During the sticky window, remote physical devices may occasionally go offline due to power-off, system sleep, local network reconnection, or base station handovers.

Instant automated failover: the JoyProxy gateway performs millisecond health probing. If the current exit IP drops or becomes unresponsive, the system instantly and smoothly reallocates a healthy exit IP in the same region to continue serving requests without dropping your connection.
Strict geo & ASN inheritance: the reallocated exit IP strictly preserves the original country, state/city, and carrier ASN, preventing cross-region jumps.
Zero client interruption: your connection remains alive with the exact same hostname, port, username, and password. This behavior mirrors legitimate residential broadband reconnects and will not trigger target site anti-fraud mechanisms.

Does the connection drop when sticky time ends?

No, the TCP session is not torn down.

When the configured sesstime expires (e.g. 1440 minutes elapsed), the underlying connection is never severed and the generated connection credentials remain valid.
On your next HTTP/HTTPS request, the gateway automatically rotates to a fresh exit IP that inherits the exact same country, region, and ASN attributes.
Your crawlers, anti-detect browsers, and scripts continue operating seamlessly without any reconfiguration or re-extraction.

What if my software only accepts numeric IP addresses and rejects domain names like isp.joyproxy.com?

Some legacy automation tools or anti-detect browsers only accept IPv4 addresses in IP:Port:User:Pass format and reject hostnames. Solution:

Open terminal on your machine (CMD, PowerShell, or Terminal);
Run ping command:
bash
```
ping isp.joyproxy.com
```
(For Datacenter Proxies, run ping dc.joyproxy.com)
Copy the resolved numeric IPv4 address from the ping output;
Paste this numeric IP into your client host field, keeping port and credentials unchanged.

How long does IP whitelist take to take effect? Why do I still get 407 after adding?

Sync latency: edge gateway nodes synchronize newly added whitelisted IPs globally within 5 to 10 seconds. Wait 10 seconds before initiating connections.
Dynamic local IP: ensure your local machine has a static public IP. If your ISP reconnects and changes your local IP, you must update the whitelist in the console.
Note: Rotating Proxies require username/password authentication; IP whitelist applies to Static Dedicated Proxies.

If I am unsatisfied with the initial exit IP assigned to my Static Proxy, how can I change it?

You can click Change IP (or New IP) on the line in My Proxies at any time. The system will reassign a brand-new dedicated exit IP in the same country/region immediately.
Your connection Entry Point (host and port) and credentials remain unchanged, eliminating the need to update your client configurations.

Static Proxies

Entry Point vs Dedicated Exit IP?

Easy to mix up:

Entry Point: looks like isp.joyproxy.com:port or dc.joyproxy.com:port (legacy *.std.joyproxy.com / *.pro.joyproxy.com remain supported). This is the only host:port you put in a client, crawler, or Browser Extension.
Dedicated Exit IP: looks like 198.51.100.24. That is the public IP the target sees. Use it to check geo. Never use Dedicated Exit IP as the proxy host — the connection will be refused.

Console: on My Proxies, use Hide Exit IP / Show Exit IP so you do not copy the wrong field.

Can Static Proxies change IP or region?

Change exit IP: yes. On My Proxies, open the line and click Change IP (or New IP). You get a new dedicated exit in the same region. Hostname and port stay the same.
Change region: no. Country and city are locked at purchase. For another geo, buy a Static line in that region, or use Rotating Proxies and set the country when you generate endpoints.

My Static Proxies exit IP changed. Did you swap it without asking?

We do not change a dedicated exit without cause. Rare cases:

Health failover: 24/7 monitoring. If the broadband node is down (power, ISP cutover, hardware) long enough, the system moves you to a healthy IP in the same region so traffic keeps flowing;
You clicked Change IP: someone on the team used Change IP in the console.

The new exit is still dedicated to you.

Can I check the IP range or ASN before purchasing Static Proxies?

Yes. If you have specific requirements for a country, carrier, or ASN, open a ticket via Tickets in the left sidebar of the console. Provide your target location and carrier details, and our team will check and advise on availability.

What if I am unsatisfied with the quality of an assigned ISP or Datacenter proxy, or need lower latency and higher bandwidth?

You can first try Change IP in the console under My Proxies to obtain a fresh exit IP. If you require ultra-low latency or dedicated large bandwidth, please submit a ticket to apply for Private Proxies, and our team will evaluate and customize dedicated direct-connect resources for you.

Are there traffic, speed, or device limits on Static Proxies?

None. There are no limits on traffic, bandwidth, concurrency, or the number of connected devices. Static Proxies are billed by IP count × subscription period. You can transfer unlimited data and connect your devices throughout the active plan.

What happens when Static Proxies expire?

Without renewal, forwarding stops at expiry. After a short hold, the port and underlying exit are released and cannot be recovered. To keep a line, turn on Auto-renew.

Generators and tools

How can I generate endpoints in the console?

Endpoint generator has three tabs:

Web generator: pick country, city, protocol, and session type; copy links or export CSV/JSON/TXT;
API generator: for scripts; CRLF or JSON;
AI generator: natural language in Cursor, VS Code, Claude Desktop, or OpenClaw.

How many endpoints per API call? Rate limits?

count is 1 to 200 (200 max per call).

Rotating host and credentials stay valid as long as you have traffic, so you do not need a tight poll loop. Too many calls return 429 Too Many Requests — back off. Full parameters: OpenAPI Center or programmatic extraction.

Can I Change IP via API?

Not yet. Static Change IP is a console action on My Proxies. The extract API only reads the current Entry Point; it does not trigger a new exit.

AdsPower, Hubstudio, Octobrowser, and similar?

Static Proxies example:

Open the antidetect browser and create or edit a profile;
Proxy type HTTP or SOCKS5;
Split the Entry Point from My Proxies: hostname in host, digits after the colon in port;
Username/Password from Users & Whitelist (Static Proxies can leave them blank if this public IP is on IP Whitelist; Rotating always needs credentials);
Click Check proxy / Test connection. When the exit IP looks right, save and start.

Clash, v2rayN, or Shadowrocket?

Yes. JoyProxy is standard HTTP, HTTPS, and SOCKS5. Any client that supports those protocols (Username/Password or IP Whitelist) can use the generated host:port as a normal node.

Extracting and using proxies ​

Rotating Proxies ​

Static Proxies ​

Generators and tools ​

Extracting and using proxies

Rotating Proxies

Static Proxies

Generators and tools