Documentation — Easy Proxy

Quick Start

Easy Proxy uses ProxyRise infrastructure. All connections go through a single host on port 3389 — the protocol is auto-detected.

🤖 Get your credentials
Open @EasyProxyStore_bot on Telegram. Your API key (password) and proxy username format are managed entirely through the bot.

Host172.65.145.196

Port3389

Usernameres-us (see format below)

Passwordpgw-your-api-key

Authentication

Your API key (starts with pgw-) is always the password. The username controls routing.

HTTP / HTTPS

Proxy-Authorization: Basic base64(username:pgw-your-api-key)

SOCKS5

username = res-us
password = pgw-your-api-key

Username Format

Format	Example	Description
`{type}-{country}`	`res-us`	Basic rotating
`{type}-{country}-sid-{id}`	`res-us-sid-123456`	Sticky session
`{type}_sc-{country}_{state}`	`res_sc-us_florida`	State targeting
`{type}_sc-{country}_{state}_{city}`	`res_sc-us_california_losangeles`	City targeting
`resfix-{country}-nnid-{n}`	`resfix-us-nnid-0`	Long session

Use any as the country code to get a random location. Use uk or gb for United Kingdom (both work). ASN targeting is currently disabled.

Proxy Types

Code	Name	Best For
`res`	Residential Rotating	Scraping, general use
`res_sc`	Residential State/City	Geo-targeted data
`resfix`	Residential Long Session	Account management
`stc`	Static ISP	Social media, accounts
`stc_sc`	Static ISP State/City	Targeted static IPs
`mob`	Mobile (4G/5G)	Highest trust score
`dc`	Datacenter	Speed-critical tasks

Datacenter location note: dc is only available in 23 countries: AU, AT, BE, BR, CA, FR, DE, HK, IN, IT, JP, MX, NL, PL, RO, SG, KR, ES, SE, TR, AE, UK, and US.

Protocols

All protocols use the same host and port (3389). Protocol is auto-detected.

Protocol	URL Prefix	Notes
HTTP	`http://`	Standard, widely supported
HTTPS	`https://`	TLS to proxy. Use `--proxy-insecure`
SOCKS5	`socks5://`	Best compatibility
SOCKS4	`socks4://`	Auth via userid field
SOCKS4a	`socks4a://`	Remote DNS resolution

Code Examples

cURL

bash — HTTP

curl -x "http://res-us:pgw-YOUR_KEY@172.65.145.196:3389" \
  https://httpbin.org/ip

bash — SOCKS5

curl -x "socks5://res-us:pgw-YOUR_KEY@172.65.145.196:3389" \
  https://httpbin.org/ip

bash — Sticky Session

curl -x "http://res-us-sid-123456:pgw-YOUR_KEY@172.65.145.196:3389" \
  https://httpbin.org/ip

Python

python — requests

import requests

API_KEY = "pgw-your-api-key"
HOST    = "172.65.145.196"

proxies = {
    "http":  f"http://res-us:{API_KEY}@{HOST}:3389",
    "https": f"http://res-us:{API_KEY}@{HOST}:3389",
}

r = requests.get("https://httpbin.org/ip", proxies=proxies)
print(r.json())

Node.js

js — undici / fetch

import { ProxyAgent } from "undici";

const API_KEY = "pgw-your-api-key";
const agent   = new ProxyAgent(
  `http://res-us:${API_KEY}@172.65.145.196:3389`
);

const res = await fetch("https://httpbin.org/ip", {
  dispatcher: agent,
});
console.log(await res.json());

Environment Variables

bash

export HTTP_PROXY="http://res-us:pgw-YOUR_KEY@172.65.145.196:3389"
export HTTPS_PROXY="http://res-us:pgw-YOUR_KEY@172.65.145.196:3389"
export ALL_PROXY="socks5://res-us:pgw-YOUR_KEY@172.65.145.196:3389"

Sessions

Sessions maintain the same IP across multiple requests. Manage them via the bot's /sessions command.

Session Type	Format	Duration
Sticky (short)	`res-us-sid-123456`	While traffic flows
Long (NNID)	`resfix-us-nnid-0`	Minutes to hours

Use different NNID values (0, 1, 2…) to maintain multiple simultaneous long-lived IPs.

Country Codes

Use standard 2-letter country codes. The full supported list is below.

203 countries available for residential, mobile, and static ISP proxies. Datacenter proxies are limited to 23 countries: AU, AT, BE, BR, CA, FR, DE, HK, IN, IT, JP, MX, NL, PL, RO, SG, KR, ES, SE, TR, AE, UK, and US.

Easy Proxy Documentation