Documentation

Proxy usage guide

All geo-targeting and rotation settings are encoded directly in the username by appending suffixes. The password and host/port never change — only the username changes.

Connection

Hostv1.soxway.io

HTTP / HTTPS port5000HTTP proxy, tunnels HTTPS via CONNECT

SOCKS5 port1080

Usernameyour_username(+ optional suffixes — see Geo targeting)

Passwordyour_password(unchanged, always)

HTTPS needs no separate port — point your client at the HTTP proxy on 5000 and TLS is negotiated end-to-end over the CONNECT tunnel. The proxy never sees your plaintext.

Connection formats

# HTTP / HTTPS (TLS negotiated after CONNECT)
http://your_username:[email protected]:5000

# SOCKS5
socks5://your_username:[email protected]:1080

Code examples

curl

# HTTP
curl -x http://your_username:[email protected]:5000 https://ipinfo.io

# SOCKS5
curl --socks5 v1.soxway.io:1080 -U your_username:your_password https://ipinfo.io

Python (requests)

import requests

proxies = {
    "http":  "http://your_username:[email protected]:5000",
    "https": "http://your_username:[email protected]:5000",
}

r = requests.get("https://ipinfo.io/json", proxies=proxies)
print(r.json())

Node.js (axios)

import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';

const agent = new HttpsProxyAgent(
    'http://your_username:[email protected]:5000'
);

const res = await axios.get('https://ipinfo.io/json', { httpsAgent: agent });
console.log(res.data);

Geo targeting

Append suffixes to the username to target a location. Combine them in any order; the recommended order is geo → session → ttl. Use a dash (-) in place of spaces, e.g. _city-new-york.

Suffix	Description	Example
`_country-XX`	Country, ISO 3166-1 alpha-2	`_country-US`
`_region-Name`	Region / state	`_region-bavaria`
`_city-Name`	City	`_city-london`
`_isp-Name`	ISP / carrier	`_isp-vodafone`

# US only — rotation
socks5://your_username_country-US:[email protected]:1080

# Germany + Bavaria region
http://your_username_country-DE_region-bavaria:[email protected]:5000

# UK + London city
http://your_username_country-GB_city-london:[email protected]:5000

Rotation modes

Rotation (default)

A new IP on every request. Maximum anonymity, best for scraping. No suffix needed.

Stable — _s-SessionID

One IP is held as long as the upstream allows. The same Session ID always maps to the same IP.

socks5://your_username_country-GB_s-mySessionId:[email protected]:1080

Sticky — _s-SessionID + _ttl-Nm

The IP is held for N minutes/hours, then rotated. Different Session IDs give different IPs. _ttl- works without _s- too (a session is auto-generated).

# same IP for 30 min, then rotate
socks5://your_username_country-GB_s-ee2323b3_ttl-30m:[email protected]:1080

# all parameters together
socks5://your_username_country-GB_region-england_city-london_s-abc123_ttl-60m:[email protected]:1080

Suffix reference

{token}[_country-XX][_region-Name][_city-Name][_isp-Name][_s-SessionID][_ttl-Nm]

Suffix	Values	Notes
`_country-XX`	ISO 3166-1 alpha-2 (US, DE, GB…)	case-insensitive
`_region-Name`	Region / state name	spaces as -
`_city-Name`	City name	spaces as -
`_isp-Name`	ISP / carrier name	spaces as -
`_s-SessionID`	Any alphanumeric string	same ID → same IP
`_ttl-Nm / _ttl-Nh`	_ttl-30m, _ttl-2h	hold IP for N min/hours

Geo support by proxy type

Suffixes are always accepted by the gateway, but what each pool honours varies. Unsupported suffixes are silently ignored.

Suffix / mode	Residential	Mobile	4G Mobile
`_country-`	✅	✅	🔒
`_region-`	✅	❌	🔒
`_city-`	✅	✅	🔒
`_isp-`	✅	❌	🔒
`_s- (stable)`	✅	✅	🔄
`_ttl- (sticky)`	✅ ≤120m	✅ 10m	🔄

✅ supported · ❌ ignored by this pool

🔒 — location is fixed at purchase time; geo suffixes do not change it

🔄 — rotation controlled via the API, not username suffixes

≤120m — sticky lifetime capped at 120 minutes

Proxy API

Integrate proxies in minutes

Full proxy REST API with code samples in 13+ languages. Add residential and mobile proxies to your app instantly.

Proxy API code

1#!/usr/bin/env bash
2
3API_TOKEN="<your_api_token>"
4
5curl -s "https://api.soxway.io/v1/account/balance" \
6  -H "Authorization: Bearer $API_TOKEN" \
7  -H "Accept: */*"

Response (JSON)200 OK

1{
2  "data": {
3    "balance":  25.5,
4    "currency": "USD"
5  }
6}

API Reference Get API Key

Documentation

Proxy usage guide

All geo-targeting and rotation settings are encoded directly in the username by appending suffixes. The password and host/port never change — only the username changes.

Connection

Hostv1.soxway.io

HTTP / HTTPS port5000HTTP proxy, tunnels HTTPS via CONNECT

SOCKS5 port1080

Usernameyour_username(+ optional suffixes — see Geo targeting)

Passwordyour_password(unchanged, always)

HTTPS needs no separate port — point your client at the HTTP proxy on 5000 and TLS is negotiated end-to-end over the CONNECT tunnel. The proxy never sees your plaintext.

Connection formats

# HTTP / HTTPS (TLS negotiated after CONNECT)
http://your_username:[email protected]:5000

# SOCKS5
socks5://your_username:[email protected]:1080

Code examples

curl

# HTTP
curl -x http://your_username:[email protected]:5000 https://ipinfo.io

# SOCKS5
curl --socks5 v1.soxway.io:1080 -U your_username:your_password https://ipinfo.io

Python (requests)

import requests

proxies = {
    "http":  "http://your_username:[email protected]:5000",
    "https": "http://your_username:[email protected]:5000",
}

r = requests.get("https://ipinfo.io/json", proxies=proxies)
print(r.json())

Node.js (axios)

import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';

const agent = new HttpsProxyAgent(
    'http://your_username:[email protected]:5000'
);

const res = await axios.get('https://ipinfo.io/json', { httpsAgent: agent });
console.log(res.data);

Geo targeting

Append suffixes to the username to target a location. Combine them in any order; the recommended order is geo → session → ttl. Use a dash (-) in place of spaces, e.g. _city-new-york.

Suffix	Description	Example
`_country-XX`	Country, ISO 3166-1 alpha-2	`_country-US`
`_region-Name`	Region / state	`_region-bavaria`
`_city-Name`	City	`_city-london`
`_isp-Name`	ISP / carrier	`_isp-vodafone`

# US only — rotation
socks5://your_username_country-US:[email protected]:1080

# Germany + Bavaria region
http://your_username_country-DE_region-bavaria:[email protected]:5000

# UK + London city
http://your_username_country-GB_city-london:[email protected]:5000

Rotation modes

Rotation (default)

A new IP on every request. Maximum anonymity, best for scraping. No suffix needed.

Stable — _s-SessionID

One IP is held as long as the upstream allows. The same Session ID always maps to the same IP.

socks5://your_username_country-GB_s-mySessionId:[email protected]:1080

Sticky — _s-SessionID + _ttl-Nm

The IP is held for N minutes/hours, then rotated. Different Session IDs give different IPs. _ttl- works without _s- too (a session is auto-generated).

# same IP for 30 min, then rotate
socks5://your_username_country-GB_s-ee2323b3_ttl-30m:[email protected]:1080

# all parameters together
socks5://your_username_country-GB_region-england_city-london_s-abc123_ttl-60m:[email protected]:1080

Suffix reference

{token}[_country-XX][_region-Name][_city-Name][_isp-Name][_s-SessionID][_ttl-Nm]

Suffix	Values	Notes
`_country-XX`	ISO 3166-1 alpha-2 (US, DE, GB…)	case-insensitive
`_region-Name`	Region / state name	spaces as -
`_city-Name`	City name	spaces as -
`_isp-Name`	ISP / carrier name	spaces as -
`_s-SessionID`	Any alphanumeric string	same ID → same IP
`_ttl-Nm / _ttl-Nh`	_ttl-30m, _ttl-2h	hold IP for N min/hours

Geo support by proxy type

Suffixes are always accepted by the gateway, but what each pool honours varies. Unsupported suffixes are silently ignored.

Suffix / mode	Residential	Mobile	4G Mobile
`_country-`	✅	✅	🔒
`_region-`	✅	❌	🔒
`_city-`	✅	✅	🔒
`_isp-`	✅	❌	🔒
`_s- (stable)`	✅	✅	🔄
`_ttl- (sticky)`	✅ ≤120m	✅ 10m	🔄

✅ supported · ❌ ignored by this pool

🔒 — location is fixed at purchase time; geo suffixes do not change it

🔄 — rotation controlled via the API, not username suffixes

≤120m — sticky lifetime capped at 120 minutes

Proxy API

Integrate proxies in minutes

Full proxy REST API with code samples in 13+ languages. Add residential and mobile proxies to your app instantly.

Proxy API code

1#!/usr/bin/env bash
2
3API_TOKEN="<your_api_token>"
4
5curl -s "https://api.soxway.io/v1/account/balance" \
6  -H "Authorization: Bearer $API_TOKEN" \
7  -H "Accept: */*"

Response (JSON)200 OK

1{
2  "data": {
3    "balance":  25.5,
4    "currency": "USD"
5  }
6}

API Reference Get API Key

Proxy usage guide

Connection

Connection formats

Code examples

Geo targeting

Rotation modes

Rotation (default)

Stable — _s-SessionID

Sticky — _s-SessionID + _ttl-Nm

Suffix reference

Geo support by proxy type

Integrate proxies in minutes

Ready to scale with
premium proxies?

Proxy usage guide

Connection

Connection formats

Code examples

Geo targeting

Rotation modes

Rotation (default)

Stable — _s-SessionID

Sticky — _s-SessionID + _ttl-Nm

Suffix reference

Geo support by proxy type

Integrate proxies in minutes

Ready to scale with
premium proxies?

Proxy usage guide

Connection

Connection formats

Code examples

Geo targeting

Rotation modes

Rotation (default)

Stable — _s-SessionID

Sticky — _s-SessionID + _ttl-Nm

Suffix reference

Geo support by proxy type

Integrate proxies in minutes

Ready to scale withpremium proxies?

Proxy usage guide

Connection

Connection formats

Code examples

Geo targeting

Rotation modes

Rotation (default)

Stable — _s-SessionID

Sticky — _s-SessionID + _ttl-Nm

Suffix reference

Geo support by proxy type

Integrate proxies in minutes

Ready to scale withpremium proxies?

Ready to scale with
premium proxies?

Ready to scale with
premium proxies?